flare-chat-core 0.1.1 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flare-chat-core",
   "private": false,
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "main": "./src/index.js",
   "module": "./src/index.js",

package/scripts/check.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+PKG_DIR=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
+
+level="${1:-quick}"
+case "$level" in
+  quick|full) ;;
+  *) echo "Unsupported level: $level" >&2; exit 2 ;;
+esac
+
+find "$PKG_DIR/src" -type f -name '*.js' | while IFS= read -r file; do
+  node --check "$file"
+done

package/src/chat-core/input/useChatInput.js

@@ -1,5 +1,18 @@
 import { useState, useCallback } from 'react';
 
+function buildAttachmentFile(file, index = 0, status = 'ready') {
+  return {
+    uid: file?.uid || `${Date.now()}-${index}`,
+    name: file?.name || `附件-${index + 1}`,
+    size: Number.isFinite(file?.size) ? file.size : null,
+    type: file?.type || '',
+    originFileObj: file?.originFileObj || file || null,
+    status: file?.status || status,
+    error_message: file?.error_message || '',
+    created_at: file?.created_at || new Date().toISOString(),
+  };
+}
+
 export function useChatInput() {
   const [inputValue, setInputValue] = useState('');
   const [fileList, setFileList] = useState([]);
@@ -23,18 +36,37 @@ export function useChatInput() {
     setIsDragging(false);
 
     const files = Array.from(e.dataTransfer.files);
-    const newFiles = files.map((file, index) => ({
-      uid: `${Date.now()}-${index}`,
-      name: file.name,
-      size: file.size,
-      type: file.type,
-      originFileObj: file,
-    }));
+    const newFiles = files.map((file, index) => buildAttachmentFile(file, index));
 
     setFileList((prev) => [...prev, ...newFiles]);
     return files.length;
   }, []);
 
