feat: Unified Plugin System & Memory Plugin PoC by 3clyp50 · Pull Request #998 · agent0ai/agent-zero

3clyp50 · 2026-02-07T19:02:23Z

Convention-over-configuration: runtime capability discovery relies on directory layout.
Direct imports: plugin code uses standard Python imports.
Full backend decoupling: memory APIs, tools, and extensions now live in plugins/memory/; core interacts through conventions and extension calls.
Python extension convention update: plugin lifecycle extensions are under extensions/python/<point>/ (not extensions/backend/).
WebUI extension system: frontend switched from plugins.js/meta-target injection to x-extension breakpoints resolved by webui/js/extensions.js.
WebUI extension API: /api/load_webui_extensions provides filtered extension assets by extension point.
Alpine placement directives baseline: x-move-* directives in initFw.js are documented as the standard baseline for HTML UI extensions together with root x-data.
Plugin UI split:
- Hook contributions: plugins/<id>/extensions/webui/<extension_point>/...
- Full plugin pages/components: plugins/<id>/webui/...

@frdel commits

`3918133cbf316296b312cd4cbed9592c4261cb95` - "plugins - frontend PoC"

python/api/load_webui_extensions.py and webui/js/extensions.js alignment.
Added first x-extension insertion points in core UI.
Established plugin-owned WebUI assets under plugins/<id>/webui/... and hook assets under plugins/<id>/extensions/webui/....

`3bfdf91637b8b5053c2441f24a785ac82283a676` - "Support webui JS/HTML extensions and plugin paths"

Consolidated extension loading in webui/js/extensions.js.
Added JS hook execution in message rendering flow (set_messages_before_loop, set_messages_after_loop).
Added file filtering support to /api/load_webui_extensions and plugin helper scanning.
Standardized lifecycle extension path at extensions/python/....

`39a81d0d5d145de4299fb69e7e1adbabbeb96f33` - "Refactor memory imports; add Alpine move directives"

Added Alpine move directives (x-move-*) in webui/js/initFw.js for precise plugin placement.
Moved memory quick-action extension from sidebar-quick-actions-main-2 to sidebar-quick-actions-main-start.
Updated quick-actions breakpoints and cleaned obsolete insertion IDs.
Refactored memory imports/tools for cleaner plugin-local imports.

Architectural Decisions & Divergences

Python vs WebUI Extension Split

Decision: separate extension concerns into:

extensions/python/<point>/... for lifecycle/backend hooks
extensions/webui/<point>/... for frontend hook contributions
Rationale: clear runtime boundaries and simpler scanning logic per environment.

Frontend Breakpoints (`x-extension`)

Decision: core UI defines explicit insertion breakpoints, plugins contribute HTML/JS by extension point.
Status: implemented and functional. Documentation sets a stricter baseline for HTML contributions (x-data + required explicit x-move-*).

Remaining: Core-to-Plugin Decoupling

Memory-related settings fields and memory settings tab still exist in core configuration/UI. Plugin-specific settings?

3clyp50 · 2026-02-11T01:09:48Z

Updated and rebased to v0.9.8

frdel · 2026-02-12T08:21:10Z

python/helpers/plugins.py

