flare-chat-core 0.2.0 → 0.2.2

package/src/main.jsx

@@ -0,0 +1,28 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import 'antd/dist/reset.css';
+import ChatApp from './app/App.jsx';
+
+const FUNCTION_TYPE = import.meta.env.VITE_FLARE_CHAT_FUNCTION_TYPE || 'chat_component_debug';
+const DEFAULT_SESSION_TITLE = import.meta.env.VITE_FLARE_CHAT_DEFAULT_SESSION_TITLE || '调试会话';
+const PROJECT_ID = import.meta.env.VITE_FLARE_CHAT_PROJECT_ID || 'project_demo_001';
+const USER_ID = import.meta.env.VITE_FLARE_CHAT_USER_ID || 'user_demo_001';
+const DEV_DEFAULT_BACKEND = String(import.meta.env.VITE_FLARE_CHAT_DEV_DEFAULT_BACKEND || 'real').toLowerCase();
+const KERNEL_BASE_URL = import.meta.env.VITE_FLARE_CHAT_KERNEL_BASE_URL || 'http://127.0.0.1:18002';
+const API_BASE_URL = import.meta.env.VITE_FLARE_CHAT_API_BASE_URL || '';
+const API_TOKEN = import.meta.env.VITE_FLARE_CHAT_API_TOKEN || '';
+
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <ChatApp
+      functionType={FUNCTION_TYPE}
+      defaultSessionTitle={DEFAULT_SESSION_TITLE}
+      projectId={PROJECT_ID}
+      userId={USER_ID}
+      backendMode={DEV_DEFAULT_BACKEND}
+      kernelBaseUrl={KERNEL_BASE_URL}
+      apiBaseUrl={API_BASE_URL}
+      apiToken={API_TOKEN}
+    />
+  </React.StrictMode>
+);

package/src/orchestration/index.js

@@ -0,0 +1,6 @@
+export { useBasicSendHandler } from '../chat-core/orchestration/useBasicSendHandler.js';
+export { useStreamSendController } from '../chat-core/stream/useStreamSendController.js';
+export { useSessionListController } from '../chat-core/session/useSessionListController.js';
+export { useBasicConversationFacade } from '../chat-core/facade/useBasicConversationFacade.js';
+export { useCoreChatApp } from '../chat-core/app/useCoreChatApp.js';
+export { useSSEStream } from './useSSEStream.js';

package/src/orchestration/useSSEStream.js

