mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-11-18 22:36:29 +00:00
Initialize the scheduler store before snapshots. Preserve legacy memory calls and per-action permissions while advertising the unified tool, and retain saved policy IDs for moved tools. Restore legacy log rendering and connector tool events, and reject malformed boolean arguments by default.
3.2 KiB
3.2 KiB
Memory Plugin DOX
Purpose
- Own persistent memory, knowledge import, vector indexing, and memory management UI.
Ownership
helpers/memory.pyowns FAISS store loading, embedding metadata, and knowledge preload.helpers/knowledge_import.pyandhelpers/memory_consolidation.pyown import and consolidation behavior.tools/memory.pyowns the singlememorytool whoseactionarg selects load, save, delete or forget.- Legacy
tools/memory_{load,save,delete,forget}.pyfiles re-export that implementation for saved prompts/calls. Their names fix the action regardless of supplied arguments; onlymemoryis advertised to models. - The memory tool logs messages as its own
memorytype with icon verb headlines;extensions/webui/get_message_handler/owns the sharedMEMbadge presentation in the behavior adjustment brain pink accent andextensions/webui/get_process_step_types/registers the types. get_tool_message_handlerreuses the memory renderer for savedtype="tool"logs with legacy memory names.api/andwebui/own memory dashboard and knowledge reindex/import flows.extensions/webui/owns the welcome-screen Memory card and the quick-actions dropdown entries.prompts/,default_config.yaml, andplugin.yamlown memory prompts, defaults, and metadata.
Local Contracts
- Keep memory scoped by configured subdirectory/context.
- Shared tool policy preserves saved per-action memory permissions in both unified and legacy calls; an allowed load must not grant save, delete or forget. Explicit tool-wide blocks cover every alias.
- Preserve embedding metadata needed to rebuild indexes safely.
- Delayed recall results must survive
LoopDatareplacement, stay scoped to the originating memory/profile/project, and be consumed once by the next prompt; do not persist live task objects into chat JSON. - The
loadaction accepts numericthresholdandlimitvalues as native numbers or numeric strings and coerces them before vector search. - The tool-prompt declaration must start with
argsso native Responses models receive thememorytool. - Auto-recall embeds each prepared query once and reuses that vector for the memory and solution filters; manual
loadkeeps the ordinary text-query path. - Keep auto-recall context capability-neutral; memory-tool routing belongs in the policy-filtered memory tool prompt.
- Avoid storing transient action-history noise as durable memory.
Work Guidance
- Both dashboard selection toolbars use icon-only actions with accessible labels and the shared borderless close control before the selection count.
- Dashboard selection checkboxes reuse the shared native theme from
webui/index.css; keep header and row controls 16px and centered in their table cells. - Keep dashboard metadata JSON-safe without changing shared API serialization.
- Coordinate tool, prompt, and consolidation changes so saved memories remain useful and bounded.
Verification
- Smoke-test save, recall, delete, dashboard search/update, and knowledge import/reindex after changes.
- Run
tests/test_tool_policy.pyandtests/test_tool_compatibility.pyfor action permissions and legacy calls, andtests/test_webui_tool_compatibility.pyfor saved-log rendering.
Child DOX Index
No child DOX files.