new feat: add enhancement and env variable for scheduler (#650)

* debug an error function name

* feat: Add DynamicCache compatibility for different transformers versions

- Fix build_kv_cache method in hf.py to handle both old and new DynamicCache structures
  - Support new 'layers' attribute with key_cache/value_cache or keys/values
  - Maintain backward compatibility with direct key_cache/value_cache attributes
  - Add comprehensive error handling and logging for unsupported structures

- Update move_dynamic_cache_htod function in kv.py for cross-version compatibility
  - Handle layers-based structure in newer transformers versions
  - Support alternative attribute names (keys/values vs key_cache/value_cache)
  - Preserve original functionality for older transformers versions

- Add comprehensive tests for DynamicCache compatibility
  - Test activation memory update with mock DynamicCache layers
  - Verify layers attribute access across different transformers versions
  - Fix scheduler logger mock to include memory_manager attribute
This resolves AttributeError issues when using different versions of the
transformers library and ensures robust handling of DynamicCache objects.

debug

* feat: implement APIAnalyzerForScheduler for memory operations

- Add APIAnalyzerForScheduler class with search/add operations
- Support requests and http.client with connection reuse
- Include comprehensive error handling and dynamic configuration
- Add English test suite with real-world conversation scenarios

* feat: Add search_ws API endpoint and enhance API analyzer functionality

- Add search_ws endpoint in server_router.py for scheduler-enabled search
- Fix missing imports: time module, SearchRequest class, and get_mos_product_instance function
- Implement search_ws method in api_analyzer.py with HTTP client support
- Add _search_ws_with_requests and _search_ws_with_http_client private methods
- Include search_ws usage example in demonstration code
- Enhance scheduler and dispatcher capabilities for improved memory management
- Expand test coverage to ensure functionality stability

This update primarily strengthens the memory scheduling system's search capabilities,
providing users with more flexible API interface options.

* fix: resolve test failures and warnings in test suite

- Fix Pydantic serialization warning in test_memos_chen_tang_hello_world
  * Add warnings filter to suppress UserWarning from Pydantic serialization

- Fix KeyError: 'past_key_values' in test_build_kv_cache_and_generation
  * Update mock configuration to properly return forward_output with past_key_values
  * Add DynamicCache version compatibility handling in test mocks
  * Support both old and new transformers versions with layers/key_cache attributes
  * Improve assertion logic to check all model calls for required parameters

- Update base_scheduler.py to use centralized DEFAULT_MAX_INTERNAL_MESSAGE_QUEUE_SIZE constant
  * Add import for DEFAULT_MAX_INTERNAL_MESSAGE_QUEUE_SIZE from general_schemas
  * Replace hardcoded value 100 with configurable constant (1000)

All tests now pass successfully with proper version compatibility handling.

* feat: add a test_robustness execution to test thread pool execution

* feat: optimize scheduler configuration and API search functionality

- Add DEFAULT_TOP_K and DEFAULT_CONTEXT_WINDOW_SIZE global constants in general_schemas.py
- Update base_scheduler.py to use global default values instead of hardcoded numbers
- Fix SchedulerConfigFactory initialization issue by using keyword argument expansion
- Resolve UnboundLocalError variable conflict in search_memories_ws function
- Fix indentation and parameter issues in OptimizedScheduler search_for_api method
- Improve code standardization and maintainability

* feat: Add Redis auto-initialization with fallback strategies

- Add auto_initialize_redis() with config/env/local fallback
- Move Redis logic from dispatcher_monitor to redis_service
- Update base_scheduler to use auto initialization
- Add proper resource cleanup and error handling

* feat: add database connection management to ORM module

- Add MySQL engine loading from environment variables in BaseDBManager
- Add Redis connection loading from environment variables in BaseDBManager
- Enhance database configuration validation and error handling
- Complete database adapter infrastructure for ORM module
- Provide unified database connection management interface

This update provides comprehensive database connection management capabilities
for the mem_scheduler module, supporting dynamic MySQL and Redis configuration
loading from environment variables, establishing reliable data persistence
foundation for scheduling services and API services.

* remove part of test

* feat: add Redis-based ORM with multiprocess synchronization

- Add RedisDBManager and RedisLockableORM classes
- Implement atomic locking mechanism for concurrent access
- Add merge functionality for different object types
- Include comprehensive test suite and examples
- Fix Redis key type conflicts in lock operations

* fix: resolve scheduler module import and Redis integration issues

* revise naive memcube creation in server router

* remove long-time tests in test_scheduler

* remove redis test which needs .env

* refactor all codes about mixture search with scheduler

* fix: resolve Redis API synchronization issues and implement search API with reranker

- Fix running_entries to running_task_ids migration across codebase
- Update sync_search_data method to properly handle TaskRunningStatus
- Correct variable naming and logic in API synchronization flow
- Implement search API endpoint with reranker functionality
- Update test files to reflect new running_task_ids convention
- Ensure proper Redis state management for concurrent tasks

* remove a test for api module

* revise to pass the test suite

* address some bugs to make mix_search normally running

* modify codes according to evaluation logs

* feat: Optimize mixture search and enhance API client

* feat: Add conversation_turn tracking for session-based memory search

    - Add conversation_turn field to APIMemoryHistoryEntryItem schema with default value 0
    - Implement session counter in OptimizedScheduler to track turn count per session_id
    - Update sync_search_data method to accept and store conversation_turn parameter
    - Maintain session history with LRU eviction (max 5 sessions)
    - Rename conversation_id to session_id for consistency with request object
    - Enable direct access to session_id from search requests

    This feature allows tracking conversation turns within the same session,
    providing better context for memory retrieval and search history management.

* adress time bug in monitor

* revise simple tree

* add mode to evaluation client; rewrite print to logger.info in db files

* feat: 1. add redis queue for scheduler 2. finish the code related to mix search and fine search

* debug the working memory code

* addressed a range of bugs to make scheduler running correctly

* remove test_dispatch_parallel test

* print change to logger.info

* adjucted the core code related to fine and mixture apis

* feat: create task queue to wrap local queue and redis queue. queue now split FIFO to multi queue from different users. addressed a range of bugs

* fix bugs: debug bugs about internet trigger

* debug get searcher mode

* feat: add manual internet

* Fix: fix code format

* feat: add strategy for fine search

* debug redis queue

* debug redis queue

* fix bugs: completely addressed bugs about redis queue

* refactor: add searcher to handler_init; remove info log from task_queue

* refactor: modify analyzer

* refactor: revise locomo_eval to make it support llm other than gpt-4o-mini

* feat: develop advanced searcher with deep search

* feat: finish a complete version of deep search

* refactor: refactor deep search feature, now only allowing one-round deep search

* feat: implement the feature of get_tasks_status, but completed tasks are not recorded yet; waiting to be developed

* debuging merged code; searching memories have bugs

* change logging level

* debug api evaluation

* fix bugs: change top to top_k

* change log

* refactor: rewrite deep search to make it work better

* change num_users

* feat: developed and test task broker and orchestrator

* Fix: Include task_id in ScheduleMessageItem serialization

* Fix(Scheduler): Correct event log creation and task_id serialization

* Feat(Scheduler): Add conditional detailed logging for KB updates
Fix(Scheduler): Correct create_event_log indentation

* Fix(Scheduler): Correct create_event_log call sites

Reverts previous incorrect fix to scheduler_logger.py and correctly fixes the TypeError at the call sites in general_scheduler.py by removing the invalid 'log_content' kwarg and adding the missing memory_type kwargs.

* Fix(Scheduler): Deserialize task_id in ScheduleMessageItem.from_dict

This completes the fix for the task_id loss. The 'to_dict' method was previously fixed to serialize the task_id, but the corresponding 'from_dict' method was not updated to deserialize it, causing the value to be lost when messages were read from the queue.

* Refactor(Config): Centralize RabbitMQ config override logic

Moves all environment variable override logic into initialize_rabbitmq for a single source of truth. This ensures Nacos-provided environment variables for all RabbitMQ settings are respected over file configurations. Also removes now-redundant logging from the publish method.

* Revert "Refactor(Config): Centralize RabbitMQ config override logic"

This reverts commit b8cc42a.

* Fix(Redis): Convert None task_id to empty string during serialization

Resolves DataError in Redis Streams when task_id is None by ensuring
it's serialized as an empty string instead of None, which Redis does
not support. Applies to ScheduleMessageItem.to_dict method.

* Feat(Log): Add diagnostic log to /product/add endpoint

Adds an INFO level diagnostic log message at the beginning of the
create_memory function to help verify code deployment.

* Feat(Log): Add comprehensive diagnostic logs for /product/add flow

Introduces detailed INFO level diagnostic logs across the entire call chain
for the /product/add API endpoint. These logs include relevant context,
such as full request bodies, message items before scheduler submission,
and messages before RabbitMQ publication, to aid in debugging deployment
discrepancies and tracing data flow, especially concerning task_id
propagation.

Logs added/enhanced in:
- src/memos/api/routers/product_router.py
- src/memos/api/handlers/add_handler.py
- src/memos/multi_mem_cube/single_cube.py
- src/memos/mem_os/core.py
- src/memos/mem_scheduler/general_scheduler.py
- src/memos/mem_scheduler/base_scheduler.py
- src/memos/mem_scheduler/webservice_modules/rabbitmq_service.py

* Feat(Log): Add comprehensive diagnostic logs for /product/add flow and apply ruff formatting

Introduces detailed INFO level diagnostic logs across the entire call chain
for the /product/add API endpoint. These logs include relevant context,
such as full request bodies, message items before scheduler submission,
and messages before RabbitMQ publication, to aid in debugging deployment
discrepancies and tracing data flow, especially concerning task_id
propagation.

Also applies automatic code formatting using ruff format to all modified files.

Logs added/enhanced in:
- src/memos/api/routers/product_router.py
- src/memos/api/handlers/add_handler.py
- src/memos/multi_mem_cube/single_cube.py
- src/memos/mem_os/core.py
- src/memos/mem_scheduler/general_scheduler.py
- src/memos/mem_scheduler/base_scheduler.py
- src/memos/mem_scheduler/webservice_modules/rabbitmq_service.py

* Fix(rabbitmq): Use env vars for KB updates and improve logging

* Fix(rabbitmq): Explicitly use MEMSCHEDULER_RABBITMQ_EXCHANGE_NAME and empty routing key for KB updates

* Fix(add_handler): Update diagnostic log timestamp

* Fix(add_handler): Update diagnostic log timestamp again (auto-updated)

* Update default scheduler redis stream prefix

* Update diagnostic timestamp in add handler

* Allow optional log_content in scheduler event log

* feat: new examples to test scheduelr

* feat: fair scheduler and refactor of search function

* fix bugs: address bugs caused by outdated test code

* feat: add task_schedule_monitor

* fix: handle nil mem_cube in scheduler message consumers

* fix bugs: response messaged changed in memos code

* refactor: revise task queue to allow it dealing with pending tasks when no task remaining

* refactor: revise mixture search and scheduler logger

* Fix scheduler task tracking

* fix bugs: address ai review issues

* fix bugs: address rabbitmq initialization failed when doing pytest

* fix(scheduler): Correct dispatcher task and future tracking

* Remove dump.rdb

* fix bugs: revised message ack logics; refactor add log function

* fix bugs: change Chinese notation to English

* fix indent error in logger

* fix bugs: addressed the issues caused by multiprocessing codes obtain same pending tasks

* addMemory/updateMemory log

* fix bugs: modify redis queue logics to make it run as expected

* feat: add a default mem cube initialization for scheduler

* address scheduler init bug

* feat(scheduler): Propagate trace_id across process boundaries for mem… (#592)

feat(scheduler): Propagate trace_id across process boundaries for mem_scheduler logs

This commit addresses the issue where 'trace_id' was missing from logs generated by the 'mem_scheduler' module, especially when tasks were executed in separate processes.

The changes implement a manual propagation of 'trace_id' from the message producer to the consumer:
1.  **Schema Update**: Added an optional 'trace_id' field to 'ScheduleMessageItem' in 'src/memos/mem_scheduler/schemas/message_schemas.py' to allow 'trace_id' to be carried within messages.
2.  **Producer-side Capture**: Modified 'src/memos/mem_scheduler/task_schedule_modules/task_queue.py' to capture the current 'trace_id' and embed it into the 'ScheduleMessageItem' before messages are enqueued.
3.  **Consumer-side Context Re-establishment**: Updated 'src/memos/mem_scheduler/task_schedule_modules/dispatcher.py' to extract the 'trace_id' from incoming messages and re-establish the logging context using 'RequestContext' for each task's execution. This ensures all logs within a task's scope correctly include its associated 'trace_id', even when crossing process boundaries.

This approach ensures robust and accurate tracing of tasks within the scheduler, enhancing observability and debugging capabilities.

Co-authored-by: [email protected] <>

* fix bugs: redis queue allows to reget pending tasks which exceeding idle time

* fix(scheduler): Correct lazy-loading logic for mem_cube property

* Add MONITOR_EVENT logs for scheduler lifecycle

* fix: Resolve Ruff linting and formatting issues

* Handle dequeue timestamp without pydantic errors

* feat: orchestrator add task priority; move task labels into task_schemas; add synchronous execuation option in dispatcher

* feat: more logs for debug

* fix bugs: addresss some bugs

* refactor: remove logger info in pref add function

* refactor: change redis queue to periodically refresh pending tasks

* feat: a faster and better redis queue

* refactor: remove cleanup in redis queue

* feat: allow directly execute task if task priority is level 1

* refactor: refactor log_add_handler and redis queue to make the code running better

* fix bugs: fix the bug in _process_chat_data

* fix: use message item_id for task status updates instead of execution id

* style: format dispatcher.py with ruff

* chore: emit dequeue for immediate tasks

* fix: resolve ruff UP038 in base_scheduler.py

* feat: add scheduler queue status endpoint

* fix: lazy-init redis in queue status handler

* fix: unwrap queue wrapper for redis status

* fix bugs: fix a bug causing no schedule memory

* feat: add a new env variable to set stream_prefix in redis; make add func hallucination filter to improve qualities of added memories

* fix bugs: update start_listening in redis_queue

---------

Co-authored-by: fridayL <[email protected]>
Co-authored-by: [email protected] <>
Co-authored-by: Zehao Lin <[email protected]>

Author: 3 people

examples/mem_scheduler/try_schedule_modules.py

@@ -41,14 +41,26 @@ def init_task():
             "role": "user",
             "content": "Max needs joint supplements. Actually, we're moving to Chicago next month.",
         },
+        {
+            "role": "assistant",
+            "content": "Got it — Max is on joint supplements, and you’re relocating to Chicago soon. That’s a big move! Have you looked into how the change in climate or vet access might affect his needs?",
+        },
         {
             "role": "user",
             "content": "Correction: Bella is 6, not 5. And she's allergic to chicken.",
         },
+        {
+            "role": "assistant",
+            "content": "Thanks for the update! So Bella is 6 years old and has a chicken allergy — good to know. You’ll want to double-check her food and treats, especially during the move. Has she had any reactions recently?",
+        },
         {
             "role": "user",
             "content": "My partner's cat Whiskers visits weekends. Bella chases her sometimes.",
         },
+        {
+            "role": "assistant",
+            "content": "Ah, the classic dog-and-cat dynamic! Since Bella chases Whiskers, it might help to give them gradual supervised interactions or create safe zones for the cat—especially important as you settle into a new home in Chicago. Keeping Bella’s routine stable during the move could also reduce her urge to chase. How do they usually get along when Whiskers visits?",
+        },
     ]
 
     questions = [
@@ -145,18 +157,25 @@ def start_conversation(self, user_id="test_user", mem_cube_id="test_cube", sessi
         print(f"   User ID: {self.current_user_id}")
         print(f"   Mem Cube ID: {self.current_mem_cube_id}")
 
-    def add_msgs(self, messages: list[dict]):
+    def add_msgs(
+        self,
+        messages: list[dict],
+        extract_mode: str = "fine",
+        async_mode: str = "sync",
+    ):
         # Create add request
         add_req = self.create_test_add_request(
             user_id=self.current_user_id,
             mem_cube_id=self.current_mem_cube_id,
             messages=messages,
             session_id=self.current_session_id,
+            extract_mode=extract_mode,
+            async_mode=async_mode,
         )
 
         # Add to memory
         result = self.add_memories(add_req)
-        print(f"   ✅ Added to memory successfully: \n{messages}")
+        print(f"   ✅ Added to memory successfully: \n{result}")
 
         return result
 

src/memos/mem_reader/simple_struct.py

@@ -1,6 +1,7 @@
 import concurrent.futures
 import copy
 import json
+import os
 import re
 import traceback
 
@@ -25,6 +26,7 @@
 from memos.templates.mem_reader_prompts import (
     CUSTOM_TAGS_INSTRUCTION,
     CUSTOM_TAGS_INSTRUCTION_ZH,
+    PROMPT_MAPPING,
     SIMPLE_STRUCT_DOC_READER_PROMPT,
     SIMPLE_STRUCT_DOC_READER_PROMPT_ZH,
     SIMPLE_STRUCT_MEM_READER_EXAMPLE,
@@ -80,6 +82,7 @@ def from_config(_config):
     "custom_tags": {"en": CUSTOM_TAGS_INSTRUCTION, "zh": CUSTOM_TAGS_INSTRUCTION_ZH},
 }
 
+
 try:
     import tiktoken
 
@@ -448,6 +451,81 @@ def get_memory(
         standard_scene_data = coerce_scene_data(scene_data, type)
         return self._read_memory(standard_scene_data, type, info, mode)
 
+    @staticmethod
+    def _parse_hallucination_filter_response(text: str) -> tuple[bool, dict[int, dict]]:
+        """Parse index-keyed JSON from hallucination filter response.
+        Expected shape: { "0": {"if_delete": bool, "rewritten memory content": str}, ... }
+        Returns (success, parsed_dict) with int keys.
+        """
+        try:
+            data = json.loads(text)
+        except Exception:
+            return False, {}
+
+        if not isinstance(data, dict):
+            return False, {}
+
+        result: dict[int, dict] = {}
+        for k, v in data.items():
+            try:
+                idx = int(k)
+            except Exception:
+                # allow integer keys as-is
+                if isinstance(k, int):
+                    idx = k
+                else:
+                    continue
+            if not isinstance(v, dict):
+                continue
+            delete_flag = v.get("delete_flag")
+            rewritten = v.get("rewritten memory content", "")
+            if isinstance(delete_flag, bool) and isinstance(rewritten, str):
+                result[idx] = {"delete_flag": delete_flag, "rewritten memory content": rewritten}
+
+        return (len(result) > 0), result
+
+    def filter_hallucination_in_memories(
+        self, user_messages: list[str], memory_list: list[list[TextualMemoryItem]]
+    ):
+        filtered_memory_list = []
+        for group in memory_list:
+            try:
+                flat_memories = [one.memory for one in group]
+                template = PROMPT_MAPPING["hallucination_filter"]
+                prompt_args = {
+                    "user_messages_inline": "\n".join(user_messages),
+                    "memories_inline": json.dumps(flat_memories, ensure_ascii=False, indent=2),
+                }
+                prompt = template.format(**prompt_args)
+
+                # Optionally run filter and parse the output
+                try:
+                    raw = self.llm.generate(prompt)
+                    success, parsed = self._parse_hallucination_filter_response(raw)
+                    logger.info(f"Hallucination filter parsed successfully: {success}")
+                    new_mem_list = []
+                    if success:
+                        logger.info(f"Hallucination filter result: {parsed}")
+                        for mem_idx, (delete_flag, rewritten_mem_content) in parsed.items():
+                            if not delete_flag:
+                                group[mem_idx].memory = rewritten_mem_content
+                                new_mem_list.append(group[mem_idx])
+                        filtered_memory_list.append(new_mem_list)
+                        logger.info(
+                            f"Successfully transform origianl memories from {group} to {new_mem_list}."
+                        )
+                    else:
+                        logger.warning(
+                            "Hallucination filter parsing failed or returned empty result."
+                        )
+                except Exception as e:
+                    logger.error(f"Hallucination filter execution error: {e}", stack_info=True)
+                    filtered_memory_list.append(group)
+            except Exception:
+                logger.error("Fail to filter memories", stack_info=True)
+                filtered_memory_list.append(group)
+        return filtered_memory_list
+
     def _read_memory(
         self, messages: list[MessagesType], type: str, info: dict[str, Any], mode: str = "fine"
     ) -> list[list[TextualMemoryItem]]:
@@ -492,6 +570,14 @@ def _read_memory(
                 except Exception as e:
                     logger.error(f"Task failed with exception: {e}")
                     logger.error(traceback.format_exc())
+
+        if os.getenv("SIMPLE_STRUCT_ADD_FILTER", "false") == "true":
+            # Build inputs
+            user_messages = [msg.content for msg in messages if msg.role == "user"]
+            memory_list = self.filter_hallucination_in_memories(
+                user_messages=user_messages, memory_list=memory_list
+            )
+
         return memory_list
 
     def fine_transfer_simple_mem(

src/memos/mem_scheduler/analyzer/api_analyzer.py

@@ -599,6 +599,8 @@ def create_test_add_request(
         messages=None,
         memory_content=None,
         session_id=None,
+        extract_mode=None,
+        async_mode="sync",
     ):
         """
         Create a test APIADDRequest object with the given parameters.
@@ -637,6 +639,8 @@ def create_test_add_request(
             source="api_analyzer_test",
             chat_history=None,
             operation=None,
+            mode=extract_mode,
+            async_mode=async_mode,
         )
 
     def run_all_tests(self, mode=SearchMode.MIXTURE):

src/memos/mem_scheduler/base_scheduler.py

@@ -140,12 +140,7 @@ def __init__(self, config: BaseSchedulerConfig):
             "max_internal_message_queue_size", DEFAULT_MAX_INTERNAL_MESSAGE_QUEUE_SIZE
         )
         self.orchestrator = SchedulerOrchestrator()
-        self.memos_message_queue = ScheduleTaskQueue(
-            use_redis_queue=self.use_redis_queue,
-            maxsize=self.max_internal_message_queue_size,
-            disabled_handlers=self.disabled_handlers,
-            orchestrator=self.orchestrator,
-        )
+
         self.searcher: Searcher | None = None
         self.retriever: SchedulerRetriever | None = None
         self.db_engine: Engine | None = None
@@ -155,6 +150,13 @@ def __init__(self, config: BaseSchedulerConfig):
         self.status_tracker: TaskStatusTracker | None = None
         self.metrics = metrics
         self._monitor_thread = None
+        self.memos_message_queue = ScheduleTaskQueue(
+            use_redis_queue=self.use_redis_queue,
+            maxsize=self.max_internal_message_queue_size,
+            disabled_handlers=self.disabled_handlers,
+            orchestrator=self.orchestrator,
+            status_tracker=self.status_tracker,
+        )
         self.dispatcher = SchedulerDispatcher(
             config=self.config,
             memos_message_queue=self.memos_message_queue,
@@ -228,6 +230,8 @@ def initialize_modules(
                 self.status_tracker = TaskStatusTracker(redis_client)
                 if self.dispatcher:
                     self.dispatcher.status_tracker = self.status_tracker
+                if self.memos_message_queue:
+                    self.memos_message_queue.status_tracker = self.status_tracker
             # initialize submodules
             self.chat_llm = chat_llm
             self.process_llm = process_llm

src/memos/mem_scheduler/general_modules/misc.py

@@ -233,7 +233,7 @@ def put(self, item: T, block: bool = False, timeout: float | None = None) -> Non
 
     def get(
         self, block: bool = True, timeout: float | None = None, batch_size: int | None = None
-    ) -> list[T] | T:
+    ) -> list[T]:
         """Get items from the queue.
 
         Args:

src/memos/mem_scheduler/schemas/task_schemas.py

@@ -62,10 +62,9 @@ class TaskPriorityLevel(Enum):
 
 
 # task queue
-DEFAULT_STREAM_KEY_PREFIX = "scheduler:messages:stream:v1.7"
-exchange_name = os.getenv("MEMSCHEDULER_RABBITMQ_EXCHANGE_NAME", None)
-if exchange_name is not None:
-    DEFAULT_STREAM_KEY_PREFIX += f":{exchange_name}"
+DEFAULT_STREAM_KEY_PREFIX = os.getenv(
+    "MEMSCHEDULER_STREAM_KEY_PREFIX", "scheduler:messages:stream:v2.0"
+)
 
 
 # ============== Running Tasks ==============

src/memos/mem_scheduler/task_schedule_modules/dispatcher.py

@@ -273,6 +273,7 @@ def wrapped_handler(messages: list[ScheduleMessageItem]):
                                 mem_cube_id=msg.mem_cube_id,
                                 task_label=msg.label,
                                 redis_message_id=redis_message_id,
+                                message=msg,
                             )
                     except Exception as ack_err:
                         logger.warning(f"Ack in finally failed: {ack_err}")

src/memos/mem_scheduler/task_schedule_modules/redis_queue.py

@@ -328,7 +328,12 @@ def put(
             raise
 
     def ack_message(
-        self, user_id: str, mem_cube_id: str, task_label: str, redis_message_id
+        self,
+        user_id: str,
+        mem_cube_id: str,
+        task_label: str,
+        redis_message_id,
+        message: ScheduleMessageItem | None,
     ) -> None:
         stream_key = self.get_stream_key(
             user_id=user_id, mem_cube_id=mem_cube_id, task_label=task_label
@@ -347,6 +352,12 @@ def ack_message(
 
         try:
             self._redis_conn.xack(stream_key, self.consumer_group, redis_message_id)
+
+            if message:
+                self.status_tracker.task_completed(task_id=message.item_id, user_id=message.user_id)
+                logger.info(
+                    f"Message {message.item_id} | {message.label} | {message.content} has been acknowledged."
+                )
         except Exception as e:
             logger.warning(
                 f"xack failed for stream '{stream_key}', msg_id='{redis_message_id}': {e}"
@@ -364,7 +375,7 @@ def get(
         stream_key: str,
         block: bool = True,
         timeout: float | None = None,
-        batch_size: int | None = None,
+        batch_size: int | None = 1,
     ) -> list[ScheduleMessageItem]:
         if not self._redis_conn:
             raise ConnectionError("Not connected to Redis. Redis connection not available.")
@@ -385,7 +396,7 @@ def get(
                     self.consumer_group,
                     self.consumer_name,
                     {stream_key: ">"},
-                    count=(batch_size if batch_size is not None else None),
+                    count=batch_size,
                     block=redis_timeout,
                 )
             except Exception as read_err:
@@ -400,7 +411,7 @@ def get(
                         self.consumer_group,
                         self.consumer_name,
                         {stream_key: ">"},
-                        count=(batch_size if batch_size is not None else None),
+                        count=batch_size,
                         block=redis_timeout,
                     )
                 else:
@@ -492,7 +503,7 @@ def get(
 
                     raise Empty("No messages available in Redis queue")
 
-            return result_messages if batch_size is not None else result_messages[0]
+            return result_messages
 
         except Exception as e:
             if "Empty" in str(type(e).__name__):
@@ -630,7 +641,7 @@ def start_listening(
 
         try:
             while self._is_listening:
-                messages = self.get(timeout=poll_interval, count=batch_size)
+                messages = self.get_messages(batch_size=1)
 
                 for message in messages:
                     try:

src/memos/mem_scheduler/task_schedule_modules/task_queue.py

@@ -14,6 +14,7 @@
 from memos.mem_scheduler.utils.db_utils import get_utc_now
 from memos.mem_scheduler.utils.misc_utils import group_messages_by_user_and_mem_cube
 from memos.mem_scheduler.utils.monitor_event_utils import emit_monitor_event, to_iso
+from memos.mem_scheduler.utils.status_tracker import TaskStatusTracker
 
 
 logger = get_logger(__name__)
@@ -26,10 +27,12 @@ def __init__(
         maxsize: int,
         disabled_handlers: list | None = None,
         orchestrator: SchedulerOrchestrator | None = None,
+        status_tracker: TaskStatusTracker | None = None,
     ):
         self.use_redis_queue = use_redis_queue
         self.maxsize = maxsize
         self.orchestrator = SchedulerOrchestrator() if orchestrator is None else orchestrator
+        self.status_tracker = status_tracker
 
         if self.use_redis_queue:
             if maxsize is None or not isinstance(maxsize, int) or maxsize <= 0:
@@ -51,6 +54,7 @@ def ack_message(
         mem_cube_id: str,
         task_label: str,
         redis_message_id,
+        message: ScheduleMessageItem | None,
     ) -> None:
         if not isinstance(self.memos_message_queue, SchedulerRedisQueue):
             logger.warning("ack_message is only supported for Redis queues")
@@ -61,6 +65,7 @@ def ack_message(
             mem_cube_id=mem_cube_id,
             task_label=task_label,
             redis_message_id=redis_message_id,
+            message=message,
         )
 
     def get_stream_keys(self) -> list[str]:

src/memos/multi_mem_cube/single_cube.py

@@ -93,7 +93,11 @@ def add_memories(self, add_req: APIADDRequest) -> list[dict[str, Any]]:
         for item in pref_results:
             item["cube_id"] = self.cube_id
 
-        return text_results + pref_results
+        all_memories = text_results + pref_results
+
+        # TODO: search existing memories and compare
+
+        return all_memories
 
     def search_memories(self, search_req: APISearchRequest) -> dict[str, Any]:
         # Create UserContext object
@@ -692,11 +696,13 @@ def _process_text_mem(
             sync_mode=sync_mode,
         )
 
-        return [
+        text_memories = [
             {
                 "memory": memory.memory,
                 "memory_id": memory_id,
                 "memory_type": memory.metadata.memory_type,
             }
             for memory_id, memory in zip(mem_ids_local, flattened_local, strict=False)
         ]
+
+        return text_memories