@lobehub/lobehub 2.0.0-next.294 → 2.0.0-next.296

package/packages/builtin-tool-memory/src/client/components/ExperienceMemoryCard.tsx

@@ -0,0 +1,231 @@
+'use client';
+
+import { Accordion, AccordionItem, Avatar, Flexbox, Tag, Text } from '@lobehub/ui';
+import { Steps } from 'antd';
+import { createStaticStyles, cssVar } from 'antd-style';
+import { memo } from 'react';
+
+import BubblesLoading from '@/components/BubblesLoading';
+import NeuralNetworkLoading from '@/components/NeuralNetworkLoading';
+import StreamingMarkdown from '@/components/StreamingMarkdown';
+import { highlightTextStyles } from '@/styles';
+
+import type { AddExperienceMemoryParams } from '../../types';
+
+const styles = createStaticStyles(({ css, cssVar }) => ({
+  container: css`
+    overflow: hidden;
+
+    width: 100%;
+    border: 1px solid ${cssVar.colorBorderSecondary};
+    border-radius: 16px;
+
+    background: ${cssVar.colorBgContainer};
+  `,
+  content: css`
+    padding-block: 12px;
+    padding-inline: 16px;
+  `,
+  detail: css`
+    font-size: 13px;
+    line-height: 1.6;
+    color: ${cssVar.colorTextSecondary};
+  `,
+  header: css`
+    padding-block: 10px;
+    padding-inline: 12px;
+    border-block-end: 1px solid ${cssVar.colorBorderSecondary};
+  `,
+  keyLearning: css`
+    font-size: 14px;
+    line-height: 1.6;
+    color: ${cssVar.colorText};
+  `,
+  section: css`
+    padding: 4px;
+    border-block-start: 1px solid ${cssVar.colorBorderSecondary};
+  `,
+  stepContent: css`
+    font-size: 13px;
+    line-height: 1.6;
+    color: ${cssVar.colorTextSecondary};
+    white-space: pre-wrap;
+  `,
+  stepsContainer: css`
+    .ant-steps-item-content {
+      min-height: auto;
+    }
+
+    .ant-steps-item-description {
+      padding-block-end: 12px !important;
+    }
+  `,
+  summary: css`
+    font-size: 14px;
+    font-weight: 500;
+    color: ${cssVar.colorTextSecondary};
+  `,
+  tags: css`
+    padding-block-start: 8px;
+    border-block-start: 1px dashed ${cssVar.colorBorderSecondary};
+  `,
+  title: css`
+    overflow: hidden;
+    display: -webkit-box;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 1;
+
+    font-weight: 500;
+    color: ${cssVar.colorText};
+  `,
+}));
+
+export interface ExperienceMemoryCardProps {
+  data?: AddExperienceMemoryParams;
+  loading?: boolean;
+}
+
+export const ExperienceMemoryCard = memo<ExperienceMemoryCardProps>(({ data, loading }) => {
+  const { summary, details, tags, title, withExperience } = data || {};
+  const { situation, reasoning, action, possibleOutcome, keyLearning } = withExperience || {};
+
+  const hasStarContent = situation || reasoning || action || possibleOutcome;
+
+  if (!summary && !details && !tags?.length && !title && !hasStarContent && !keyLearning)
+    return null;
+
+  const starItems = [
+    { avatar: 'S', content: situation, title: 'Situation' },
+    { avatar: 'T', content: reasoning, title: 'Task' },
+    { avatar: 'A', content: action, title: 'Action' },
+    { avatar: 'R', content: possibleOutcome, title: 'Result' },
+  ].filter((item) => item.content);
+
+  return (
+    <Flexbox className={styles.container}>
+      {/* Header */}
+      <Flexbox align={'center'} className={styles.header} gap={8} horizontal>
+        <Flexbox flex={1}>
+          <div className={styles.title}>{title || 'Experience Memory'}</div>
+        </Flexbox>
+        {loading && <NeuralNetworkLoading size={20} />}
+      </Flexbox>
+
+      {/* When has STAR content: collapse summary */}
+      {hasStarContent ? (
+        <>
+          {/* Collapsed Summary */}
+          {(summary || tags?.length) && (
+            <Accordion gap={0}>
+              <AccordionItem
+                itemKey="summary"
+                paddingBlock={8}
+                paddingInline={8}
+                styles={{
+                  base: { marginBlock: 4, marginInline: 4 },
+                }}
+                title={
+                  <Text fontSize={12} type={'secondary'} weight={500}>
+                    Summary
+                  </Text>
+                }
+              >
+                <Flexbox gap={8} paddingBlock={'8px 12px'} paddingInline={8}>
+                  {summary && <div className={styles.summary}>{summary}</div>}
+                  {details && <div className={styles.detail}>{details}</div>}
+                  {tags && tags.length > 0 && (
+                    <Flexbox className={styles.tags} gap={8} horizontal wrap={'wrap'}>
+                      {tags.map((tag, index) => (
+                        <Tag key={index}>{tag}</Tag>
+                      ))}
+                    </Flexbox>
+                  )}
+                </Flexbox>
+              </AccordionItem>
+            </Accordion>
+          )}
+
+          {/* STAR Steps */}
+          <Accordion className={styles.section} defaultExpandedKeys={['star']} gap={0}>
+            <AccordionItem
+              itemKey="star"
+              paddingBlock={8}
+              paddingInline={8}
+              title={
+                <Text fontSize={12} type={'secondary'} weight={500}>
+                  STAR
+                </Text>
+              }
+            >
+              <Flexbox paddingBlock={'8px 12px'} paddingInline={8}>
+                <Steps
+                  className={styles.stepsContainer}
+                  current={null as any}
+                  direction="vertical"
+                  items={starItems.map((item) => ({
+                    description: <div className={styles.stepContent}>{item.content}</div>,
+                    icon: (
+                      <Avatar
+                        avatar={item.avatar}
+                        shadow
+                        shape={'square'}
+                        size={20}
+                        style={{
+                          border: `1px solid ${cssVar.colorBorderSecondary}`,
+                          fontSize: 11,
+                        }}
+                      />
+                    ),
+                    title: (
+                      <Text as={'span'} fontSize={12} type={'secondary'} weight={500}>
+                        {item.title}
+                      </Text>
+                    ),
+                  }))}
+                  size="small"
+                />
+              </Flexbox>
+            </AccordionItem>
+          </Accordion>
+
+          {/* Key Learning */}
+          {keyLearning && (
+            <Flexbox
+              className={styles.section}
+              gap={8}
+              style={{ paddingBlock: 16, paddingInline: 12 }}
+            >
+              <Text fontSize={12} weight={500}>
+                <span className={highlightTextStyles.gold}>Key Learning</span>
+              </Text>
+              <div className={styles.keyLearning}>{keyLearning}</div>
+            </Flexbox>
+          )}
+        </>
+      ) : (
+        /* When no STAR content: show summary and details */
+        <Flexbox className={styles.content} gap={8}>
+          {!summary && loading ? (
+            <BubblesLoading />
+          ) : (
+            <>
+              {summary && <div className={styles.summary}>{summary}</div>}
+              {details && <StreamingMarkdown>{details}</StreamingMarkdown>}
+              {tags && tags.length > 0 && (
+                <Flexbox className={styles.tags} gap={8} horizontal wrap={'wrap'}>
+                  {tags.map((tag, index) => (
+                    <Tag key={index}>{tag}</Tag>
+                  ))}
+                </Flexbox>
+              )}
+            </>
+          )}
+        </Flexbox>
+      )}
+    </Flexbox>
+  );
+});
+
+ExperienceMemoryCard.displayName = 'ExperienceMemoryCard';
+
+export default ExperienceMemoryCard;