+  const appendFiles = useCallback((files = [], options = {}) => {
+    const normalized = Array.isArray(files)
+      ? files.map((file, index) => buildAttachmentFile(file, index, options.status || 'ready'))
+      : [];
+    if (normalized.length === 0) {
+      return;
+    }
+    setFileList((prev) => [...prev, ...normalized]);
+  }, []);
+
+  const updateFileStatus = useCallback((uid, status, errorMessage = '') => {
+    if (!uid) {
+      return;
+    }
+    setFileList((prev) => prev.map((file) => (
+      file.uid === uid
+        ? {
+            ...file,
+            status: status || file.status,
+            error_message: errorMessage || '',
+          }
+        : file
+    )));
+  }, []);
+
   const handleDragOver = useCallback((e) => {
     e.preventDefault();
     e.stopPropagation();
@@ -59,6 +91,8 @@ export function useChatInput() {
     handleInputChange,
     handleFileChange,
     handleRemoveFile,
+    appendFiles,
+    updateFileStatus,
     handleDrop,
     handleDragOver,
     handleDragLeave,
@@ -67,4 +101,3 @@ export function useChatInput() {
 }
 
 export default useChatInput;
-

package/src/chat-core/messages/buildTimelineItems.js

@@ -1,8 +1,8 @@
-export function buildTimelineItems(state = {}) {
+export function buildTimelineItems(state = {}, options = {}) {
   const messages = Array.isArray(state.messages) ? state.messages : [];
-  const executionCards = Array.isArray(state.executionCards) ? state.executionCards : [];
   const uiCards = Array.isArray(state.uiCards) ? state.uiCards : [];
   const streaming = state.streaming || {};
+  const loading = Boolean(options?.loading);
 
   const items = [];
 
@@ -23,21 +23,10 @@ export function buildTimelineItems(state = {}) {
       createdAt: msg.created_at,
       highlights: msg.highlights ?? [],
       sourceTypes: msg.sourceTypes ?? [],
+      attachments: Array.isArray(msg.attachments) ? msg.attachments : [],
     });
   });
 
-  executionCards
-    .filter(Boolean)
-    .filter((card) => card.step_id !== streaming.executionTrace?.step_id)
-    .forEach((card, index) => {
-      const executionId = card.step_id || `execution-fallback-${index}`;
-      items.push({
-        id: executionId,
-        type: 'execution',
-        executionTrace: card,
-      });
-    });
-
   if (uiCards.length > 0) {
     items.push({
       id: 'conversation-ui-cards',
@@ -54,7 +43,8 @@ export function buildTimelineItems(state = {}) {
     });
   }
 
-  if (streaming.agentStatus || streaming.thinkingTrace || streaming.executionTrace) {
+  const hasThinkingSignal = Boolean(streaming.agentStatus || streaming.thinkingTrace || streaming.executionTrace);
+  if (hasThinkingSignal) {
     items.push({
       id: 'thinking-bubble',
       type: 'thinking',
@@ -62,6 +52,15 @@ export function buildTimelineItems(state = {}) {
       thinkingTrace: streaming.thinkingTrace,
       executionTrace: streaming.executionTrace,
     });
+  } else if (loading && !streaming.content) {
+    items.push({
+      id: 'thinking-bubble-loading',
+      type: 'thinking',
+      agentStatus: {
+        status: 'running',
+        agent: '助手',
+      },
+    });
   }
 
   return {
@@ -71,4 +70,3 @@ export function buildTimelineItems(state = {}) {
 }
 
 export default buildTimelineItems;
-

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

@@ -321,7 +321,14 @@ export default function useChatSessionReducer(deps = {}) {
     dispatch({ type: MESSAGES_REFRESHED, payload: messagesWithIds });
   }, [messageAPI]);
 
-  const appendUserMessage = useCallback((content) => {
+  const appendUserMessage = useCallback((content, metadata = {}) => {
+    const payloadMeta = (
+      metadata
+      && typeof metadata === 'object'
+      && !Array.isArray(metadata)
+    )
+      ? metadata
+      : {};
     dispatch({
       type: MESSAGE_APPENDED,
       payload: {
@@ -329,6 +336,7 @@ export default function useChatSessionReducer(deps = {}) {
         role: 'user',
         content,
         created_at: new Date().toISOString(),
+        ...payloadMeta,
       },
     });
   }, []);

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

@@ -33,6 +33,16 @@ export class SSEClient {
     const sessionId = params.sessionId;
     const content = params.content;
     const enabledCapabilities = Array.isArray(params.enabledCapabilities) ? params.enabledCapabilities : [];
+    const modeKey = typeof params.modeKey === 'string' ? params.modeKey.trim() : '';
+    const manualModeKey = typeof params.manualModeKey === 'string' ? params.manualModeKey.trim() : '';
+    const currentModeKey = typeof params.currentModeKey === 'string' ? params.currentModeKey.trim() : '';
+    const payloadExtra = (
+      params.payloadExtra
+      && typeof params.payloadExtra === 'object'
+      && !Array.isArray(params.payloadExtra)
+    )
+      ? params.payloadExtra
+      : {};
     const onEvent = isObjectCall ? contentArg : onEventArg;
     const onComplete = isObjectCall ? onEventArg : onCompleteArg;
     const onError = isObjectCall ? onCompleteArg : onErrorArg;
@@ -50,6 +60,16 @@ export class SSEClient {
           message: content,
           session_id: sessionId,
           enabled_capabilities: enabledCapabilities,
+          ...(modeKey ? { mode: modeKey } : {}),
+          ...(manualModeKey ? { manual_mode: manualModeKey } : {}),
+          ...(currentModeKey ? { current_mode: currentModeKey } : {}),
+          payload: {
+            message: content,
+            ...(modeKey ? { mode: modeKey } : {}),
+            ...(manualModeKey ? { manual_mode: manualModeKey } : {}),
+            ...(currentModeKey ? { current_mode: currentModeKey } : {}),
+            ...payloadExtra,
+          },
         }),
         signal: this.abortController.signal,
       });
@@ -120,4 +140,3 @@ export class SSEClient {
     }
   }
 }
-

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

@@ -172,6 +172,7 @@ function pickFirstArray(payload, keys) {
 export const parseFieldProgress = (raw) => {
   const payload = resolveModeEventPayload(raw);
   return {
+    flow_state: payload?.flow_state ?? payload?.collection_phase ?? '',
     fields: payload?.fields ?? {},
     sources: payload?.sources ?? {},
     field_entries: Array.isArray(payload?.field_entries) ? payload.field_entries : [],
@@ -197,9 +198,20 @@ export const parseFieldProgress = (raw) => {
     required_fields: Array.isArray(payload?.required_fields) ? payload.required_fields : [],
     recommended_fields: Array.isArray(payload?.recommended_fields) ? payload.recommended_fields : [],
     optional_fields: Array.isArray(payload?.optional_fields) ? payload.optional_fields : [],
+    intake_core_fields: Array.isArray(payload?.intake_core_fields) ? payload.intake_core_fields : [],
+    intake_supplementary_fields: Array.isArray(payload?.intake_supplementary_fields) ? payload.intake_supplementary_fields : [],
+    analysis_enrichment_fields: Array.isArray(payload?.analysis_enrichment_fields) ? payload.analysis_enrichment_fields : [],
     field_priorities: payload?.field_priorities && typeof payload.field_priorities === 'object' && !Array.isArray(payload.field_priorities)
       ? payload.field_priorities
       : {},
+    current_question: payload?.current_question && typeof payload.current_question === 'object' && !Array.isArray(payload.current_question)
+      ? payload.current_question
+      : null,
+    question_progress: payload?.question_progress && typeof payload.question_progress === 'object' && !Array.isArray(payload.question_progress)
+      ? payload.question_progress
+      : { current: 0, total: 0 },
+    collection_phase: payload?.collection_phase ?? '',
+    required_missing_count: Number.isFinite(payload?.required_missing_count) ? payload.required_missing_count : null,
   };
 };
 
@@ -240,6 +252,7 @@ export const parseNextActions = (raw) => {
     : (Array.isArray(payload?.next_actions) ? payload.next_actions : []);
   return {
     mode_key: payload?.mode_key ?? '',
+    flow_state: payload?.flow_state ?? payload?.collection_phase ?? '',
     project_id: payload?.project_id ?? null,
     message_excerpt: payload?.message_excerpt ?? '',
     actions,
@@ -247,9 +260,27 @@ export const parseNextActions = (raw) => {
     required_missing: Array.isArray(payload?.required_missing) ? payload.required_missing : [],
     recommended_missing: Array.isArray(payload?.recommended_missing) ? payload.recommended_missing : [],
     optional_missing: Array.isArray(payload?.optional_missing) ? payload.optional_missing : [],
+    intake_core_fields: Array.isArray(payload?.intake_core_fields) ? payload.intake_core_fields : [],
+    intake_supplementary_fields: Array.isArray(payload?.intake_supplementary_fields) ? payload.intake_supplementary_fields : [],
+    analysis_enrichment_fields: Array.isArray(payload?.analysis_enrichment_fields) ? payload.analysis_enrichment_fields : [],
     ready_for_sourcing: payload?.ready_for_sourcing ?? null,
     status: payload?.status ?? '',
     reason: payload?.reason ?? '',
+    chooser_required: payload?.chooser_required === true,
+    blocking_reason: payload?.blocking_reason ?? '',
+    blocking: payload?.blocking && typeof payload.blocking === 'object' && !Array.isArray(payload.blocking)
+      ? payload.blocking
+      : null,
+    target_field: payload?.target_field ?? '',
+    degrade_reason: Array.isArray(payload?.degrade_reason) ? payload.degrade_reason : [],
+    current_question: payload?.current_question && typeof payload.current_question === 'object' && !Array.isArray(payload.current_question)
+      ? payload.current_question
+      : null,
+    question_progress: payload?.question_progress && typeof payload.question_progress === 'object' && !Array.isArray(payload.question_progress)
+      ? payload.question_progress
+      : { current: 0, total: 0 },
+    collection_phase: payload?.collection_phase ?? '',
+    required_missing_count: Number.isFinite(payload?.required_missing_count) ? payload.required_missing_count : null,
     render_hint: payload?.render_hint ?? 'next_actions',
   };
 };
@@ -378,6 +409,110 @@ export const parseEvaluationReportReady = (raw) => {
   };
 };
 
+export const parsePlanBlock = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  return {
+    ...payload,
+    constraints: Array.isArray(payload?.constraints) ? payload.constraints : [],
+    plan: Array.isArray(payload?.plan) ? payload.plan : [],
+    acceptance: Array.isArray(payload?.acceptance) ? payload.acceptance : [],
+    actions: Array.isArray(payload?.actions) ? payload.actions : [],
+  };
+};
+
+export const parseCanvasState = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  const canvasState = payload?.canvas_state && typeof payload.canvas_state === 'object' && !Array.isArray(payload.canvas_state)
+    ? payload.canvas_state
+    : {};
+  return {
+    ...payload,
+    canvas_state: {
+      ...canvasState,
+      versions: Array.isArray(canvasState.versions) ? canvasState.versions : [],
+    },
+  };
+};
+
+export const parseCanvasRevision = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  return {
+    ...payload,
+    actions: Array.isArray(payload?.actions) ? payload.actions : [],
+  };
+};
+
+export const parseKnowledgeSearch = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  const sourceBreakdown = payload?.source_breakdown && typeof payload.source_breakdown === 'object'
+    && !Array.isArray(payload.source_breakdown)
+    ? payload.source_breakdown
+    : {};
+  return {
+    ...payload,
+    run_id: payload?.run_id ?? '',
+    query: payload?.query ?? '',
+    result_count: Number.isFinite(payload?.result_count) ? payload.result_count : null,
+    source_breakdown: {
+      local: Number.isFinite(sourceBreakdown.local) ? sourceBreakdown.local : 0,
+      mcp: Number.isFinite(sourceBreakdown.mcp) ? sourceBreakdown.mcp : 0,
+      web: Number.isFinite(sourceBreakdown.web) ? sourceBreakdown.web : 0,
+    },
+    results: Array.isArray(payload?.results) ? payload.results : [],
+  };
+};
+
+export const parseKnowledgeCitation = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  return {
+    ...payload,
+    run_id: payload?.run_id ?? '',
+    citations: Array.isArray(payload?.citations) ? payload.citations : [],
+  };
+};
+
+export const parseOrchestrationStatus = (raw) => {
+  const payload = resolveModeEventPayload(raw);
+  return {
+    trace_id: payload?.trace_id ?? '',
+    current_stage: payload?.current_stage ?? '',
+    detected_intent: payload?.detected_intent && typeof payload.detected_intent === 'object' && !Array.isArray(payload.detected_intent)
+      ? payload.detected_intent
+      : {},
+    confirmed_updates: Array.isArray(payload?.confirmed_updates) ? payload.confirmed_updates : [],
+    open_fields: Array.isArray(payload?.open_fields) ? payload.open_fields : [],
+    search_actions: Array.isArray(payload?.search_actions) ? payload.search_actions : [],
+    workspace_updates: payload?.workspace_updates && typeof payload.workspace_updates === 'object' && !Array.isArray(payload.workspace_updates)
+      ? payload.workspace_updates
+      : {},
+    next_action: payload?.next_action && typeof payload.next_action === 'object' && !Array.isArray(payload.next_action)
+      ? payload.next_action
+      : {},
+    next_actions: Array.isArray(payload?.next_actions) ? payload.next_actions : [],
+    chooser: payload?.chooser && typeof payload.chooser === 'object' && !Array.isArray(payload.chooser)
+      ? payload.chooser
+      : null,
+    stage_transition: payload?.stage_transition && typeof payload.stage_transition === 'object' && !Array.isArray(payload.stage_transition)
+      ? payload.stage_transition
+      : {},
+    decision_basis: Array.isArray(payload?.decision_basis) ? payload.decision_basis : [],
+    blocking: payload?.blocking && typeof payload.blocking === 'object' && !Array.isArray(payload.blocking)
+      ? payload.blocking
+      : {},
+    node: payload?.node && typeof payload.node === 'object' && !Array.isArray(payload.node)
+      ? payload.node
+      : {},
+    node_id: payload?.node_id ?? '',
+    node_state: payload?.node_state ?? '',
+    node_reason: payload?.node_reason ?? '',
+    needs_user_choice: payload?.needs_user_choice === true,
+    degrade_reason: Array.isArray(payload?.degrade_reason) ? payload.degrade_reason : [],
+    content_policy: payload?.content_policy && typeof payload.content_policy === 'object' && !Array.isArray(payload.content_policy)
+      ? payload.content_policy
+      : {},
+  };
+};
+
 export const parseWorkspaceActivation = (raw) => ({
   function_type: raw?.function_type ?? '',
   mode: raw?.mode ?? '',
@@ -420,6 +555,44 @@ export const parseInstanceProfile = (raw) => ({
   ui_labels: raw?.instance_profile?.ui_labels ?? raw?.ui_labels ?? {},
 });
 
+export const parseModeRuntime = (raw) => ({
+  mode_key: raw?.mode_key ?? '',
+  mode_state: raw?.mode_state ?? '',
+});
+
+export const parseAgentRuntime = (raw) => ({
+  trace_id: raw?.trace_id ?? '',
+  session_id: raw?.session_id ?? '',
+  intent: raw?.intent ?? '',
+  function_type: raw?.function_type ?? '',
+  mode_key: raw?.mode_key ?? '',
+  mode_state: raw?.mode_state ?? '',
+  agent_step_count: Number.isFinite(raw?.agent_step_count) ? raw.agent_step_count : 0,
+  agent_step: Array.isArray(raw?.agent_step) ? raw.agent_step : [],
+});
+
+export const parseSkillRuntime = (raw) => ({
+  trace_id: raw?.trace_id ?? '',
+  session_id: raw?.session_id ?? '',
+  intent: raw?.intent ?? '',
+  function_type: raw?.function_type ?? '',
+  mode_key: raw?.mode_key ?? '',
+  mode_state: raw?.mode_state ?? '',
+  skill_call_count: Number.isFinite(raw?.skill_call_count) ? raw.skill_call_count : 0,
+  skill_call: Array.isArray(raw?.skill_call) ? raw.skill_call : [],
+});
+
+export const parseModeSwitchReason = (raw) => ({
+  mode_key: raw?.mode_key ?? '',
+  intent: raw?.intent ?? '',
+  source: raw?.source ?? '',
+  previous_mode: raw?.previous_mode ?? '',
+  manual_mode: raw?.manual_mode ?? '',
+  current_mode: raw?.current_mode ?? '',
+  intent_override: raw?.intent_override ?? '',
+  summary: raw?.summary ?? '',
+});
+
 export const parseSSEError = (raw) => ({
   message: raw?.message ?? '发生错误',
 });

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

@@ -21,6 +21,16 @@ import {
   parseCapabilitySuggestion,
   parseFieldsUpdated,
   parseInstanceProfile,
+  parseModeRuntime,
+  parseAgentRuntime,
+  parseSkillRuntime,
+  parseModeSwitchReason,
+  parseKnowledgeSearch,
+  parseKnowledgeCitation,
+  parseOrchestrationStatus,
+  parseCanvasState,
+  parseCanvasRevision,
+  parsePlanBlock,
   parseSSEError,
 } from './sse-events.js';
 
@@ -69,6 +79,16 @@ export function useSSEStream(sessionId) {
       onCategoryIdentified,
       onFieldsUpdated,
       onInstanceProfile,
+      onModeRuntime,
+      onAgentRuntime,
+      onSkillRuntime,
+      onModeSwitchReason,
+      onKnowledgeSearch,
+      onKnowledgeCitation,
+      onOrchestrationStatus,
+      onCanvasState,
+      onCanvasRevision,
+      onPlanBlock,
       onDoc,
       onCapabilitySuggestion,
       onError,
@@ -138,6 +158,36 @@ export function useSSEStream(sessionId) {
         case 'instance_profile':
           onInstanceProfile?.(parseInstanceProfile(event.data));
           break;
+        case 'mode_runtime':
+          onModeRuntime?.(parseModeRuntime(event.data));
+          break;
+        case 'agent_runtime':
+          onAgentRuntime?.(parseAgentRuntime(event.data));
+          break;
+        case 'skill_runtime':
+          onSkillRuntime?.(parseSkillRuntime(event.data));
+          break;
+        case 'mode_switch_reason':
+          onModeSwitchReason?.(parseModeSwitchReason(event.data));
+          break;
+        case 'knowledge_search':
+          onKnowledgeSearch?.(parseKnowledgeSearch(event.data));
+          break;
+        case 'knowledge_citation':
+          onKnowledgeCitation?.(parseKnowledgeCitation(event.data));
+          break;
+        case 'orchestration_status':
+          onOrchestrationStatus?.(parseOrchestrationStatus(event.data));
+          break;
+        case 'canvas_state':
+          onCanvasState?.(parseCanvasState(event.data));
+          break;
+        case 'canvas_revision':
+          onCanvasRevision?.(parseCanvasRevision(event.data));
+          break;
+        case 'plan_block':
+          onPlanBlock?.(parsePlanBlock(event.data));
+          break;
         case 'doc':
           onDoc?.(parseDoc(event.data));
           break;
@@ -170,6 +220,16 @@ export function useSSEStream(sessionId) {
       sessionId: resolvedSessionId,
       content,
       enabledCapabilities: Array.isArray(options.enabledCapabilities) ? options.enabledCapabilities : [],
+      modeKey: typeof options.modeKey === 'string' ? options.modeKey : '',
+      manualModeKey: typeof options.manualModeKey === 'string' ? options.manualModeKey : '',
+      currentModeKey: typeof options.currentModeKey === 'string' ? options.currentModeKey : '',
+      payloadExtra: (
+        options.payloadExtra
+        && typeof options.payloadExtra === 'object'
+        && !Array.isArray(options.payloadExtra)
+      )
+        ? options.payloadExtra
+        : {},
       endpoint: options.endpoint,
       baseUrl: options.baseUrl,
       url: options.url,
@@ -178,6 +238,10 @@ export function useSSEStream(sessionId) {
     if (!requestOptions.enabledCapabilities.length) {
       delete requestOptions.enabledCapabilities;
     }
+    if (!requestOptions.modeKey) delete requestOptions.modeKey;
+    if (!requestOptions.manualModeKey) delete requestOptions.manualModeKey;
+    if (!requestOptions.currentModeKey) delete requestOptions.currentModeKey;
+    if (!Object.keys(requestOptions.payloadExtra || {}).length) delete requestOptions.payloadExtra;
 
     if (!requestOptions.endpoint) delete requestOptions.endpoint;
     if (!requestOptions.baseUrl) delete requestOptions.baseUrl;