vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-09 17:08:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/plugins/_plugin_validator
History
frdel e138e33ca9 Add file-level DOX docs & update AGENTS indexes 
Add comprehensive file-level DOX documentation across the repo and update directory AGENTS.md indexes. Many new `*.py.dox.md` files were added under api, helpers, tools, plugins, extensions, webui, and other dirs to document endpoint purpose, ownership, runtime contracts, work guidance, and verification. Several AGENTS.md files were created or updated (agents profiles, api, docker, extensions, helpers, plugins, skills, webui components, etc.) to list child DOX files and clarify documentation/work guidance. Also add example and bundled profile DOX files (agent0, default, developer, hacker, researcher) and minor updates to helpers/dirty_json.py and its tests. These changes improve on-disk documentation coverage and establish the convention that each direct runtime file should have a matching `*.dox.md` describing its contracts and verification steps.
2026-06-08 12:41:53 +02:00
..
api add Plugin Validator built-in and harden plugin scanner 2026-03-16 04:05:24 +01:00
extensions/webui add Plugin Validator built-in and harden plugin scanner 2026-03-16 04:05:24 +01:00
helpers add Plugin Validator built-in and harden plugin scanner 2026-03-16 04:05:24 +01:00
webui Refactor: use user locale for time displays 2026-05-21 15:26:00 +02:00
AGENTS.md Add file-level DOX docs & update AGENTS indexes 2026-06-08 12:41:53 +02:00
plugin.yaml add Plugin Validator built-in and harden plugin scanner 2026-03-16 04:05:24 +01:00
README.md refactor: normalize plugin paths, add README viewer to plugin info modal, and update plugin hub filters 2026-03-22 08:05:32 +01:00

README.md

Plugin Validator

Validate Agent Zero plugins against structural, manifest, convention, and security expectations.

What It Does

This plugin generates a structured validation prompt for either a local plugin or an external source, runs the review in a temporary agent context, and returns a markdown report that checks whether a plugin follows Agent Zero plugin conventions.

Main Behavior

  • Source-aware validation
    • Supports validating a local plugin by name or a plugin fetched from a Git repository.
  • Checklist-based review
    • Loads validation criteria, status icons, and guidance text from plugin assets.
  • Temporary validation context
    • Creates a temporary agent context, runs the generated prompt, and cleans up the context and temporary chat afterward.
  • Operational guidance in prompt
    • Embeds source-specific handling instructions into the prompt, including cleanup rules for temporary validation directories.

Key Files

  • Validation runner
    • api/plugin_validator_run.py performs a synchronous validation and returns the report.
  • Prompt builder
    • helpers/prompt.py builds the validation prompt with source instructions, selected checks, and scoring guidance.
  • Additional APIs
    • api/plugin_validator_prepare_zip.py
    • api/plugin_validator_queue.py
    • api/plugin_validator_start.py

Configuration Scope

  • Settings sections: none
  • Per-project config: false
  • Per-agent config: false

Plugin Metadata

  • Name: _plugin_validator
  • Title: Plugin Validator
  • Description: Validate Agent Zero plugins against manifest, structure, code pattern, and security conventions.