package/packages/builtin-tool-memory/src/client/components/index.ts

@@ -0,0 +1 @@
+export { ExperienceMemoryCard, type ExperienceMemoryCardProps } from './ExperienceMemoryCard';

package/packages/builtin-tool-memory/src/client/index.ts

@@ -0,0 +1,27 @@
+// Inspector components (customized tool call headers)
+export { MemoryInspectors } from './Inspector';
+export {
+  AddContextMemoryInspector,
+  AddExperienceMemoryInspector,
+  AddIdentityMemoryInspector,
+  AddPreferenceMemoryInspector,
+  RemoveIdentityMemoryInspector,
+  SearchUserMemoryInspector,
+  UpdateIdentityMemoryInspector,
+} from './Inspector';
+
+// Intervention components (human approval UI before tool execution)
+export { MemoryInterventions } from './Intervention';
+
+// Render components (final result display after tool execution)
+export { MemoryRenders } from './Render';
+
+// Streaming components (real-time feedback during tool execution)
+export { AddExperienceMemoryStreaming, MemoryStreamings } from './Streaming';
+
+// Shared components
+export { ExperienceMemoryCard, type ExperienceMemoryCardProps } from './components';
+
+// Re-export types and manifest for convenience
+export { MemoryManifest } from '../manifest';
+export * from '../types';