@@ -0,0 +1,221 @@
+import { useRef, useState, useCallback, useEffect } from 'react';
+import { SSEClient } from '../adapters/sse-client.js';
+import { dispatchSSEEvent } from '../adapters/sse-event-dispatcher.js';
+
+function classifyError(errorMessage) {
+  if (!errorMessage) return 'unknown';
+
+  const lowerMsg = errorMessage.toLowerCase();
+  if (lowerMsg.includes('network') || lowerMsg.includes('fetch')) return 'network';
+  if (lowerMsg.includes('timeout') || lowerMsg.includes('timed out')) return 'timeout';
+  if (/\b(500|502|503|504)\b/.test(lowerMsg)) return 'api';
+  return 'unknown';
+}
+
+export function useSSEStream(sessionId) {
+  const clientRef = useRef(new SSEClient());
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const accumulatedRef = useRef('');
+  const lastMessageRef = useRef({ content: '', handlers: {} });
+
+  const send = useCallback(async (content, handlers = {}, options = {}) => {
+    const hasSessionOverride = Object.prototype.hasOwnProperty.call(options, 'sessionIdOverride');
+    const resolvedSessionId = hasSessionOverride ? options.sessionIdOverride : sessionId;
+    if (!content.trim()) return;
+
+    lastMessageRef.current = { content, handlers, options };
+    setError(null);
+    accumulatedRef.current = '';
+    setLoading(true);
+    let latestSessionId = String(resolvedSessionId || '').trim();
+
+    const {
+      onAck,
+      onAgentStatus,
+      onThinkingTrace,
+      onExecutionTrace,
+      onContent,
+      onTextReplace,
+      onPhaseStart,
+      onPhaseUpdate,
+      onPhaseEnd,
+      onPatch,
+      onDone,
+      onTrace,
+      onWorkspaceActivation,
+      onUICards,
+      onKnowledgeBaseState,
+      onFieldProgress,
+      onRequirementDraft,
+      onNextActions,
+      onSourcingCandidates,
+      onRiskSummary,
+      onShortlistUpdated,
+      onEvaluationReportReady,
+      onCategoryIdentified,
+      onFieldsUpdated,
+      onInstanceProfile,
+      onModeRuntime,
+      onAgentRuntime,
+      onSkillRuntime,
+      onModeSwitchReason,
+      onKnowledgeSearch,
+      onKnowledgeCitation,
+      onOrchestrationStatus,
+      onCanvasState,
+      onCanvasRevision,
+      onPlanBlock,
+      onDoc,
+      onCapabilitySuggestion,
+      onPatchEvent,
+      onError,
+      onComplete,
+    } = handlers;
+
+    const eventHandler = (event) => {
+      dispatchSSEEvent(event, {
+        handlers: {
+          onAck,
+          onPhaseStart,
+          onPhaseUpdate,
+          onPhaseEnd,
+          onPatch,
+          onAgentStatus,
+          onThinkingTrace,
+          onExecutionTrace,
+          onContent,
+          onTextReplace,
+          onDone,
+          onTrace,
+          onWorkspaceActivation,
+          onUICards,
+          onKnowledgeBaseState,
+          onFieldProgress,
+          onRequirementDraft,
+          onNextActions,
+          onSourcingCandidates,
+          onRiskSummary,
+          onShortlistUpdated,
+          onEvaluationReportReady,
+          onCategoryIdentified,
+          onFieldsUpdated,
+          onInstanceProfile,
+          onModeRuntime,
+          onAgentRuntime,
+          onSkillRuntime,
+          onModeSwitchReason,
+          onKnowledgeSearch,
+          onKnowledgeCitation,
+          onOrchestrationStatus,
+          onCanvasState,
+          onCanvasRevision,
+          onPlanBlock,
+          onDoc,
+          onCapabilitySuggestion,
+          onPatchEvent,
+          onError,
+        },
+        appendChunk: (chunk) => {
+          accumulatedRef.current += chunk;
+        },
+        replaceChunk: (contentValue) => {
+          accumulatedRef.current = contentValue;
+        },
+        setLatestSessionId: (sessionValue) => {
+          latestSessionId = sessionValue;
+        },
+      });
+    };
+
+    const completeHandler = async () => {
+      setLoading(false);
+      await onComplete?.(accumulatedRef.current, {
+        sessionId: latestSessionId || null,
+      });
+      accumulatedRef.current = '';
+    };
+
+    const transportErrorHandler = (errorMessage) => {
+      setLoading(false);
+      const errorType = classifyError(errorMessage);
+      setError({ message: errorMessage, type: errorType });
+      onError?.({ message: errorMessage });
+      accumulatedRef.current = '';
+    };
+
+    const requestOptions = {
+      sessionId: String(resolvedSessionId || '').trim() || null,
+      content,
+      enabledCapabilities: Array.isArray(options.enabledCapabilities) ? options.enabledCapabilities : [],
+      modeKey: typeof options.modeKey === 'string' ? options.modeKey : '',
+      manualModeKey: typeof options.manualModeKey === 'string' ? options.manualModeKey : '',
+      command: typeof options.command === 'string' ? options.command : '',
+      clientRequestId: typeof options.clientRequestId === 'string' ? options.clientRequestId : '',
+      contractVersion: typeof options.contractVersion === 'string' ? options.contractVersion : '',
+      lastTurnId: typeof options.lastTurnId === 'string' ? options.lastTurnId : '',
+      payloadExtra: (
+        options.payloadExtra
+        && typeof options.payloadExtra === 'object'
+        && !Array.isArray(options.payloadExtra)
+      )
+        ? options.payloadExtra
+        : {},
+      endpoint: options.endpoint,
+      baseUrl: options.baseUrl,
+      url: options.url,
+      token: typeof options.token === 'string' ? options.token : '',
+      auth: (
+        options.auth
+        && typeof options.auth === 'object'
+        && !Array.isArray(options.auth)
+      ) ? options.auth : undefined,
+      onTiming: typeof options.onTiming === 'function' ? options.onTiming : undefined,
+    };
+
+    if (!requestOptions.enabledCapabilities.length) {
+      delete requestOptions.enabledCapabilities;
+    }
+    if (!requestOptions.modeKey) delete requestOptions.modeKey;
+    if (!requestOptions.manualModeKey) delete requestOptions.manualModeKey;
+    if (!requestOptions.command) delete requestOptions.command;
+    if (!requestOptions.clientRequestId) delete requestOptions.clientRequestId;
+    if (!requestOptions.contractVersion) delete requestOptions.contractVersion;
+    if (!requestOptions.lastTurnId) delete requestOptions.lastTurnId;
+    if (!Object.keys(requestOptions.payloadExtra || {}).length) delete requestOptions.payloadExtra;
+
+    if (!requestOptions.endpoint) delete requestOptions.endpoint;
+    if (!requestOptions.baseUrl) delete requestOptions.baseUrl;
+    if (!requestOptions.url) delete requestOptions.url;
+    if (!requestOptions.token) delete requestOptions.token;
+    if (!requestOptions.auth) delete requestOptions.auth;
+    if (!requestOptions.onTiming) delete requestOptions.onTiming;
+
+    await clientRef.current.sendMessage(
+      requestOptions,
+      eventHandler,
+      completeHandler,
+      transportErrorHandler
+    );
+  }, [sessionId]);
+
+  const retry = useCallback(async () => {
+    const { content, handlers, options } = lastMessageRef.current;
+    if (!content) return;
+    await send(content, handlers, options);
+  }, [send]);
+
+  const abort = useCallback(() => {
+    clientRef.current.abort();
+    setLoading(false);
+    accumulatedRef.current = '';
+  }, []);
+
+  useEffect(() => () => {
+    clientRef.current.abort();
+  }, []);
+
+  return { send, loading, error, retry, abort };
+}
+
+export default useSSEStream;

