AI Valve

AI Valve gives site administrators visibility and control over how plugins use the built-in WordPress AI connector.

Features

• Per-plugin access control — Allow or deny individual plugins from making AI requests.
• Abilities API guard — Optionally apply the same policy to WordPress Abilities API calls (WordPress 7.1+), keyed by ability namespace.
• Token budgets — Set daily and monthly token limits per plugin and globally.
• Context restrictions — Control which execution contexts (admin, frontend, cron, REST, AJAX, CLI) may trigger AI calls.
• Usage dashboard — See token consumption at a glance with summary cards, progress bars, and per-plugin breakdowns.
• Request logging — Every AI request is logged with provider, model, capability, tokens, and caller attribution.
• Budget alerts — Admin notices and optional email when usage approaches or exceeds limits.

Requirements

• WordPress 7.0 or later
• PHP 8.3 or later
• A configured AI provider in Settings → Connectors

Developer Hooks

AI Valve exposes filters and actions so you can extend its behaviour without editing the plugin. Full signatures, parameters, and examples are in the developer hooks documentation.

• aivalve_plugin_policy (filter) — Override the allow/deny decision for any plugin.
• aivalve_request_denied (action) — React when an AI request is blocked.
• aivalve_request_completed (action) — React when an AI request succeeds (token counts available).
• aivalve_ability_invoked (action) — React when an Abilities API call is invoked (WP 7.1+).
• aivalve_ability_denied (action) — React when an Abilities API call is blocked (WP 7.1+).

Renamed in 1.3.0 from the soderlind_aivalve_ prefix; the old names still fire as deprecated aliases and will be removed in a future major version.