package/packages/builtin-tool-memory/src/executor/index.ts

@@ -41,6 +41,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `searchUserMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -80,6 +81,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `addContextMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -110,13 +112,15 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
       }
 
       return {
-        content: `🧠 Experience memory saved: "${params.title}"`,
+        content: `Experience memory "${params.title}" saved with memoryId: "${result.memoryId}" and experienceId: "${result.experienceId}"`,
         state: { experienceId: result.experienceId, memoryId: result.memoryId },
         success: true,
       };
     } catch (error) {
       const err = error as Error;
+
       return {
+        content: `addExperienceMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -154,6 +158,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `addIdentityMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -191,6 +196,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `addPreferenceMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -230,6 +236,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `updateIdentityMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,
@@ -264,6 +271,7 @@ class MemoryExecutor extends BaseExecutor<typeof MemoryApiName> {
     } catch (error) {
       const err = error as Error;
       return {
+        content: `removeIdentityMemory with error detail: ${err.message}`,
         error: {
           body: error,
           message: err.message,

package/packages/builtin-tool-memory/src/types.ts

@@ -1,3 +1,14 @@
+import type {
+  AddIdentityActionSchema,
+  ContextMemoryItemSchema,
+  ExperienceMemoryItemSchema,
+  PreferenceMemoryItemSchema,
+  RemoveIdentityActionSchema,
+  UpdateIdentityActionSchema,
+} from '@lobechat/memory-user-memory/schemas';
+import type {  SearchMemoryResult } from '@lobechat/types';
+import type { z } from 'zod';
+
 export const MemoryApiName = {
   addContextMemory: 'addContextMemory',
   addExperienceMemory: 'addExperienceMemory',
@@ -12,3 +23,53 @@ export type MemoryApiNameType = (typeof MemoryApiName)[keyof typeof MemoryApiNam
 
 /** @deprecated Use MemoryApiName instead */
 export const UserMemoryApiName = MemoryApiName;
+
+// ==================== Inspector Types ====================
+
+// Search
+
+// SearchUserMemoryState is the same as SearchMemoryResult (executor returns result directly as state)
+export type SearchUserMemoryState = SearchMemoryResult;
+
+// Add Context
+export type AddContextMemoryParams = z.infer<typeof ContextMemoryItemSchema>;
+export interface AddContextMemoryState {
+  contextId?: string;
+  memoryId?: string;
+}
+
+// Add Experience
+export type AddExperienceMemoryParams = z.infer<typeof ExperienceMemoryItemSchema>;
+export interface AddExperienceMemoryState {
+  experienceId?: string;
+  memoryId?: string;
+}
+
+// Add Identity
+export type AddIdentityMemoryParams = z.infer<typeof AddIdentityActionSchema>;
+export interface AddIdentityMemoryState {
+  identityId?: string;
+  memoryId?: string;
+}
+
+// Add Preference
+export type AddPreferenceMemoryParams = z.infer<typeof PreferenceMemoryItemSchema>;
+export interface AddPreferenceMemoryState {
+  memoryId?: string;
+  preferenceId?: string;
+}
+
+// Update Identity
+export type UpdateIdentityMemoryParams = z.infer<typeof UpdateIdentityActionSchema>;
+export interface UpdateIdentityMemoryState {
+  identityId?: string;
+}
+
+// Remove Identity
+export type RemoveIdentityMemoryParams = z.infer<typeof RemoveIdentityActionSchema>;
+export interface RemoveIdentityMemoryState {
+  identityId?: string;
+  reason?: string;
+}
+
+export {type SearchMemoryParams, type SearchMemoryResult} from '@lobechat/types';

package/packages/context-engine/src/providers/GTDTodoInjector.ts

@@ -5,12 +5,15 @@ import type { PipelineContext, ProcessorOptions } from '../types';
 
 const log = debug('context-engine:provider:GTDTodoInjector');
 
+/** Status of a todo item */
+export type GTDTodoStatus = 'todo' | 'processing' | 'completed';
+
 /**
  * GTD Todo item structure
  */
 export interface GTDTodoItem {
-  /** Whether the item is completed */
-  completed: boolean;
+  /** Status of the todo item */
+  status: GTDTodoStatus;
   /** The todo item text */
   text: string;
 }
@@ -43,13 +46,15 @@ function formatGTDTodos(todos: GTDTodoList): string | null {
   const lines: string[] = ['<gtd_todos>'];
 
   items.forEach((item, index) => {
-    const status = item.completed ? 'done' : 'pending';
-    lines.push(`<todo index="${index}" status="${status}">${item.text}</todo>`);
+    lines.push(`<todo index="${index}" status="${item.status}">${item.text}</todo>`);
   });
 
-  const completedCount = items.filter((item) => item.completed).length;
+  const completedCount = items.filter((item) => item.status === 'completed').length;
+  const processingCount = items.filter((item) => item.status === 'processing').length;
   const totalCount = items.length;
-  lines.push(`<progress completed="${completedCount}" total="${totalCount}" />`);
+  lines.push(
+    `<progress completed="${completedCount}" processing="${processingCount}" total="${totalCount}" />`,
+  );
 
   lines.push('</gtd_todos>');
 
@@ -117,7 +122,10 @@ export class GTDTodoInjector extends BaseLastUserContentProvider {
     clonedContext.metadata.gtdTodoInjected = true;
     clonedContext.metadata.gtdTodoCount = this.config.todos.items.length;
     clonedContext.metadata.gtdTodoCompletedCount = this.config.todos.items.filter(
-      (item) => item.completed,
+      (item) => item.status === 'completed',
+    ).length;
+    clonedContext.metadata.gtdTodoProcessingCount = this.config.todos.items.filter(
+      (item) => item.status === 'processing',
     ).length;
 
     log('GTD Todo context appended to last user message');

package/packages/conversation-flow/src/__tests__/fixtures/outputs/assistantGroup/tools-with-branches.json

@@ -90,6 +90,10 @@
                 "id": "msg-504",
                 "state": {
                   "cached": false
+                },
+                "error": {
+                  "type": "NameError",
+                  "message": "name 'result' is not defined"
                 }
               },
               "result_msg_id": "msg-504"

package/packages/conversation-flow/src/transformation/FlatListBuilder.ts

@@ -644,6 +644,7 @@ export class FlatListBuilder {
               id: toolMsg.id,
             };
             if (toolMsg.error) result.error = toolMsg.error;
+            if (toolMsg.pluginError) result.error = toolMsg.pluginError;
             if (toolMsg.pluginState) result.state = toolMsg.pluginState;
 
             const toolWithResult: ChatToolPayloadWithResult = {

package/packages/database/src/models/__tests__/knowledgeBase.test.ts

@@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
 import { sleep } from '@/utils/sleep';
 
+import { getTestDB } from '../../core/getTestDB';
 import {
   NewKnowledgeBase,
   documents,
@@ -15,7 +16,6 @@ import {
 } from '../../schemas';
 import { LobeChatDatabase } from '../../type';
 import { KnowledgeBaseModel } from '../knowledgeBase';
-import { getTestDB } from '../../core/getTestDB';
 
 const serverDB: LobeChatDatabase = await getTestDB();
 

package/packages/database/src/repositories/knowledge/index.ts

@@ -556,10 +556,7 @@ export class KnowledgeRepo {
       // When in a knowledge base, return standalone documents (folders and notes without fileId)
       // that have the knowledgeBaseId column set. Documents with fileId are already
       // returned by the file query via their linked file records.
-      kbWhereConditions.push(
-        sql`d.file_id IS NULL`,
-        sql`d.knowledge_base_id = ${knowledgeBaseId}`,
-      );
+      kbWhereConditions.push(sql`d.file_id IS NULL`, sql`d.knowledge_base_id = ${knowledgeBaseId}`);
 
       return sql`
         SELECT

package/packages/prompts/src/prompts/gtd/index.test.ts

@@ -15,12 +15,12 @@ describe('formatTodoStateSummary', () => {
 
   it('should format todo list with only pending items', () => {
     const todos = [
-      { text: 'Task A', completed: false },
-      { text: 'Task B', completed: false },
-      { text: 'Task C', completed: false },
+      { text: 'Task A', status: 'todo' as const },
+      { text: 'Task B', status: 'todo' as const },
+      { text: 'Task C', status: 'todo' as const },
     ];
     expect(formatTodoStateSummary(todos)).toMatchInlineSnapshot(`
-      "📋 Current Todo List (3 pending, 0 completed):
+      "📋 Current Todo List (3 todo, 0 processing, 0 completed):
       - [ ] Task A
       - [ ] Task B
       - [ ] Task C"
@@ -29,11 +29,11 @@ describe('formatTodoStateSummary', () => {
 
   it('should format todo list with only completed items', () => {
     const todos = [
-      { text: 'Done task 1', completed: true },
-      { text: 'Done task 2', completed: true },
+      { text: 'Done task 1', status: 'completed' as const },
+      { text: 'Done task 2', status: 'completed' as const },
     ];
     expect(formatTodoStateSummary(todos)).toMatchInlineSnapshot(`
-      "📋 Current Todo List (0 pending, 2 completed):
+      "📋 Current Todo List (0 todo, 0 processing, 2 completed):
       - [x] Done task 1
       - [x] Done task 2"
     `);
@@ -41,12 +41,12 @@ describe('formatTodoStateSummary', () => {
 
   it('should format todo list with mixed items', () => {
     const todos = [
-      { text: 'Pending task', completed: false },
-      { text: 'Completed task', completed: true },
-      { text: 'Another pending', completed: false },
+      { text: 'Pending task', status: 'todo' as const },
+      { text: 'Completed task', status: 'completed' as const },
+      { text: 'Another pending', status: 'todo' as const },
     ];
     expect(formatTodoStateSummary(todos)).toMatchInlineSnapshot(`
-      "📋 Current Todo List (2 pending, 1 completed):
+      "📋 Current Todo List (2 todo, 0 processing, 1 completed):
       - [ ] Pending task
       - [x] Completed task
       - [ ] Another pending"
@@ -55,21 +55,37 @@ describe('formatTodoStateSummary', () => {
 
   it('should format todo list with timestamp', () => {
     const todos = [
-      { text: 'Task 1', completed: false },
-      { text: 'Task 2', completed: true },
+      { text: 'Task 1', status: 'todo' as const },
+      { text: 'Task 2', status: 'completed' as const },
     ];
     expect(formatTodoStateSummary(todos, '2025-01-15T10:30:00.000Z')).toMatchInlineSnapshot(`
-      "📋 Current Todo List (1 pending, 1 completed) | Updated: 2025-01-15T10:30:00.000Z:
+      "📋 Current Todo List (1 todo, 0 processing, 1 completed) | Updated: 2025-01-15T10:30:00.000Z:
       - [ ] Task 1
       - [x] Task 2"
     `);
   });
 
   it('should handle single item', () => {
-    const todos = [{ text: 'Only task', completed: false }];
+    const todos = [{ text: 'Only task', status: 'todo' as const }];
     expect(formatTodoStateSummary(todos)).toMatchInlineSnapshot(`
-      "📋 Current Todo List (1 pending, 0 completed):
+      "📋 Current Todo List (1 todo, 0 processing, 0 completed):
       - [ ] Only task"
     `);
   });
+
+  it('should format todo list with processing items', () => {
+    const todos = [
+      { text: 'Todo task', status: 'todo' as const },
+      { text: 'Processing task 1', status: 'processing' as const },
+      { text: 'Processing task 2', status: 'processing' as const },
+      { text: 'Done task', status: 'completed' as const },
+    ];
+    expect(formatTodoStateSummary(todos)).toMatchInlineSnapshot(`
+      "📋 Current Todo List (1 todo, 2 processing, 1 completed):
+      - [ ] Todo task
+      - [~] Processing task 1
+      - [~] Processing task 2
+      - [x] Done task"
+    `);
+  });
 });

package/packages/prompts/src/prompts/gtd/index.ts

@@ -1,5 +1,7 @@
+export type TodoStatus = 'todo' | 'processing' | 'completed';
+
 export interface TodoItem {
-  completed: boolean;
+  status: TodoStatus;
   text: string;
 }
 
@@ -17,13 +19,15 @@ export const formatTodoStateSummary = (todos: TodoItem[], updatedAt?: string): s
     return `📋 Current Todo List: (empty)${timeInfo}`;
   }
 
-  const completed = todos.filter((t) => t.completed).length;
-  const pending = todos.length - completed;
+  const completed = todos.filter((t) => t.status === 'completed').length;
+  const processing = todos.filter((t) => t.status === 'processing').length;
+  const pending = todos.length - completed - processing;
 
   const lines = todos.map((item) => {
-    const checkbox = item.completed ? '- [x]' : '- [ ]';
+    const checkbox =
+      item.status === 'completed' ? '- [x]' : item.status === 'processing' ? '- [~]' : '- [ ]';
     return `${checkbox} ${item.text}`;
   });
 
-  return `📋 Current Todo List (${pending} pending, ${completed} completed)${timeInfo}:\n${lines.join('\n')}`;
+  return `📋 Current Todo List (${pending} todo, ${processing} processing, ${completed} completed)${timeInfo}:\n${lines.join('\n')}`;
 };

package/packages/types/src/discover/assistants.ts

@@ -18,7 +18,7 @@ export enum AssistantCategory {
   Marketing = 'marketing',
   Office = 'office',
   Programming = 'programming',
-  Translation = 'translation'
+  Translation = 'translation',
 }
 
 export enum AssistantSorts {
@@ -29,7 +29,7 @@ export enum AssistantSorts {
   PluginCount = 'pluginCount',
   Recommended = 'recommended',
   Title = 'title',
-  TokenUsage = 'tokenUsage'
+  TokenUsage = 'tokenUsage',
 }
 
 export enum AssistantNavKey {

package/packages/types/src/stepContext.ts

@@ -10,12 +10,15 @@
  * 3. Replaces the deprecated pluginState passing pattern
  */
 
+/** Status of a todo item */
+export type StepContextTodoStatus = 'todo' | 'processing' | 'completed';
+
 /**
  * Todo item structure
  * Duplicated here to avoid circular dependency with builtin-tool-gtd
  */
 export interface StepContextTodoItem {
-  completed: boolean;
+  status: StepContextTodoStatus;
   text: string;
 }