+    Priority: project plugins > usr plugins > core plugins
+    """
+    # Project-specific plugins
+    projects = files.find_existing_paths_by_pattern("usr/projects/*/.a0proj/plugins")


Comment out for now, we can add project/agent plugins later

frdel · 2026-02-12T08:25:54Z

python/helpers/plugins.py

+    name: str
+    path: Path
+    manifest_path: Path
+    provides: Dict[str, Any] = field(default_factory=dict)  # capability map


We can remove this

frdel · 2026-02-12T08:28:19Z

python/helpers/plugins.py

+    paths: List[str] = []
+
+    for plugin in list_plugins():
+        cap_config = plugin.provides.get(cap_type)


frdel · 2026-02-12T08:28:30Z

python/helpers/plugins.py

+    return str(Path(module_path).parent)
+
+
+def get_plugin_paths(cap_type: str, *subpaths: str) -> List[str]:


Only leave subpaths

frdel · 2026-02-12T08:31:28Z

python/helpers/plugins.py

+        if not cap_config:
+            continue
+
+        # Normalize to list for uniform processing


The code is too complex, it should simply find existing paths under plugin roots:

get_plugin_paths("extensions")
returns:
/plugins/plugin1/extensions
/usr/plugins/plugin2/extensions
etc...

We just need to do is files.find_existing_paths_by_pattern with plugin roots.

frdel · 2026-02-12T09:22:59Z

plugins/memory/extensions/python/message_loop_prompts_after/_50_recall_memories.py

@@ -1,215 +1,8 @@
-import asyncio


This extension should no longer exist in the core, it should only exist in the plugin.

frdel · 2026-02-12T09:23:02Z

plugins/memory/extensions/python/monologue_end/_50_memorize_fragments.py

@@ -1,198 +1,8 @@
-import asyncio


This extension should no longer exist in the core, it should only exist in the plugin.

frdel · 2026-02-12T09:23:08Z

plugins/memory/extensions/python/monologue_end/_51_memorize_solutions.py

@@ -1,201 +1,8 @@
-import asyncio


This extension should no longer exist in the core, it should only exist in the plugin.

frdel · 2026-02-12T09:23:36Z

plugins/memory/extensions/python/monologue_start/_10_memory_init.py

@@ -1,13 +1,8 @@
-from python.helpers.extension import Extension


This extension should no longer exist in the core, it should only exist in the plugin.

frdel · 2026-02-12T09:24:48Z

python/extensions/system_prompt/_20_behaviour_prompt.py

@@ -1,7 +1,10 @@
 from datetime import datetime


Let's keep behaviour prompt ouside of memory plugin, it's not related to memory except for the file placement.
We will make behaviour adjustment a standalone plugin as it has a tool, extension, prompt and a file.

plugin manifest update add memory plugin PoC files offload memory prompts cleanup imports extract memory UI fix paths plugin docs

update agent plugin refs rm plugin system spec restore subagents.py

components.js restore plugins tools fix restore agent.py

…into pluginsystem

Add full support for loading web UI extensions from plugins: - Frontend: new extensions loader (js/extensions.js) that loads and caches JS and HTML extensions, calls JS hooks, imports HTML as <x-component> tags, normalizes paths, and replaces the old plugins.js auto-inject logic. - Messages: make setMessages async, introduce extension hooks (set_messages_before_loop / after_loop) and integrate JS extension calls; adjust Scroller usage accordingly. - Components: fix x-component path handling in several templates and components import logic. - Backend: add filters to /api/load_webui_extensions and pass them to plugin helper; update helpers to look for plugin extensions under extensions/python instead of backend. - Plugins helper: extend get_webui_extensions to accept file glob filters, dedupe matches, return relative paths, and improve error logging. - Project config: include plugins and usr/plugins JS files in jsconfig.json. - Add a small test extension file and move several plugin extension files from backend/ to python/ directories. - Minor: reset error_retries earlier in agent message loop to avoid stale retry counts. These changes enable a flexible plugin extension system for both JS and HTML assets, improve caching and path normalization, and wire up backend APIs and helpers to support the new structure.

Cleanup and refactor memory plugin imports to use plugins.memory.helpers.memory directly (remove sys.path hacks) and adjust related tools (memory_load, memory_save, memory_delete, memory_forget). Move the memory quick-action entry to a new start extension file and update quick-actions HTML to remove obsolete extension points and rename the dropdown end id. Update JS extension caller to forward multiple arguments (rest params) and add several Alpine directives (move-to-start, move-to-end, move-to, move-before, move-after) plus selector helpers to support dynamic element repositioning. Also removed an unused python/__init__.py and minor whitespace/comment cleanups.

Worth discussing: in memory-entry.html I had issues with x-move-to usage. The visual aspect is different than moving the element after the same target with x-move-after.

3clyp50 force-pushed the pluginsystem branch 5 times, most recently from 05960f0 to c70a234 Compare February 11, 2026 01:08

frdel reviewed Feb 12, 2026

View reviewed changes

3clyp50 and others added 3 commits February 14, 2026 17:05

initial plugins effort; memory system PoC

54fb474

plugin manifest update add memory plugin PoC files offload memory prompts cleanup imports extract memory UI fix paths plugin docs

update docs and add agents capability

a3c0682

update agent plugin refs rm plugin system spec restore subagents.py

files_path_get fix

c2f579d

3clyp50 force-pushed the pluginsystem branch from c70a234 to c2f579d Compare February 14, 2026 16:06

3clyp50 and others added 3 commits February 14, 2026 17:15

recall memory update from development

e548bf2

simplification and further memory decoupling

e18efbb

plugins tools fix

0c581eb

This comment was marked as outdated.

Sign in to view

3clyp50 added 4 commits February 15, 2026 03:16

components.js restore

29bc7d3

restore agent.py

383d54d

simplification and further memory decoupling

d69e30a

components.js restore plugins tools fix restore agent.py

Merge branch 'pluginsystem' of https://github.com/3clyp50/agent-zero …

eb3cb38

…into pluginsystem

This was referenced Feb 16, 2026

feat: Honcho Conversational Memory Integration (User Extension) #1054

Open

feat: add Honcho conversational memory integration example #1055

Open

frdel and others added 6 commits February 16, 2026 20:01

plugins - frontend PoC

3918133

update docs

618179f

quick-actions css fix; tooltips in plugins

addd0ab

dropdown memory entry

57b1833

Worth discussing: in memory-entry.html I had issues with x-move-to usage. The visual aspect is different than moving the element after the same target with x-move-after.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Unified Plugin System & Memory Plugin PoC#998

feat: Unified Plugin System & Memory Plugin PoC#998
3clyp50 wants to merge 16 commits intoagent0ai:developmentfrom
3clyp50:pluginsystem

3clyp50 commented Feb 7, 2026 •

edited

Loading

Uh oh!

3clyp50 commented Feb 11, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

frdel Feb 12, 2026

Uh oh!

This comment was marked as outdated.

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		return str(Path(module_path).parent)


		def get_plugin_paths(cap_type: str, *subpaths: str) -> List[str]:

		@@ -1,13 +1,8 @@
		from python.helpers.extension import Extension

Uh oh!

Conversation

3clyp50 commented Feb 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

@frdel commits

3918133cbf316296b312cd4cbed9592c4261cb95 - "plugins - frontend PoC"

3bfdf91637b8b5053c2441f24a785ac82283a676 - "Support webui JS/HTML extensions and plugin paths"

39a81d0d5d145de4299fb69e7e1adbabbeb96f33 - "Refactor memory imports; add Alpine move directives"

Architectural Decisions & Divergences

Python vs WebUI Extension Split

Frontend Breakpoints (x-extension)

Remaining: Core-to-Plugin Decoupling

Uh oh!

3clyp50 commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This comment was marked as outdated.

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

3clyp50 commented Feb 7, 2026 •

edited

Loading

`3918133cbf316296b312cd4cbed9592c4261cb95` - "plugins - frontend PoC"

`3bfdf91637b8b5053c2441f24a785ac82283a676` - "Support webui JS/HTML extensions and plugin paths"

`39a81d0d5d145de4299fb69e7e1adbabbeb96f33` - "Refactor memory imports; add Alpine move directives"

Frontend Breakpoints (`x-extension`)