package/src/state/index.js

@@ -0,0 +1,4 @@
+export {
+  useChatSessionReducer,
+  initialState as chatSessionInitialState,
+} from '../chat-core/session/index.js';

package/vite.config.js

@@ -0,0 +1,36 @@
+import path from 'node:path';
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+const devPort = 9000;
+const previewPort = 9001;
+const devHost = process.env.FLARE_CHAT_CORE_DEV_HOST || '127.0.0.1';
+const workspaceRoot = path.resolve(__dirname, '..', '..');
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: [
+      { find: /^@\//, replacement: `${path.resolve(__dirname, 'src')}/` },
+      { find: /^flare-chat-core$/, replacement: path.resolve(__dirname, 'src', 'index.js') },
+      { find: /^flare-generative-ui$/, replacement: path.resolve(__dirname, '..', 'flare-generative-ui', 'src', 'index.js') },
+      { find: /^flare-canvas-ui$/, replacement: path.resolve(__dirname, '..', 'flare-canvas-ui', 'src', 'index.js') },
+      { find: /^@dva89\/flare-api-client-ts$/, replacement: path.resolve(__dirname, '..', 'flare-api-client-ts', 'src', 'index.js') },
+      { find: /^react$/, replacement: path.resolve(workspaceRoot, 'node_modules', 'react') },
+      { find: /^react-dom$/, replacement: path.resolve(workspaceRoot, 'node_modules', 'react-dom') },
+      { find: /^antd$/, replacement: path.resolve(workspaceRoot, 'node_modules', 'antd') },
+      { find: /^@ant-design\/icons$/, replacement: path.resolve(workspaceRoot, 'node_modules', '@ant-design', 'icons') },
+    ],
+  },
+  server: {
+    host: devHost,
+    port: devPort,
+    fs: {
+      allow: [workspaceRoot],
+    },
+  },
+  preview: {
+    host: devHost,
+    port: previewPort,
+  },
+});