Skip to main content
Glama
nvdigitalsolutions

NV Digital Open Operator System (NV oOS)

Official

NV Digital Open Operator System (NVoOS)

PHPUnit codecov JavaScript Tests PHP Linting Security Checks License: GPL v3 WordPress PHP Patent Pending Documentation

Version: 1.1.71 Release Date: 2026-09-05

See ยง Previous Releases for all version history.

๐Ÿ†• v1.1.71 Highlights: A rate-limit, model-catalog & ecosystem release. REST rate-limit blocks are now liftable โ€” the general request limiter uses fixed-window accounting (honest retry_after, no infinite slide) and flags the restriction registry via a new wp_mcp_ai_rest_request_rate_limit_exceeded action, so blocked users appear in the Command Center Restrictions tab with the existing Lift button. wake_up_context enforces wing/room scope (Graphify graph anchors no longer leak cross-wing memories into a wing-scoped block). The September 2026 model catalog refresh ships โ€” 228 models (gpt-5.6 family, gpt-6-astra preview, gpt-image-2, claude-opus-5, gemini-3.6/3.7/3.8-flash, kimi-k3), retired DeepSeek/gemini-3.1-flash/imagen-4 IDs with migration-map successors, pricing drift fixes, and new defaults (gemini-3.6-flash, gpt-image-2, kimi-k3). The checkout-api addon joins the standard build + test pipeline and its token/crypto classes now derive salts from wp_salt() (no more latent fatal on installs without salt constants). The Content Graph ecosystem advances: the standalone plugin ships its 1.0.4 visual experience system, Content Graph AI gains the assistant-builder block set + settings shell, and the platform completes its Wave E2 queue layer (async job queue โ†’ queue manager โ†’ job queue manager โ†’ dead-letter queue). Connectors links point at the real core screen. Coding-time agent skills: 54 (new mcp-ai-wpoos-updates skill). Tool count: ~303 base + ~1,263 Pro (~1,566 total).

MCP Specification: 2026-07-28 (Stateless Core, Full Compliance)
Maintained by NV Digital
License: GPLv3 or later
Requires: WordPress 6.0+, PHP 7.4+
Patent Status: Patent Pending (Application #19/410,504)
Documentation: Grade A (95/100) โ€” 1,617 files across 12 directories, 108 admin screenshots, 100% feature coverage

๐Ÿ” For Reviewers & Auditors

New to this repo? Start here โ†’ docs/project/FOR_REVIEWERS.md

That document answers every common question in one place: what the project is, current security posture, what's production vs experimental, PHP version requirements, AI development methodology, compliance status, and scoping advice for a limited-budget review.

Quick links for reviewers:

Related MCP server: WP MCP Ultimate

๐Ÿ“‘ Table of Contents

Getting Started

Core Functionality

Addons & Extensions

Orchestration & AI Features

AI Providers & Integration

Performance & Optimization

Remote MCP Setup

Assistant Management

Development

Reference


๐Ÿ—บ Repository Map

Directory

Purpose

includes/

Core plugin classes โ€” admin, assistants, tools, services, REST, security (10 infrastructure classes), providers (~15 AI backends), harness, data, markup, measurement, skills, professions, teams, slash-commands, A2A/ACP protocols, federation, elementor, blocks, crawler, integrations

lib/core/

Framework-agnostic AI orchestration engine (nvoos/core): 32 domain contracts, 21 WordPress adapters, ChatOrchestrator, ProviderRouter, ToolRegistry, SkillRegistry โ€” PHP 8.1+

addons/

27 installable addons (Pro, Chat SPA, Docs Hub, SaaS Controller, Cloud Worker, Cloudways Dashboard, Toolkit Shell, Canvas, Canvas Toolkit, Document Editor, Media Studio, Media Worker, Graphify, Comic Reader, Funiq Bridge, Fleet Operator, Algorave, Cornerstone3D, Crocoblock DS, Embedded, Fantasy Football, LibreChat, Schedule Anything Platform, Schedule Anything SPA, Tenant Router, Page Agent, Checkout API)

assets/

Frontend JS/CSS, images, CSV templates, examples

.agents/skills/

54 coding-time agent skills for Zed editor (20 wp-* WordPress plugin development patterns + 31 design-* skills + mcp-ai-wpoos-plugin operational guide + mcp-ai-wpoos-test-suite repair guide + mcp-ai-wpoos-updates maintenance guide)

.bmad/

6 BMAD workflow agent YAML definitions + team composition config

.context/

Subsystem context files (10 topics + 5 templates) for agent session loading

plugins/

Standalone plugins: NVOOS Content Graph, NVOOS Content Graph AI, NVOOS Content Graph AI Platform

packages/

23 NPM packages under @nvdigitalsolutions scope

src/

TMA (Telegram Mini App) builders + workflow builder source

shared/

Shared source code across builds

core/

Standalone "core" distribution (mcp-ai-wpoos-core.php)

config/

Site blueprints

examples/

Agent and workflow example code

extensions/

Hermes WebUI dashboard extensions (fleet monitoring/control plane, backup-download, external-app-tab, mcp-tool-shortcuts)

tests/

PHPUnit test suite

docs/

Comprehensive documentation (~1,600 files across 12 directories)

bin/

Development and deployment scripts

docker/

Docker Compose configuration

languages/

Translation files (.pot/.po/.mo)

patches/

Dependency patches

.github/

CI/CD workflows (~30 pipelines), custom agents, Copilot instructions


๐Ÿงฉ Overview

Real-time AI Orchestration Toolkit for Wordpress - NV oOS is a modular AI framework (Object-Oriented System) for WordPress that connects your site's data with 15 language-model providers: OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi (Moonshot), Z.AI (GLM), DigitalOcean, NVIDIA NIM, Cloudflare Worker AI, Ollama, LM Studio, Hugging Face, and Flowhub. It allows you to create and manage AI Assistants that can interact with users, access WordPress data, and perform custom tool functions.

โœจ What's New at a Glance (v1.1.71)

  • ๐Ÿ”“ REST Rate-Limit Unlock & Fixed-Window Timer (PR #6322). Users blocked by the general request limiter never appeared in the Command Center Restrictions tab, so admins couldn't lift the block. Two bugs: the limiter never flagged the restriction registry, and the window was sliding (every request rewrote the transient with a fresh full-window TTL, so steady traffic kept the block alive and retry_after always reported the full window). check_rate_limit() now uses fixed-window accounting ({count, first_seen}, TTL never extended past window end) with honest remaining-time retry_after; a new wp_mcp_ai_rest_request_rate_limit_exceeded action makes WP_MCP_AI_Restriction_Registry flag a rate_limit restriction (auto-release at window end) โ€” the block shows in the Restrictions tab + Token Manager with the Lift button, and lifting clears the request window. Guest (IP-keyed) blocks expire on their own.

  • ๐Ÿง  MemPalace Wing-Scope Enforcement (PR #6327). WP_MCP_AI_Tool_Wake_Up_Context::matches_wake_filters() now enforces wing/room exclusions โ€” the Graphify graph anchors only boost scores and never excluded out-of-scope memories, so wake_up_context in auto mode leaked cross-wing memories into a wing-scoped block once the Graphify addon loaded. The PR also ships four test-isolation fixes (transcript mock restore, shared registry teardown, provider-key isolation, logging cache reset).

  • ๐Ÿ›’ Checkout API Into the Addon Pipeline (PR #6315). bin/build-addon-zips.sh now produces build/nvoos-checkout-api-v<version>.zip, the addon's 6 suites join phpunit.xml.dist, and the build workflow gains a tests job. The new suite exposed a latent production fatal: the token/crypto classes read AUTH_KEY . SECURE_AUTH_KEY directly โ€” now wp_salt( 'auth' ) . wp_salt( 'secure_auth' ) (identical on normal installs, stable fallback otherwise).

  • ๐Ÿงญ September 2026 Model Catalog Refresh (PR #6328). 217 โ†’ 228 models: new gpt-5.6-sol/-terra/-luna, gpt-6-astra preview, gpt-image-2, claude-opus-5, claude-fable-5.1, claude-mythos-5, gemini-3.6/3.7/3.8-flash, gemini-3.5-flash-lite, deepseek-v4-flash-vision-exp, kimi-k3, kimi-k2.7-code; retired DeepSeek chat/reasoner/coder + gemini-3.1-flash + imagen-4 with migration-map successors; pricing drift fixes (DeepSeek v4-flash input 10ร—, Claude Opus inputs $15 โ†’ $5); new defaults (gemini-3.6-flash, gpt-image-2, kimi-k3); ~45 derived files updated; 517 model tests / 8,290 assertions green.

  • ๐ŸŒ Content Graph Ecosystem (PRs #6316โ€“#6321, #6325). The standalone nvoos-content-graph plugin ships its 1.0.4 visual experience system โ€” theme engine (PHP/JS byte-identical, WCAG 2.2 SC 1.4.11 โ‰ฅ3:1 palettes), appearance settings tab, 24 SVG type glyphs, legend/minimap/zoom/keyboard explorer chrome, GET /edges route, export at 1โ€“3ร—, block/shortcode attribute parity, and a checkout fallback redirect (#6318). Content Graph AI gains the assistant-builder block set (selector, tools grid, knowledge base, builder) and a validate-then-sanitize settings shell (#6316, #6317). The platform completes its Wave E2 queue layer: AsyncJobQueue โ†’ QueueManager โ†’ JobQueueManager (atomic SELECT โ€ฆ FOR UPDATE SKIP LOCKED) โ†’ DeadLetterQueue, byte-identical to the base stack (#6319โ€“#6321, #6325).

  • ๐Ÿ”— Connectors Links Fixed (PR #6314). The "Settings โ†’ Connectors" links now use admin_url( 'options-connectors.php' ) โ€” the old admin.php?page=connectors target isn't a registered page.

  • ๐Ÿงช Post-K16 Singles (PR #6327, CI run 91942465749). Order-dependent singles closed: transcript session-key mock restore, shared tool-registry teardown (Pro OKF tools were wiped by clear_tools()), Site Health provider-key isolation, transcript-mining logging cache reset. The mcp-ai-wpoos-test-suite skill grew to 40 patterns.

  • ๐Ÿ“š New Coding-Time Skill (PRs #6323, #6324). .agents/skills/mcp-ai-wpoos-updates/ codifies the two maintenance tracks โ€” docs & release catch-up (Track A) and model catalog & config updates (Track B). Coding-time agent skills: 53 โ†’ 54.

โœจ What's New at a Glance (v1.1.70)

  • ๐Ÿ›ก๏ธ Shell-Call Hardening on exec-Disabled Hosts (PR #6295). The Pro Packages page (and five other Pro admin pages + the OCR service) fataled on hosts with exec in disable_functions โ€” on PHP 8+ @ cannot suppress the disabled-function Error. Canonical wp_mcp_ai_check_nodejs_available() / wp_mcp_ai_get_nodejs_version() helpers probe exec-first and fall back to WP_MCP_AI_Process_Service (proc_open); the OCR service gains is_cli_tool_available() / run_cli_command() (Windows-aware) and guarded proc_* calls; seven CPT/settings pages clamp negative inputs with max( 0, โ€ฆ ) instead of absint() (absint('-5') โ†’ 5).

  • ๐Ÿ› Wave-5 Production Fixes (PRs #6280โ€“#6312). Transcript attachments display metadata preserved on save + default max_tokens capped by the model's window (#6280); Pro dashboard event stats accept underscore and dashed slugs (#6281); validated web_search profession_tags aligned (#6282); schedule presets drop a phantom validate_contact_data step and put the hook in schedule_data (#6283); mesh peer URLs validated before esc_url_raw() (#6285); opt-in guest memory capture writes under a shared guest bucket (#6286); JetEngine gates require JET_ENGINE_VERSION + a physical CCT-table probe, the JFB submissions tool restores id/flat params, and the token manager uses the cached Pro tool map (#6296, #6300); complexity routing restored โ€” the default model no longer short-circuits select_model() (#6298); Auth0 audience validation is structural, image tools check read_post against the acting user, and user IDs validate as positive ints (#6301, #6305); markup REST errors return 400, the legacy SSE handshake is filterable, skill packs reject numeric-keyed entries and always fire their installed action (#6302); clamp sanitizers + plugins-integration terminate seam (#6303); Elementor is_elementor_editor_init() + static::is_available() (#6304); provider-prefixed model-slug token limits, Ollama native tool-calls fix, published_date preservation, wp_mcp_ai_missing_image (#6306); agentic events reach the recent-activity feed + millisecond trace durations (#6308); K16 bundle โ€” sanitize_key-stable webhook IDs, settings-repository blob fallback for runtime gates, acting-user chart unfiltered_html, social-publish date reset, PSO inflections, site-builder h1โ€“h6, schema-verifier required (#6311); curriculum exporter skips empty structures (#6293).

  • ๐Ÿงช PHPUnit Repair Campaign, Wave 5 (~29 test PRs, #6280โ€“#6312). Two CI triage runs (CI-TRIAGE-91006542428.md + CI-TRIAGE-91771001271.md) drove the clusters closed: transcripts, charts/dashboards, professions, presets, Cloudflare, mesh, memory, CPT management, PayHere, Mubert, OpenAI Images, composer drift, Content Graph AI, pro schedule AJAX, model routing, Gemini, JetEngine/Graphify stubs, OAuth, REST/skill packs, admin settings, Elementor, permission gates, HTTP clients, orchestration budget, logging, K16 misc singles. The mcp-ai-wpoos-test-suite skill's cluster board is compacted to one completed wave-5 block (37 patterns unchanged).

โœจ What's New at a Glance (v1.1.69)

  • ๐Ÿ‘๏ธ Vision Analysis Toolkit (Pro, PR #6267). analyze_image_objects detects and counts objects per category โ€” detection (HuggingFace OWLv2 / Ollama vision), vlm (OpenAI / Anthropic / Gemini JSON-enforced counting), and hybrid (detector owns counts, VLM only renames mislabeled categories) โ€” with annotate=true returning a GD box-annotated copy as a media attachment. Gated by a new NV oOS โ†’ Vision Analysis settings page (enable_vision_analysis_toolkit, off by default) with SSRF URL-guards. See docs/toolkits/vision-analysis-toolkit.md + docs/proposals/vision-analysis-object-counting-tool.md. Pro tool count +1.

  • ๐Ÿ› tagDiv Admin Compat & Metabox Crash Fix (PRs #6266, #6278). The four SiteKit tools no longer return the non-existent CAPABILITY_CAN_USE_IF_ADMIN constant (string flag arrays; the assistant tools metabox crashed exactly at sitekit_get_adsense on nugl.com). The sortable shim prints a bundled jQuery UI 1.14.2 Sortable inline whenever td_wp_admin is enqueued (print-queue detection); the WordPress media chain is forced as direct head tags from core-registered handles; tools metabox CSS is enqueued in the head.

  • ๐Ÿ”ง DeepSeek Empty-Schema 400 Fix (PR #6272). Argument-less tools now emit properties: {} (never []) across 29 files; LegacyToolAdapter preserves object maps and upgrades empty arrays; the AI Tool Builder scaffold emits new stdClass() for parameterless tools.

  • ๐Ÿ”’ ZipSlip Guard Revived (PR #6270). ZipArchive::$num_files doesn't exist on PHP 8.x, so the guard loop never ran โ€” unsafe archives imported successfully. count( $zip ) now drives all five entry loops (OKF bundle manager + four Pro admin pages), restoring path-traversal rejection.

  • ๐Ÿ› Fixes. Rate limiter classified by the dispatching request's real HTTP verb with a separate nefarious-monitor counter and dual-shape chat hook tolerance (#6265); one broken tool's shortcut tasks can't fatal the assistant edit screen (#6271); model catalog: gpt-4o 128k context, gemini-2.0-flash video-capable typo, claude-sonnet-4-6/gpt-4o active status, two Qwen entries (#6274); settings save no longer leaves object-cache additions suspended (WP 7.1 inline-async tick locks, #6277).

  • ๐Ÿงช PHPUnit Repair Campaign Continuation (~9 test PRs, #6260โ€“#6276). Fourth wave: count-tokens params, continuation seam, SSE handler, deterministic cache tests, coverage manifest, incorrect-usage notices, admin registration, subtab sanitizers, 14 Veo suites. The mcp-ai-wpoos-test-suite skill now distills 37 root-cause patterns.

โœจ What's New at a Glance (v1.1.68)

  • ๐Ÿงฉ Pro SPA v2 Shortcode & Embedded Mode (Pro, PR #6256). New [nvoos_pro_spa] shortcode mounts the Pro SPA v2 in chat-first embedded mode โ€” AgentPanel + drawers, tool shortcuts, OKF drawer, router-free, no admin routes โ€” with per-instance data-config attributes and optional guest mode via the base guest-token machinery. New WP_MCP_AI_Pro_SPA_Shortcode + Pro_SPA_Config + module-registry entry + spa-v2 block. See docs/project/proposals/033-pro-spa-v2-shortcode-proposal.md.

  • ๐Ÿ–ฅ๏ธ Hermes Dashboard Fleet Extensions (PR #6249). New top-level extensions/ tree: a fleet monitoring + control plane extension (nv-oos-fleet โ€” Python plugin API over ~35 sites), plus backup-download, external-app-tab, and mcp-tool-shortcuts WebUI extensions with installer + smoke tests. Plans: docs/developer/integration/hermes-dashboard-extensions-plan.md.

  • ๐Ÿ”„ Chat-Bubble Stale-Nonce Self-Heal (PR #6225). GET /mcp-ai/v1/session/nonce returns a fresh session-bound wp_rest nonce minted from the request's own auth cookie (no-cache); the chat client silently retries 403 rest_cookie_invalid_nonce failures from full-page caching or session-token rotation on long-lived SPA pages.

  • ๐Ÿ“š Docs Hub 0.4.2 (PRs #6246, #6253). Internal links on local pages resolve to #/slug hash routes; TOC anchors mirror github-slugger exactly; "Accept fix" suggestions are directory-relative and ../ links are validated with containment checks; skipped rows show reasons; sync failures surface "Atomic swap failed"; the emoji loader no longer crashes the React SPA. Addon bump 0.4.1 โ†’ 0.4.2.

  • ๐Ÿ”Œ Providers Disabled by Default on Fresh Installs (PR #6255). OpenAI/Anthropic/Gemini default to disabled; dropdowns list only enabled + credentialed providers; the onboarding wizard auto-enables the provider whose key you enter.

  • ๐Ÿ› Fixes. Google Calendar granted-scopes %20 corruption (#6226); Tiptap mergeAttributes prototype pollution โ€” canvas/document editor pin tiptap 3.30.4 (#6250); fast-uri >=4.1.4 across npm trees (#6244); assistant untrash restores the pre-trash status (#6239); presets gain missing Google/Gmail/Drive/OKF/git tools (#6242); wp_mcp_ai_seed_task_templates AJAX wired (#6243); jQuery UI sortable shim for post screens (#6258); agent-identity canonical-ID int cast (#6232); token-budget catalog dedup + restored wp_mcp_ai_model_tpm_limit filter seam (#6233).

  • ๐Ÿงช PHPUnit Repair Campaign Continuation (~21 PRs, #6224โ€“#6257, + #6259 merged upstream). A third wave kept the suite aligned with current contracts; the production fixes it carried are grouped above (including the late-merged wp_mcp_ai_attachment_segment_provider filter โ€” providers without a remote file API, e.g. Ollama, resolve attachments to local references).

  • ๐Ÿงน Housekeeping. Stale 1.1.67 build ZIPs removed (27 files).

โœจ What's New at a Glance (v1.1.67)

  • ๐Ÿงฉ Content Graph AI Platform v2.0.0 Standalone (PR #6123). The extracted nvoos-content-graph-ai-platform addon now carries its own business logic โ€” Waves Aโ€“C + Blueprints deliver the namespace-bridged admin UI (PlatformDashboard, PlatformSettingsRegistry), skill/slash-command/agent bridges, harness router, a 74-skill bundled-skills pack with third-party notices, a knowledge base, and a dedicated PHPUnit matrix. See docs/project/plans/content-graph-platform-extraction-plan.md.

  • ๐Ÿงฑ Base+Pro โ†’ Content Graph Ecosystem Port, Wave D + D-UI (PR #6142). The AI runtime lands in nvoos-content-graph-ai: chat core (optimizer, caches, rate limiter, summarizer, threads, attachments, transcripts, ChatKit), providers (Zai, Google Maps, Realtime ร—3, RabbitMQ, STDIO, file services), model management + analytics/token tracking, security guards, and D-UI assistant pages + blocks/widgets/guest tokens/memory/CLI/MCP JSON-RPC. Content Graph AI bumps to 1.0.4. Tracked in docs/project/ecosystem-port-tracker.md.

  • ๐Ÿ“ง Google Workspace Gmail + Drive Read Tools (Pro, PRs #6151โ€“#6152). Six new Pro tools โ€” get_gmail_message, get_gmail_thread, list_gmail_connections, modify_gmail_message (destructive-ops gated) and get_drive_file, list_drive_connections โ€” backed by new WP_MCP_AI_Pro_Gmail_Client / WP_MCP_AI_Pro_Google_Drive_Client clients on the shared includes/google/ foundation. Pro tool count +6.

  • ๐Ÿงช PHPUnit Repair Campaign Continuation (~100 PRs, #6114โ€“#6208, #6209โ€“#6222). A second cluster wave kept the suite green through the extraction/port work and PHPUnit 11 / WP 7.1 drift; the production fixes it carried are grouped in the changelog (crawler contract hardening, REST guards, LLM sanitization delegation, URL-encoded external-API queries, Veo 5s floor, settings/cache fixes, WhatsApp webhook signature rejection, HTTP 304 cached-body re-serve, Veo async-job completion ordering, token-budget display, Shopify client-availability filter seam, Paper Store array-field queries). The mcp-ai-wpoos-test-suite skill now distills 26 root-cause patterns.

  • ๐Ÿงน Housekeeping. Stale 1.1.66 build ZIPs removed; re-created 1.1.65 ZIPs re-removed.

โœจ What's New at a Glance (v1.1.66)

  • ๐Ÿงช PHPUnit Suite Repair Campaign (~100 PRs). The single-process suite was repaired cluster-by-cluster โ€” REST endpoints, AJAX handlers, provider/client suites, admin pages, chat/channel integrations, CRM, professions/teams, multi-agent orchestration, cron/notifier, federation, healthcare interop, security, logger, transcripts. Most PRs are test-only; the production fixes they carried are grouped in the bullets below. (PRs #6008, #6009, #6012โ€“#6107)

  • ๐Ÿ” REST, Auth & Permissions. Assistant-access caching โ€” new wp_mcp_ai_assistant_access_cache_enabled filter plus WP_Error caching like successful lookups (#6008); attachment-segment validation errors return explicit 400s (#6009); token-tier endpoint + tier-change audit logging (#6018); permission-callback allowlist refresh (#6019); bearer-auth context sync (#6014, #6016); REST analytics endpoints (#6015).

  • โฑ๏ธ Job Queue, Cron & Notifier. Closure serialization fixed for legacy option storage (#6020); custom-table query guards against missing schema (Graphify DB, job store, tenant DB) end the 1.5K-line CI error-log flood (#6022); restored notifier update_status() with dot-preserving job IDs + owner-scoped REST routes (#6036, #6037); job status promoted to running on progress updates (#6039); Little's-law metrics (#6038).

  • ๐Ÿค– Provider, Tool & Envelope Fixes. Web-search result building restored for Exa/Perplexity (#6042); auto-categorize router/client (#6064); Cloudways analytics adapter auth check (#6062); Media Toolkit tools normalized to WP_Error (#6057); Remove Background path guard + source resolution (#6072); memory-capture failure envelope restored (#6049); A2A webhook logging + delegate tool errors (#6055).

  • ๐Ÿ–ฅ๏ธ Admin, Render & Output. Output-buffer leaks fixed across render/AJAX paths (#6045); Graphic Editor Plus image access on WP 6.9+ (#6069); workflow-editor AJAX WP_Error/hook drift (#6070); quiz + document-template admin pages wired (#6089, #6090).

  • ๐Ÿ‘” Professions, Federation & Addons. Profession meta clamping + primary-role flow, team CPT sanitization (#6043, #6105); federation mesh-sync init (#6044); defensive Graphify admin loading on the PM submenu (#6106); Content Graph AI bumped to 1.0.3 with a permission-check fix (#6056).

  • ๐Ÿ“š New Coding-Time Skill. mcp-ai-wpoos-test-suite โ€” Docker commands, CI-log triage, 16 recurring root-cause patterns, and the cluster-PR conventions; coding-time skills now 53. (PR #6108)

  • ๐Ÿ’ณ Checkout API Addon + Content Graph Paid Checkout. New addons/checkout-api/ (v0.1.0, vendor-server only) โ€” Stripe session/verify endpoints, encrypted secrets, custom-table license store, signed expiring ZIP downloads, webhook license issuance/revocation, per-IP rate limiting โ€” plus the paid-checkout client in the free nvoos-content-graph plugin (Stripe Payment Element, verify, license, one-flow install; no Stripe keys in the plugin). Addon count: 27. (PR #6063)

โœจ What's New at a Glance (v1.1.65)

  • ๐Ÿง  OpenAI Reasoning-Model Parameter Fix. o-series and gpt-5 models reject max_tokens (and o-series temperature) โ€” lib/core's OpenAiCompatibleClient now strips unsupported parameters per model (applyModelConstraints()) and retries 400 rejections with corrected payloads on both sync and streaming paths. (PR #5985)

  • ๐Ÿ•ท๏ธ Media Worker Full-Crawl4AI Proxy (031 Phase 3). New env-gated POST /api/crawl/full + GET /api/crawl/full/task/:id routes forward to a CRAWL4AI_FULL_URL deployment โ€” SSRF-validated targets before proxying, token-gated, 503 service_not_configured/502 upstream_unreachable envelopes โ€” plus a strict-path TEMP_ROOT allowlist (proposal 028 Q5) for Docker shared-volume deployments. Worker stays v3.2.0. (PR #5983)

  • ๐Ÿ›ก๏ธ Security-Posture Findings Closed (issue #5972). Algorave Tone.js raw eval now requires one explicit confirmation per browser session plus a visible warning banner (capability-scoped); the TMA markdown source map is removed; remaining webhook __return_true permission callbacks carry justification comments. SECURITY_POSTURE.md updated. (PR #5981)

  • ๐Ÿ’ฌ Chat, REST & Transcript Hardening. Legacy clients sending a top-level attachments parameter are tolerated instead of hard-400'd; custom message roles work again (wp_mcp_ai_allowed_message_roles); orphaned tool messages are silently discarded before provider dispatch; attachment prep errors propagate to the client; transcript pagination preserves negative values so clamping works; Content Graph AI embeddings stop 500ing and graph context falls back to keyword search without an index. (PRs #5991, #5993, #5994, #5985)

  • ๐Ÿ”” Webhook & Tool Fixes. Google Chat gains a shared-secret verification_token for OIDC-disabled webhooks; Slack link/italic conversion ordering fixed; paper-store import/export tolerate missing collection; scheduled-result block registers idempotently; Graphify treats provider-prefixed *_key fields as sensitive and returns canonical WP_Errors; remote_wp_connection errors direct callers to list_connections first. (PRs #5990, #5986, #6003)

  • โš™๏ธ Slash Commands, Blocks & Admin. Slash-command handler staleness on init re-fire fixed; CSV list parsing accepts "1,2" and "1, 2"; assistant-builder/Pro toolkit blocks register idempotently (WP 7.1 notices); workflow AJAX double-output fix; TPM limits fall back to the bundled model catalog without JetEngine; dangling legacy admin settings removed; WP 7.0 connector registry guard. (PRs #6000, #5997, #6004, #6005, #6006)

  • ๐Ÿ“ฆ Content Graph wp.org Refresh. Icons (v5), main screenshot, and a generated page preview for the nvoos-content-graph listing; Contributors field fixed; Content Graph AI chat tester fixed. (PRs #5980, #5988, #5982, #5992)

  • ๐Ÿงช Test-Suite Cluster Fixes. SSE stream-contract alignment, WP 7.1 bootstrap neutralisation, transcript/slash-command/remote-connection suite follow-ups. (PRs #5995โ€“#5999, #6001, #6002)

โœจ What's New at a Glance (v1.1.64)

  • ๐Ÿ“… Google Calendar Connection & Shared Google Services. New includes/google/ foundation (OAuth service, Calendar v3 client, scope registry, credential resolver, sync + push) replaces four copy-pasted and drifted Google OAuth flows; a google_calendar connection type lands on both connection surfaces. Six new Pro tools in addons/pro/includes/tools/google-workspace/ โ€” list_google_calendars, list_google_calendar_events, update_google_calendar_event, delete_google_calendar_event, check_google_calendar_availability (freeBusy), quick_add_google_calendar_event โ€” plus a reworked create_google_calendar_event (scope-enforced writes, Meet links) and a sync_google_calendar that actually syncs. See docs/developer/architecture/integrations/google-calendar-connection.md. (PR #5959)

  • ๐Ÿ”ฌ Composio Account Health & Hardening (Pro). A verified account-health engine probes live credentials with catalog-discovered read-only tools (no invented slugs), a new composio_manage_accounts tool handles validate/reconnect/delete/prune, and the Remote Sites Connected Apps table gains a Health column with Verify/Reconnect actions. Auth config resolution, connected-account listings, identity-bound execution, app removal, zero-argument payloads, and proxied provider failures are all fixed. See docs/composio-connect.md. (PRs #5932โ€“#5934, #5936, #5953, #5958)

  • ๐Ÿ•ต๏ธ Non-Loggable Result Fields. Tools whose results carry capability credentials under innocuous keys (or opaque URL path segments) can declare the exact fields via the new WP_MCP_AI_Tool_Sensitive_Result_Interface; the logger masks them before preview truncation. Logging-only โ€” caller/model payloads are never altered. (PR #5961)

  • ๐Ÿ“‰ Log Hygiene. Per-entry context budgets (fingerprinting + truncation) stop wp_mcp_ai_recent_errors/wp_mcp_ai_recent_activity from ballooning into the megabytes; Data Management gains one-click Compact/Delete for both buffers; credential-bearing URL query params are redacted from every logged string. (PRs #5952, #5954)

  • ๐Ÿ› Fixes. Validated-tool argument validation restored on Symfony 5.4 (constraint loading was silently skipped โ€” every validated tool accepted invalid input); MCP JSON-RPC -32700/-32600 error envelopes reachable and the diagnostics page re-wired; Pro SPA v2 conversation/assistant sync; vision tools accept a 5โ€“300s timeout; WP_Error envelope drift + cron/memory/elementor tool bugs. (PRs #5957, #5960, #5962, #5964, #5965)

โœจ What's New at a Glance (v1.1.63)

  • ๐Ÿงฌ Artifact Evolution Phases Aโ€“G (Base + Pro). The Continual Harness Evolver and Meta-Harness become a complete, gated, Darwinian evolution loop for skills, prompts, and roles: competing artifact populations with fitness-weighted parent selection, failure-case replay + post-mutation verification, learning-log-aware mutators, a pre-commit admission gate (structural / harmlessness / marginal-gain critics), holdout-gated deployment with shadow A/B serving and drift-triggered rollback, and a cross-cutting governor with a human approval queue and per-artifact lineage graphs. The evolve_harness โ†” Evolver contract is repaired, and every layer is opt-in (default off) with switches in Settings โ†’ Orchestration Layer. See docs/project/proposals/007-artifact-evolution.md. (PRs #5923, #5925)

  • ๐Ÿงฉ Pro Addons Page (Pro). New registry-driven NV oOS Pro Dashboard โ†’ Addons page installs and activates standalone addons whose ZIPs ship in the plugin's build/ directory in one click โ€” nonce + install_plugins + allowlist gated, with non-WordPress components (Media Worker, Cloud Worker, Tenant Router, Schedule Anything SPA) listed read-only. (PR #5924)

  • โšก Chat Storage Worker Offload. Conversation saves at or above wp_mcp_ai_storage_worker_threshold (default 10,000 chars) offload the expensive JSON.stringify to a browser storage worker; small saves, unload flushes, and worker failures fall back to the synchronous main-thread write, and the threshold filter is the kill switch. See docs/project/proposals/032-chat-web-workers-wiring-implementation-plan.md. (PR #5928)

  • ๐Ÿ› DeepSeek Empty-Schema Fix. Empty tool-schema property maps now encode as {} (never []) at all three payload boundaries, fixing DeepSeek 400s; legacy tools are wrapped before the first register attempt so the fail-loud registry log only fires for genuinely unregisterable classes. (PR #5926)

  • ๐Ÿ“š OKF Skill-Knowledge Conformance. All 91 bundled SKILL.md files gained the OKF v0.2-required type: Skill frontmatter and the four missing cross-linked reference files were restored โ€” the OKF Validate tab no longer reports missing concepts. (PR #5919)

  • ๐Ÿงช Test-Suite Exit Traps. New bin/sweep-tests.php sweeps every test file in parallel to surface exit-trap and drift failures; AJAX test contracts land in the bootstrap and 24+ test files align with the catchable-die/admin-handler contracts. Minimal production fixes: bare-exit test seams, duplicate CRM workflow-rule class rename, toolkit MCP scope check + nvoos:// resource URIs, SSE/Veo polling-limit filters. (PR #5929)

  • ๐Ÿ”ง Pro SPA v2 Slash Commands. /chat, /new, /clear, /copy, /export now insert reliably from the slash-command drawer. (PR #5920)

โœจ What's New at a Glance (v1.1.62)

  • ๐Ÿ“š OKF Bundle Management (Base). New WP_MCP_AI_OKF_Bundle_Manager gives OKF knowledge bundles a full lifecycle โ€” create, list, rename, archive, delete, ZipSlip-safe ZIP import/export, and health statistics โ€” with the auto-generated skill-knowledge bundle protected from writes. Three new tools (okf_list_bundles, okf_validate_bundle, okf_import_bundle) join the extended okf_write_concept provenance schema (resource/sources/usage_window/verified), and a new OKF Bundle Manager admin screen (Bundles / Browser / Editor / Import-Export / Validate) mirrors the Skill Manager UX. See docs/features/okf-integration.md.

  • ๐Ÿ”— OKF โ†’ Skill Bridge (Pro). load_skill now resolves bundle:concept_id names into OKF concepts as loadable skills, gated per assistant (grant metabox, fail-closed), lifecycle (drafts rejected), and an optional minimum trust tier.

  • ๐Ÿค– OKF Auto-Enrichment & Hybrid Knowledge Router (Pro). The enrichment agent crawls published site content (posts, pages, taxonomy terms) into OKF concepts with cross-links โ€” deterministic and idempotent, AI summaries opt-in via filter โ€” while route_knowledge_query classifies questions across OKF / vector / Paper stores and performs the OKF lookup when it is the primary route.

  • ๐Ÿงญ OKF Skills Drawer in Pro SPA v2 (Pro). A new read-only mcp-ai-pro/v1/okf REST surface (bundles, concept browse/search, assistant skill grants) powers an in-chat OKF drawer: browse bundles and concepts and reference them from the conversation without leaving the chat surface.

  • โšก Vector Store Tools on the Responses API. OpenAI removes the Assistants API on 2026-08-26 โ€” all vector-store operations now run headerless on the Responses API with file_batches ingestion (bounded polling + single-file fallback); list_vector_store_files gains filter, search_vector_store gains ranking_options. Fixed: 404s on percent-encoded OKF concept routes (%2F now decoded).

โœจ What's New at a Glance (v1.1.61)

  • ๐Ÿง  Agent Identity Bridging in Memory Store & Recall. New WP_MCP_AI_Agent_Identity_Resolver (includes/services/) resolves virtual agent keys (e.g. nvoos-pro-spa-memory-drawer, virtual_planner_1) to the canonical assistant post ID when storing agent context; chat-memory recall merges every alias bucket with per-record stored_under stamps. Memory drawers (base, chat-spa, pro-spa) show wing/room/stored-under chips, an agent-ID diagnostic, a show-all-scopes toggle, and refresh automatically on store events; graph-bridge and scoped-recall failures degrade gracefully. See docs/features/memory/chat-client-integration.md.

  • ๐Ÿ“š OKF Skill-Knowledge Bundle Generator. The skill-knowledge OKF bundle is now auto-generated from bundled skills on bootstrap (and refreshed after bundled-skill reinstall) โ€” okf_search and the other OKF tools work out of the box instead of failing with "OKF bundle not found: skill-knowledge". (PR #5911)

  • ๐Ÿ”ง undici ^7.29.0 jsdom Compatibility. The undici override is pinned to 7.29.0 โ€” jsdom 29.1.1 breaks on undici 8, which had vitest suites failing in seven addons; all CVE fixes are retained. (PR #5910)

  • ๐Ÿ“ฆ nvoos-content-graph wp.org Review Reply & Report shipped and excluded from distribution ZIPs; content-graph CI checksum sync fixed. (PRs #5912, #5906)

โœจ What's New at a Glance (v1.1.60)

  • ๐Ÿ”’ Restricted-User Flagging & Unblocking. Ephemeral rate-limit and token-budget blocks become persistent, reviewable restriction records with auto-expiry and audit logging โ€” one-click lift on the Token Manager "Restricted Users" panel (Base), a full Restrictions tab on the Pro Command Center, REST/AJAX/WP-CLI operations (wp mcp-ai restrictions list|lift|add), IETF rate-limit response headers, and filterable chat rate limits (wp_mcp_ai_chat_rate_limit / wp_mcp_ai_chat_rate_limit_window). See docs/features/security/user-restrictions.md. (PR #5901)

  • ๐Ÿ“ฅ Conversation Import to Transcript CCT (Full, JetEngine). New includes/conversation-import/ subsystem imports ChatGPT, Google Takeout Gemini, Claude, ShareGPT, and OpenAI fine-tuning JSONL exports into the JetEngine ai_chat_transcripts CCT โ€” four new tools (conversation_import_detect|run|status|delete), an admin upload/preview page, WP-CLI, GDPR export/erase, and optional memory mining. See docs/user-guides/conversation-import.md. (PR #5898)

  • ๐Ÿงฉ Tool Schema Normalization. Tool argument schemas are normalized before provider payloads (DeepSeek client, REST /tools output, Tool Service, ChatOrchestrator), preventing provider streaming errors; the registry logs registrations skipped for a missing tool contract. (PR #5903)

  • ๐Ÿ› WP_Error Fatal Fixes in the memory layer and REST chat-memory paths (mine_agent_memory, retrieve_agent_memory, wake_up_context, request guard). (PR #5905)

  • ๐Ÿ“ฆ nvoos-content-graph v1.0.3 โ€” wp.org resubmission with WPCS/review fixes and .wordpress-org screenshot assets. (PRs #5897, #5899, #5904)

โœจ What's New at a Glance (v1.1.59)

  • ๐Ÿ•ท๏ธ Media Worker Crawling & Crawl4AI Facade (v3.2.0). New /api/crawl/* endpoints โ€” single-URL Markdown, batched crawling (sync or queued async), and link scans โ€” with a two-tier extraction pipeline (static Readability โ†’ Turndown first, hardened Chromium fallback) behind the shared SSRF guard. A Crawl4AI-compatible facade lets the plugin's run_crawl4ai_job remote mode target the worker directly, with LLM-based structured extraction. Toolkit memory estimate now accounts for the worker sidecar. See docs/project/proposals/031-media-worker-crawl4ai-integration-plan.md. (PR #5892)

  • ๐Ÿ” Research Tools Multi-Provider Hardening. semantic_content_search resolves embeddings through the shared provider abstraction (OpenAI, Gemini, Ollama, DigitalOcean) independent of the chat provider, falls back to keyword search, and skips mismatched-model vectors; new Gemini embedding provider. deep_research retries empty/truncated completions across the provider chain and never caches empty reports. Two new read-only base tools: list_terms and list_taxonomies. (PR #5893)

  • ๐Ÿ“š Docs Hub Rebuild & Broken-Link Fixes. The plugin updater now fires wp_mcp_ai_plugin_updated after in-place updates; Docs Hub 0.4.1 auto-clears the cache and enqueues an async rebuild (plus an admin_init version-mismatch guard). Broken-link detection resolves links against the slug map, and suggestions are case-insensitive with clamped confidence. (PR #5894)

  • ๐Ÿ”ง Tool Registration Fixes. Legacy-format tool classes are auto-wrapped, ~32 previously-orphaned base tools are now registered, and the new wp_mcp_ai_tools_init action gives side-loaders a late registration point. QA container memory limits raised. (PR #5895)

โœจ What's New at a Glance (v1.1.58)

  • ๐Ÿ”Œ Composio Connect (Pro). New addons/pro/includes/composio/ subsystem bridges WordPress to the Composio MCP gateway: OAuth connection flow with state nonce, API client, trigger bridge, and signed webhook controller. Six new beta tools โ€” composio_list_tools, composio_get_tool_schema, composio_list_connected_accounts, composio_create_connect_link, composio_execute_tool, composio_manage_triggers โ€” plus remote-sites admin and metabox panels. See docs/composio-connect.md. (PR #5889)

  • โš™๏ธ OOS Runtime Consolidation (Phases 0โ€“5.8). The OOS engine now reaches parity with the legacy path โ€” tool-surface and security-gate parity, an event-sourced session log, opt-in shadow mode (parallel parity runs serving the legacy result, zero user exposure) with wp mcp-ai oos parity CLI, canary routing per assistant, scoped tools with a compaction seam, Pro composition & child binding (wp mcp-ai composition), and single-path telemetry. See docs/project/proposals/029-oos-orchestration-runtime-consolidation-implementation-plan.md. (PR #5881)

  • ๐Ÿท๏ธ Standalone Plugins Renamed to Content Graph. plugins/nvoos-graphify โ†’ nvoos-content-graph, nvoos-graphify-ai โ†’ nvoos-content-graph-ai, nvoos-graphify-ai-platform โ†’ nvoos-content-graph-ai-platform (v1.0.2) with matching workflow and build-script renames. The addons/graphify/ knowledge-graph addon is unchanged. (PR #5890)

  • ๐Ÿ› Security Center Refresh Fix. wp-api script now enqueued on the security tab โ€” posture refresh, IP tests, snapshot restore, compliance export, and self-test no longer throw apiFetch is not defined. (PR #5887)

  • ๐Ÿ”’ deepmerge-ts CVE-2026-40345 overridden in the media-worker and Pro packages. (PR #5888)

โœจ What's New at a Glance (v1.1.57)

  • ๐Ÿ”„ Plugin Updater Rework. New base-only update flow for wp.org base installs (check + in-place install via the GitHub base package; new "Base Version" panel in Settings โ†’ Advanced). Installation no longer uses Plugin_Upgrader โ€” updates are copy-in-place with a backup snapshot and automatic rollback, so ZIP top-level folder-name mismatches can't break updates. Pro version now read from the plugin header (get_pro_installed_version()), fixing drift in the admin page and wp mcp-ai pro status. (PR #5871)

  • ๐Ÿค– Hermes Chat โ€” Async Submit/Poll. hermes_chat now submits via /api/chat/start and polls /api/chat/stream/status โ€” runs keep executing server-side if the MCP client drops, timeout expiry returns still_running + stream_id, and the approval gate is answered with the configured HERMES_APPROVAL_MODE choice. Fixed answer extraction for live WebUI payloads. (PR #5872)

  • ๐Ÿ› Service Status Provider Detection. AI-provider detection now resolves credentials through WP_MCP_AI_Credential_Resolver (plugin settings, WP 7.0 Connectors, env vars, PHP constants) instead of raw settings keys; new 135-line test suite. (PR #5874)

  • ๐Ÿ“š Fleet Operator Agent Context. New addons/fleet-operator/.context/ tree (18 files) โ€” addon conventions, Hermes ops, MCP integration, 6 operator roles, and task/memory templates for operator-agent sessions. (PR #5873)

โœจ What's New at a Glance (v1.1.56)

  • ๐Ÿข Media Worker v3.0.0 โ€” Multi-Tenant Shared Worker Mode (v2.4.0). SITE_TOKENS per-site isolation (fail-closed auth, namespaced files/queues/rate limits), per-site rate-limit overrides, SITE_TOKENS_PREVIOUS rotation. (PR #5866)

  • ๐Ÿ”‘ Phase 2 โ€” Per-Site Provider Keys & Observability. SITE_PROVIDER_KEYS per-tenant AI provider credentials (with PROVIDER_KEYS_STRICT fail-closed mode), per-site usage counters, grouped temp TTLs, cluster-mode boot warnings, and a k6 load-test kit with split decision table. (PR #5868)

  • ๐Ÿ“ Phase 3 โ€” Scale Without Breaking Changes. Multisite per-blog worker tokens, plugin-side Media Worker Usage Reporter (opt-in daily cron), SITE_TOKEN_<SLUG> / SITE_PROVIDER_KEYS_<SLUG> env merges, opt-in Redis rate-limit store (RATE_LIMIT_REDIS=1), PROVIDER_KEYS_FILE hot-reload, manual Velocity deploy workflow. All opt-in โ€” defaults unchanged.

  • ๐Ÿ”„ Worker Routing Expansion. Document generation, OCR, video frames, health charts, email, QR/translate/PDF, and vectorization now route through the connected worker with local fallbacks; Pro settings lists worker-routed packages; new probe-wordpress.php connectivity probe.

  • ๐Ÿ” Rotation, Canvas v3, Cloudways. Zero-downtime token rotation (WORKER_API_TOKEN_PREVIOUS), Canvas v3 napi prebuilds (compiler-free installs), Cloudways readiness hardening, live route bug fixes. (PRs #5863โ€“#5865, #5867)

  • ๐Ÿค– Hermes Tooling. WebUI MCP server (bin/hermes-mcp-server.js) to drive a Hermes agent from Zed (sessions, synchronous chat, skill sync), SSH MCP bridge, hardened env-file parser, and the Zed Hermes Console profile. (PR #5862 + follow-ups)

โœจ What's New at a Glance (v1.1.55)

  • ๐Ÿ”ง MCP Agent Compatibility & Reliability. JSON-RPC errors now return HTTP 200 so agent SDKs that drop non-2xx bodies relay tool errors instead of hanging. New legacy HTTP+SSE transport with credential-bound sessions for SSE-only clients. Tool rate limiter is settings-driven with credential-token exemption; GET/HEAD no longer consume the request quota; raw cred_* authorization headers accepted; async tool polling bounded at ~45s with inline kick of stuck jobs. (PR #5859)

  • ๐Ÿš€ Hermes Fleet Operator Addon. New addons/fleet-operator/ โ€” scoped op_ operator credentials with audience binding, expiry, rate limits, and instant revocation so a supervisor agent (Hermes or any MCP/A2A host) can operate the site within an allowlist. Server-side tools/list scoping + tools/call enforcement. Ships admin page, WP-CLI commands, Hermes config generator, 3-skill nvoos pack, runbook, and tests. (PR #5858)

  • ๐Ÿ”’ Media Worker v2.2.0 Security Hardening. Timing-safe X-Site-Token auth, SSRF guard, sandboxed Puppeteer launcher, rate limiting, Helmet headers, split health endpoints, request logging, graceful shutdown. WP_MEDIA_WORKER_TOKEN constant support in the plugin sidecar. Cloudways Velocity deployment guide + CI. (PR #5857)

  • ๐Ÿ—„๏ธ Database Connection Pooling Stance (Proposal 023). RabbitMQ-aware gating of Action Scheduler fallback and DB polling cron, atomic concurrency-guard slot tracking (mcp_ai_concurrency_slots table + daily cleanup), PDO persistent connections in Graphify, configurable queue worker batch size, and Site Health checks for MySQL pool, queue depth, and RabbitMQ health. (PR #5855)

  • ๐Ÿ“ฆ PostCSS 8.5.26 (GHSA-6g55-p6wh-862q) and media-worker subtree sync workflow (PR #5856).

โœจ What's New at a Glance (v1.1.54)

  • ๐Ÿ”’ PostCSS CVE-2026-69153. postcss minimum bumped to 8.5.23 in package.json overrides across 2 addons. Resolves a high-severity CVE in the CSS post-processor chain. (PR #5850)

  • ๐Ÿ› MCP Async Tool Response Handling. tools/call endpoint now correctly handles async tool responses โ€” the response handler was dropping results for tools that return promises or deferred execution. +111 lines. (PR #5845)

  • ๐Ÿ”ง Plugin Updater Integrity Check v2. Follow-up hardening to the post-install integrity check (v1.1.52): fixed phantom bridge/ file false-positive from stat cache, cleared PHP clearstatcache() after each file check, and handled main-file rename edge case. (PR #5846)

  • ๐Ÿ”‘ API Key Merged-Settings Fix (Research Tools). deep_research, web_search, and 18 other research tools were reading API keys from the global option instead of the merged provider-specific settings. Now uses get_merged_credentials() so per-assistant and per-provider API key overrides take effect. 20 files, +37/-33 lines. (PR #5852)

  • ๐Ÿง  Design Skills Audit & Enhancement. All 22 design-* skills comprehensively enhanced with detailed operational instructions, cross-references, and tool-calling patterns. 7 new pro-toolkit skills created: design-ai-assistant-admin, design-crm, design-project-management, design-communications, design-services, design-team-management, design-vault, and design-security-ops. Total: 29 enhanced/created skills, ~8,000 lines of agent-facing content. (PR #5847)

  • ๐Ÿ“‹ OKF YAML Frontmatter Compliance. Added missing type: Skill frontmatter to all 22 design-* skills (PR #5844). Fixed YAML frontmatter spec compliance for 9 design skills โ€” removed duplicate/invalid top-level keys that violated the OKF v0.2 schema. (PR #5849)

  • ๐Ÿ“š README TOC Anchor Fixes. Fixed broken TOC anchor links caused by Unicode emoji rendering differences (VS16-based emojis like ๐Ÿชฒ๐Ÿ› and U+26xx/U+27xx symbols like โš ๏ธโšก) across GitHub's markdown renderer. (PR #5853)

  • ๐Ÿงน Stale Build Artifacts. Removed 30 stale v1.1.52 build artifacts from the repository. (PR #5851)

โœจ What's New at a Glance (v1.1.53)

  • ๐Ÿ“Š Shared Analytics Service. New unified analytics subsystem (addons/pro/includes/analytics/, 1,489 lines) consumed by all Pro toolkits. 7 platform adapters: Meta (FB+IG), Twitter/X, LinkedIn, TikTok, WooCommerce, Google Analytics 4, and Cloudways monitoring. 5 immutable DTOs (Account, Post, Metric, TimeSeries, Report). Cross-platform normalization maps platform-specific metric names to a unified schema. Smart caching with stampede prevention. Token-bucket rate limiter per platform. Extensible adapter pattern โ€” register new platforms via $service->register_adapter(). MCP server registration and Site Health integration. Design Stack skill: design-analytics-reporting. (PR #5836)

  • ๐Ÿ›ก๏ธ Circuit Breaker & Execution Pipeline Hardening. Circuit breaker protection added to all remaining AI provider clients โ€” now active on all 15 first-class providers with configurable failure thresholds. Concurrency guard, cost tracker, and backpressure signals wired into the execution pipeline. The agentic loop now auto-throttles tool calls when system load is high. Plugin updater base-only UI fix after complete upgrade. Silent build asset failure now surfaces a clear error. (PR #5839)

  • ๐Ÿง  Agent Skills Sync & Discovery. sync-agent-skills now syncs project-owned design-* skills alongside wp-* skills โ€” 22 new coding-time skills (design-analytics-reporting through design-video-creation) auto-discovered by the Zed editor. New mcp-ai-wpoos-plugin bundled skill. Base bundled skills increased from 45 to 67. (PR #5842)

  • ๐Ÿ”ง SSE Stream & Load Guard Fixes. SSE backoff counter now resets between successful stream reconnections. Rate-limit counter properly cleaned up after stream termination. Load Guard fatal error on PHP 8.1+ fixed โ€” no longer calls private count_active_jobs(). (PRs #5841, #5840)

  • ๐Ÿ“š Documentation Catch-Up. CHANGELOG v1.1.53 entry documenting all missing features (Shared Analytics, circuit breaker, skills sync). README, CLAUDE.md, AGENTS.md, and 6 .context/ files updated with current counts, review dates, and architecture details.

โœจ What's New at a Glance (v1.1.52)

  • ๐Ÿ“„ Paper Store Remote Site Support. All 8 Paper Store tools now accept an optional connection_id to proxy operations through Remote Site Manager. New REST API controller at mcp-ai/v1/paper-store (697 lines) enables remote CRUD. New WP_MCP_AI_Paper_Store_Remote trait handles dispatch. New list_mcp_tools discovery tool (234 lines) for AI agent self-discovery โ€” filterable by toolkit and search term. (PR #5835)

  • ๐Ÿ”Œ Remote Connection CPT Auto-Discovery. Plugin-registered custom post types (including paper_store) now appear automatically in remote connection post type access controls. No more manual slug entry. resolve_post_type_access() mirrors discovery logic on form submission. Multi-site gateway plan (1,429 lines) for hub-and-spoke federation targeting v1.5.0+. (PR #5834)

  • ๐ŸŽจ Design System Tool Preset. New design-system preset with 72 tools across 13 categories: WordPress content, image generation/analysis/processing, web search/research, charts, document generation (14 tools), Paper Store (8), video generation/processing, social media, AI/memory, and utility. (PR #5837)

  • โœ… Post-Install Integrity Check. Plugin updater now verifies 15 critical file paths after every update before reporting success. Prevents silent corruption on distributed filesystems (Cloudways). REST controller require_once calls now guarded with file_exists() checks. (PR #5833)

  • ๐Ÿ“š Documentation Catch-Up. 3 new feature docs: Paper Store, Remote Sites & Connections, MCP Protocol Version Negotiation. Updated: Tool Presets System (Design System preset), Plugin Updater (integrity check), DOCUMENTATION_INDEX, QUICK_REFERENCE, README, CHANGELOG.

  • ๐Ÿ› Fixes. Pro addon update visibility for wp.org base + standalone Pro (PR #5832). Docker chmod warning suppression (PR #5831).

โœจ What's New at a Glance (v1.1.51)

  • ๐Ÿ—๏ธ Orchestration & Harness Layer Gap Remediation. Comprehensive audit of AI orchestration and LLM harnessing against August 2026 industry standards (OWASP LLM Top 10, EU AI Act, NIST AI RMF, MCP/A2A protocols, OpenTelemetry GenAI). OWASP LLM Top 10 coverage: 20% โ†’ 60%. EU AI Act compliance: 17% โ†’ 67%. 6 new classes: Output Guardrail (OWASP LLM05 โ€” validates LLM responses for sensitive info/unsafe content), Citation Verifier (OWASP LLM09 โ€” cross-references claims against sources), Model Integrity Verifier (OWASP LLM03 โ€” supply chain security with blocked model list), Semantic Cache (two-tier: exact + embedding-based prompt caching), Canary Deployment (progressive model rollout with auto-rollback). Workflow Engine V2 graduated from feature-flag to GA. Red Teaming scripts (shell + PHP) for OWASP-aligned adversarial probes. 3 new docs: Orchestration & Harness Reference, EU AI Act Compliance Mapping, OWASP LLM Top 10 coverage matrix. (PR #5830)

  • ๐Ÿ”„ MCP Protocol Version Negotiation. Older clients (Zed, Claude Desktop, Cursor) rejected the hardcoded 2026-07-28 protocol version. Server now negotiates the highest version both client and server support, falling back to 2024-11-05 when the client provides no version information. 2 files, +123 lines. (PR #5829)

  • ๐Ÿ”’ Security Bumps โ€” Media Worker. multer 1.4.5-lts.1 โ†’ 2.2.0 (DoS vulns patched, 1.x deprecated). nodemailer 8.0.5 โ†’ 9.0.5 (GHSA-p6gq-j5cr-w38f raw bypass fixed). sharp 0.33.0 โ†’ 0.35.3 (libvips CVEs CVE-2026-33327 etc.). No code changes โ€” APIs are unchanged across all three bumps. (PR #5828)

โœจ What's New at a Glance (v1.1.50)

  • โš™๏ธ Media Worker Sidecar. Docker-based Node.js sidecar with 11 Express route handlers: browser (Puppeteer), code (sandboxed), data (ETL), document (generation), email (rendering), image (manipulation), ocr (Tesseract), pdf, social (cross-platform), video (transcoding), and workflow (pipeline orchestration). Queue module with concurrent processing and retry logic. Pro integration via WP_MCP_AI_Media_Worker_Settings + Media_Worker_Client trait for tool-to-sidecar communication. Docker DNS-to-IP loopback resolution for container networking. Pro services updated (Fluent FFmpeg, Language Detection, MJML, Nodemailer, OCR, Prettier, Video Frame Extractor). (PRs #5822, #5823)

  • ๐Ÿ› Site Health Redeclaration Fix. Fixed PHP fatal error from function redeclaration in ensure_site_health_dependencies() โ€” now guarded with function_exists(). (PR #5824)

  • ๐Ÿ”’ NPM Security Fixes. nanoid, js-yaml, and dompurify vulnerabilities resolved across 11+ addon package-lock.json files. (PR #5821)

  • ๐Ÿค– BMAD Agent Editing Conventions. Developer and QA agent YAMLs updated with code editing conventions for consistent agent behavior across sessions. (PR #5825)

  • ๐Ÿงน WPCS Formatting Cleanup. Repository-wide PHPCS fixes: tabs, docblock formatting, and code style corrections across all PHP files. No functional changes.

โœจ What's New at a Glance (v1.1.49)

  • ๐Ÿ”ง Gemini Model Resolution Fix. Gemini client now uses the correct settings key instead of the deprecated gemini-pro fallback. All model lookups routed through the canonical provider settings path. (PR #5817)

  • ๐Ÿ”„ Update Reactivation & Release ZIP Cleanup. Plugin updater now correctly reactivates after update. Nonce-scoped update actions hardened. Dev files (.agents/, .context/, .github/, IDE configs, test fixtures) excluded from release ZIPs via .distignore and .gitattributes. (PR #5816)

โœจ What's New at a Glance (v1.1.48)

  • ๐Ÿ›’ Shopify Sync Toolkit โ€” 7 Bug Fixes. Fatal error (graphql_query() โ†’ graphql()) on Admin API connection test. Dead code in list_by_status replaced with direct SELECT COUNT(*) query. Always-zero analytics count now uses actual API response edges instead of empty array. Duplicate get_option() call and redundant $sync_mode assignment removed. Infinite loop risk in truncate() eliminated โ€” paginated while-loop replaced with direct DELETE FROM {table}. Double DB query per upsert halved via by-ref &$operation output parameter. Missing orderby/order schema parameters added with sanitization passthrough. (PR #5815)

  • ๐Ÿ”’ PHPCS CVE-2026-67434. squizlabs/php_codesniffer bumped 3.13.4 โ†’ 3.13.6 across 3 composer.lock files. Resolves arbitrary code execution via crafted ruleset XML. Dev dependency only โ€” no functional impact.

  • ๐Ÿ“š Default Skill Catalogues. Brave Search Skills and all 22 WordPress Agent Skills added to the default skill catalogue for new assistants out of the box.

  • ๐Ÿ› ๏ธ NVoOS Graphify Standalone Plugins. 3 new standalone plugin ZIPs in plugins/ directory: Graphify v1.0.1, Graphify AI Platform v1.0.0, and Graphify AI v1.0.0.

โœจ What's New at a Glance (v1.1.47)

  • ๐Ÿ›ข๏ธ MySQL Connection Exhaustion Fix (Cloudways). Cron system overhaul with unified concurrency limits, per-process memory caps, and staggered offset scheduling to prevent connection-pool saturation. Activation bootstrap now uses connection throttling. Service status registry hardened. Pro status page JS, AJAX handler, and dashboard improvements. 7 files, +438/-89 lines. (PR #5809)

  • ๐Ÿ”„ Update Checker Cache Bust. Manual "Check for Updates" now clears cached release data and fetches live from GitHub Releases API. (PR #5810)

  • ๐Ÿ”’ Mermaid Security Fixes. npm audit fix in canvas-toolkit: mermaid 11.15.0 โ†’ 11.16.1 resolves 5 CVEs (prototype pollution, CSS injection, DoS). (PR #5812)

โœจ What's New at a Glance (v1.1.46)

  • ๐Ÿ’พ Comprehensive Backup & Restore (Proposal 020). 11 modular export providers (8 base + 3 Pro) with JSON-based export/import. Admin UI with provider checkboxes and progress feedback. Covers settings, assistants, CPTs, custom tables, federation, addon options, toolkit options, JetEngine CCTs, license keys, and remote sites. +3,660 lines. (PRs #5805, #5807)

  • ๐Ÿ”„ GitHub-Based Plugin Updater. New WP_MCP_AI_Plugin_Updater class fetches releases from GitHub API, installs via WordPress Plugin_Upgrader. Base-to-complete upgrade path in Settings โ†’ Advanced. Pro addon update support with rollback. Cache bust on manual check. +772 lines. (PRs #5800โ€“#5804)

  • ๐Ÿ”Œ Abilities API Selective Adoption (Proposal 019). New includes/abilities/ framework โ€” Registrar, Bridge, Category Registrar, and Security Bridge for machine-readable plugin operations with JSON Schema contracts. Tool-ability interface for MCP/AI agent discovery. 5 test files. (PR #5799)

  • ๐Ÿ“š 6 New Default Skill Catalogues. Brave Search Skills, WordPress Agent Skills, Cloudflare Agent Skills, Google Workspace CLI, OpenAI Agent Skills, and Google Agent Skills added to default skill catalogue for new assistants out of the box.

  • ๐Ÿ› Status Page Fixes. Fatal error in Pro status REST endpoint resolved. JS errors and i18n text domain consistency fixed on the status dashboard. (PR #5806)

  • ๐Ÿ“ฆ Knowledge Base Auto-Build. CI auto-builds knowledge-base.zip when playbook files change. (PR #5797)

  • ๐Ÿงน PHPCS Cleanup. Parse error fixes from canonical envelope conversion, text domain mismatch corrections, and WPCS formatting across 100+ tool files. (PRs #5798, #5804)

โœจ What's New at a Glance (v1.1.43)

  • ๐Ÿ”’ Security Hardening v1.1.43 (16 files). SSRF protection across 7 provider connection handlers + A2A agent URL. SQL table-name validation against injection. A2A per-assistant agent cards now auth-gated. Chat SPA /config and /manifest endpoints require authentication (no longer public). Missing args schemas on 7 REST endpoints. Guest rate-limiting now IP-based (DoS vector closed). 3 tool capability mismatches corrected. Centralized defense-in-depth capability gate in Tool Registry. PHP object injection prevention via safe_unserialize helper.

  • ๐Ÿ†™ MCP Protocol Upgrade (2026-07-28). Stateless core โ€” sessions retired, server/discover replaces initialize, _meta per-request capabilities, Mcp-Method/Mcp-Name headers on Streamable HTTP, TTL/cache-scope on tools/list. Legacy client shim for backward compatibility. 10 files changed.

  • ๐Ÿ“š OKF v0.2 Trust-Signal Support. Indentation-aware recursive descent parser with inline YAML mappings, nested object lists, and flow sequences. New trust-tier derivation (unverified/machine-confirmed/human-reviewed), staleness checks, search() extension with trust filters. New okf_validate_attestation tool. All 6 existing OKF tools surface trust signals. 15 files, 27 standalone smoke tests.

  • ๐Ÿ—๏ธ Pro Module Registry. wp_mcp_ai_pro_init() decomposed from ~625-line monolithic function into a PSR-4 module registry with per-module loading, dependency ordering, and graceful degradation. Fixes broken require paths in module loader.

  • ๐ŸŽฏ Ideal Customer Profile (ICP) System (Pro CRM Phase G). 7-dimension scoring engine (0โ€“100) with fit+intent separation, behavioral decay, and negative scoring. 2 new MCP tools: compute_icp_score, manage_icp_profile. Admin UI with profile list table and 7-tab editor.

  • ๐Ÿ”ง Profession & Playbook Sync Fixes (7 PRs). Playbook bulk sync silent failures now report errors. Force-regenerated playbook files no longer deleted. Undefined array key in playbook stats fixed. Duplicate profession slugs removed from knowledge base (312โ†’311 entries). Title fallback prevents duplicate posts on Update. Consumed-post collision fix ensures all unique KB entries create distinct posts. Test Model assistant dropdown restored.

  • ๐Ÿงน Hexagonal Architecture Purity. PlatformFlushInterface contract extracts wp_ob_end_flush_all from framework-agnostic lib/core/ SSE handler into a WordPress adapter โ€” zero WordPress references remain in nvoos/core.

  • ๐Ÿ›ก๏ธ Phase 3 Operational Security. Audit logger REST route hook corrected (init โ†’ rest_api_init). Security posture signals hardened.

  • ๐Ÿ“ฆ Dependency Updates. WPCS bumped to 3.4.1 (CVE-2026-45293). Dev tooling: Phpactor LSP replaces Intelephense.

โœจ What's New at a Glance (v1.1.42)

  • ๐Ÿ›ก๏ธ Security Infrastructure Hardening. 7 new security infrastructure classes (Request Guard, Security Posture with 21 signals A-F grading, Destructive Ops Gate, URL Guard, Concurrency Guard, Cost Tracker, API Key Store). Site Health integration. Production hardening guide. CORS, rate limiting, error verbosity, and body size enforcement with admin dashboard posture signals.

  • ๐Ÿ—๏ธ Framework-Agnostic Core (lib/core/). nvoos/core package โ€” Hexagonal Architecture with 32 domain contracts + 21 WordPress adapters. ChatOrchestrator with RateLimiter + SemanticCompressor. 109 tools migrated to framework-agnostic format. ProviderRouter with 12-provider routing. 5 chat parity gaps closed.

  • ๐Ÿ“ก Status Page & Incident Communication (Pro). Maintenance window system with frontend banner, countdown timer, and multi-channel notifications. Incident workflow with phase state machine, phase-aware dispatcher, and lesson bridge. 4 new AI tools for service status and incident management.

  • ๐Ÿค– Agent Skills & BMAD Agents. 21 coding-time agent skills for Zed editor covering WordPress plugin development patterns. 6 BMAD workflow agent YAML definitions with team composition config. Full .context/ subsystem context files with 8 topics + 5 templates.

  • ๐ŸŽต Algorave Addon. New live coding and algorithmic music generation addon with 9 tools, pattern/session CPTs, and REST API.

  • ๐Ÿ”’ Security Hardening (12 fixes). OAuth token lifetime controls, DICOM PHI auto-redaction, asset version stripping, exception guard, auth brute-force protection, SSE CORS filter, webhook secret indicator. 13 new security unit tests.

โœจ What's New at a Glance (v1.1.41)

  • ๐Ÿ“š OKF Integration (Open Knowledge Format v0.1). Google vendor-neutral knowledge format engine with 6 MCP tools for curated, deterministic knowledge management. All 41 bundled skills are now OKF v0.1-conformant.

  • ๐Ÿ”’ Security Compliance Fixes (11 HIGH/P0). HMAC-signed policy tokens for professional selector, health endpoint auth-gating, ZIP path traversal prevention, CSRF nonces on sync endpoints, SRI integrity hashes for all 6 CDN libraries, Google Chat OIDC hardening.

  • ๐Ÿ”ง Playbook Sync Fixes. Duplicate AJAX handler conflict resolved. Silent sync failures now report errors to admin UI. CPT class loading guards prevent fatal errors during bulk reseed.

  • ๐Ÿ”‘ Model Provider Credential Resolution. Model picker now resolves API keys from all 4 sources โ€” settings, credentials option, environment variables, and PHP constants.

  • ๐Ÿ›ก๏ธ Dependency Security. adm-zip, axios, and brace-expansion bumped to resolve 18 Dependabot alerts across 5 package.json files. npm audit: 0 vulnerabilities.

โœจ What's New at a Glance (v1.1.40)

  • ๐Ÿ“ Content Format Awareness. New WP_MCP_AI_Content_Format_Helper detects and preserves Markdown, HTML, and plain text formats across post-modifying and analysis tools โ€” AI-generated content retains its intended structure through the full create/update pipeline.

  • ๐Ÿ”— Research โ†’ Paper Store โ†’ WordPress Draft Pipeline. All research tools now support save_to_paper_store for staging results in the flat-file Paper Store. New create_post_from_research Pro tool bridges staged research to WordPress drafts. Human-in-the-loop review before publishing.

  • ๐ŸŽฌ Demo Video Pipeline Complete (Phases 0โ€“5). Scripted scene recording with AI voiceover narration. GitHub Actions CI workflow automates video assembly. 14 narration scripts and video catalog.

  • ๐Ÿ” Settings Credential Split. Sensitive API keys moved from wp_mcp_ai_settings (autoload) to separate non-autoload wp_mcp_ai_credentials option with transparent merge. One-time migration. wp_suspend_cache_addition and dual cache clearing for defense-in-depth.

  • ๐Ÿค– Kimi & DeepSeek Client Parity. Both providers now match all first-class providers: streaming, tool use, token tracking, and error handling. Plus DeepSeek and 9 missing providers added to all research tools.

  • ๐Ÿ“Š Model Catalog Update (July 2026). 24 files updated across base + pro. Default bumps: Gemini gemini-2.5-flash โ†’ gemini-3.5-flash, NVIDIA meta/llama-3.1-8b โ†’ nvidia/nemotron-3-nano-30b-a3b, Gemini Live gemini-2.5-flash-live โ†’ gemini-3.1-flash-live-preview.

  • ๐Ÿ—๏ธ OOS Engine: SchemaStoreInterface + Tests. New domain contract, PostTypeSchema/TaxonomySchema entities, GetPostTypeSchemaTool, WordPress adapter. 45 new tests.

  • โšก SSE HTTP/2 Fixes. ob_clean() replaces ob_flush() to prevent protocol errors. 524 timeout resolved in Pro SPA v2.

  • ๐Ÿ” Vector Store Sync โ€” No Polling. Status now checked only on assistant change and page load, reducing API load.

  • ๐Ÿ”ง Settings Import/Export Batch (4 fixes). Credential merge, save key wipe, subtab sanitization, export consistency โ€” all resolved.

  • ๐Ÿ›ก๏ธ Validated Tool Slug Allowlist. Tool slug matching fixed for validated variants.

โœจ What's New at a Glance (v1.1.39)

  • ๐Ÿค– Page Agent Addon v0.1.0. New addon (addons/page-agent/) โ€” AI-powered browser page control copilot powered by Alibaba Page Agent (MIT). Give any WordPress page its own AI agent that can click, type, and navigate via natural language, running entirely client-side with no headless browser required. Includes shortcode, Elementor widget, REST endpoints, and MCP tool bridge.

  • ๐Ÿ’ฌ Pro SPA v2 โ€” Major Parity Update. Voice pipeline, tasks drawer, workflow tracker, and file attachment upload to WordPress Media Library. Tool Shortcuts and Slash Commands drawers. Mobile hamburger sidebar toggle. Speech/audio button fixes using correct REST endpoint. Conversation title improvements and turn count display fix. Button and token NaN display fixes. Model sync and auth bypass fixes. Assistant preloading in runtime config.

  • ๐ŸŽจ Pro SPA v2 โ€” UI Polish. Autoscroll fixes (submit, streaming start, user-at-bottom guard, scrollTop vs scrollIntoView). Viewport height fixes via CSS height chain instead of viewport calc. overflow:hidden on height-chain ancestors. filemtime cache-busting across all SPA addons. Lint errors resolved.

  • ๐Ÿ‘ค Per-User Chat Memory Preferences. Users can now toggle chat memory on/off from their WordPress user profile. Individual control over AI memory retention without affecting site-wide defaults.

  • ๐Ÿ“ create_post / save_post Tool Enhancements. Markdown-to-HTML conversion via new WP_MCP_AI_Tool_Markdown_Converter trait. Smart taxonomy suggestions auto-detect relevant categories and tags. Block content corruption fixed for non-post post types.

  • ๐Ÿ”„ Workflow Blueprint & Schedule Improvements. Existing-content awareness in Content Publisher and Keyword Pipeline blueprints. Blog schedule presets now check for duplicate content before publishing. Readable response generation for workflow schedule result delivery.

  • โ™ฟ SPA Accessibility. Annotation pills made clickable with meaningful screen-reader labels.

  • ๐Ÿ›ก๏ธ Security. OWASP ZAP DAST medium findings triaged as false positives.

โœจ What's New at a Glance (v1.1.37)

  • ๐Ÿญ EZuite Inventory Sync Pro Toolkit. ERP-integrated inventory sync bridging EZuite ERP with WooCommerce/WordPress. Pull products, query inventory, create/update items, manage orders, and configure API credentials โ€” all via AI tools. Admin UI with connection selector, field mapping, and sync direction controls. CLI sync commands for batch operations.

  • ๐Ÿ”„ Ralph Loop CCT Migration & Orchestration. Circuit breaker pattern with configurable failure thresholds. Execution logger with step-by-step tracking. CCT migration tools for safe cross-environment JetEngine data operations. Orchestration tools for multi-step workflows.

  • ๐Ÿ“… JetBooking/JetAppointment Integration (8 tools). Adapter layer for Crocoblock booking and appointment plugins. 8 new tools + 4 enhanced calendar tools with booking/appointment awareness.

  • ๐Ÿง  Moonshot AI (Kimi) & Z.AI (GLM) Provider Parity. Both providers upgraded to full DeepSeek-level chat client capabilities โ€” streaming, tool use, token tracking. ZAI client + baseten service in DI container. Provider count now 15 first-class.

  • ๐Ÿ“‹ Unified Sync Log Manager. Per-item audit trail across EZuite, FlowHub, and Shopify sync toolkits. Sync history with timestamps, status, and error tracking. Status dashboards on admin pages.

  • ๐ŸŽ›๏ธ Tool Presets Auto-Select & Chips Bar. Selected tools display as clickable chips with +N overflow toggle. Tool payload cap raised from 50 to 100 tools per assistant.

  • ๐ŸŒ HTTrack Cache & Place-to-Service Bridge. HTML mirror import now supports HTTrack cache directories. Auto-creates bookable services during batch place import. URL backfill for mirrors without hts-cache.

  • ๐Ÿ”Œ FlowHub Per-Connection Overview. Remote Sites connection selector on FlowHub config tab. Per-connection sync controls. Proxy support via http_api_curl hook.

  • ๐Ÿ” Web Search 429 Retry. Exponential backoff for rate-limited search requests.

  • ๐Ÿ› 45+ Bug Fixes. CCT module API mismatches across EZuite/FlowHub/Shopify (canonical Module.instance/Factory/ItemHandler). EZuite sync (missing return, field mapping, connections, CCT registration). FlowHub sync (silent failure, proxy persistence, auth headers, null cct, dry-run). Shopify sync (Catalog API guard, CCT registration lifecycle). Duplicate column errors in ensure_columns. SQLite meta cache explosion. masterminds/html5 case collision. Base-version guard blocking toolkits. Tool registry fatal guards. HTTrack import (URL resolution, hex filenames, subdirectory content, mirror detection). Necessity Gate request context crash. Auto-select compute timeout. Place-to-Service bridge collision.

  • ๐Ÿ“– Documentation. Abilities registration plan (~1,000 tools as WordPress Abilities). Laravel-scale deployment architecture proposal. WP.org submission prep. Agent context sync.

โœจ What's New at a Glance (v1.1.35)

  • ๐Ÿช FlowHub Inventory Sync Pro Toolkit. 6-tool cannabis dispensary management: products, inventory, locations, sync, analytics, alerts. P1 proxy support via http_api_curl hook. P2 CCT auto-registration in JetEngine custom content type tables. Auth, decryption, location_id, and null-guard fixes (PRs #5500, #5501, #5502, #5503, #5507, #5510). Admin UI toggle on Features tab.

  • ๐Ÿ›’ Shopify Sync Pro Toolkit. 5-tool bi-directional e-commerce sync: products, orders, inventory, analytics, settings. Connection resolver trait. Dashboard widget with sync status and recent activity. Tool reference docs at docs/tools/shopify-sync-toolkit.md (PR #5502).

  • ๐Ÿ›ก๏ธ Necessity Gate Layer J. Pre-execution safety layer that scores tool calls by irreversibility risk. Write operations (create/update/delete) assigned risk scores by resource type. Safety profile trait with clean autoload. Request context crash fix.

  • ๐ŸŽ™๏ธ Local Voice Embedded STT. Three pluggable browser-side speech-to-text backends: Web Speech API, Whisper.cpp (WASM), Vosk (WASM). Offline-first โ€” no server dependency. Auto-detection based on browser capabilities (PR #5498).

  • ๐ŸŒ Remote Site Administrator Blueprint. 22-tool assistant blueprint in Site Creator toolkit for full remote/local WP/WooCommerce management with JetEngine, JetFormBuilder, and REST API control. Auto-discovered by Unified Blueprints page.

  • ๐Ÿ“ฆ Places & Calendar Bulk Import. Batch import tools for Places and Calendar Booking toolkits โ€” import multiple records in a single call (PR #5509).

  • ๐Ÿ’ป CLI site-import Subcommand. Multi-phase HTML mirror import for migrating static sites into WordPress โ€” page structure extraction, content mapping, media sideloading.

  • ๐ŸŽค Voice Realtime Auto-Detect. WebRTC/WebSocket auto-selection, duplicate message prevention, VAD threshold improvements (PR #5508).

  • ๐Ÿ”ง Remote Connections Fixes. WordPress case handling normalized. FlowHub and Printful credential storage fixed (at-rest encryption). Printful connection type added (PR #5499).

  • ๐Ÿ› 7 Bug Fixes. Token-scoped assistant resolution (PR #5497), user_id empty fallback (PR #5495), credential token mapping (PR #5493), post type name lengths (PR #5484), OpenAI image deprecation cleanup (PRs #5489-#5491).

  • ๐Ÿ“‹ Documentation. GPT-Realtime-2 upgrade proposal + 1,166-line implementation plan. FastAPI porting implementation plan (PR #5467).

  • ๐Ÿงน Housekeeping. Stale build artifacts and toolkit-addons directory removed.

  • ๐Ÿ”Œ WP 7.0 Connectors Credential Integration. Credential_Resolver now integrated into all 17 AI client get_api_key() methods. Fallback chain: WP 7.0 Connectors โ†’ plugin settings โ†’ env vars โ†’ PHP constants. Credential source badges and WP 7.0 Connectors hints rendered in admin settings UI. All 13 provider API key field descriptions updated. Provider diagnostics show key source column. Settings health check counts credentials via resolver.

  • ๐Ÿงฉ nvoos-graphify v1.0.0. Standalone nvoos-graphify plugin released at v1.0.0 (Plugin Check compliant). nvoos-graphify-ai released at v1.0.0-dev. Fixed critical ->prepare() spread-operator bug in Db::listNodes(). Renamed vector column โ†’ embedding_vector to avoid MariaDB/MySQL reserved-word conflict. Fixed snake_caseโ†’camelCase method calls across tools, controllers, and cross-plugin integrations.

  • ๐Ÿ›ก๏ธ Security Dependencies. guzzlehttp/guzzle 7.10.0 โ†’ 7.12.1 (CVE-2026-55568, CVE-2026-55767). guzzlehttp/psr7 2.11.0 โ†’ 2.12.1 (CVE-2026-55766). guzzlehttp/promises 2.3.0 โ†’ 2.5.0. undici npm override tightened >=7.28.0 โ†’ >=8.5.0.

  • ๐Ÿ”’ npm Security. 29 alerts resolved across 14 packages: undici (TLS bypass CVE-2026-9697, cache info CVE-2026-9678), http-proxy-middleware (CRLF injection CVE-2026-55603), nodemailer (GHSA-p6gq-j5cr-w38f), webpack-dev-server (HMR CVE-2026-9595), dompurify (GHSA-cmwh-pvxp-8882). Fixed critical duplicate overrides key in root package.json.

  • ๐Ÿชฒ Bug Fixes. Fixed missing -pro- in WP All Import/Export require_once paths causing fatal errors when those Pro tools load. Fixed fragile @file_get_contents() warning suppression in tool status label loader โ€” replaced with explicit set_error_handler('__return_true') to prevent leaked warnings from corrupting MCP JSON-RPC HTTP responses.

  • ๐Ÿ“ฆ Dependencies. 15 Dependabot bumps across Composer, npm (stripe, zod, p-queue, csv-parse, react-query, puppeteer, vitest, wrangler, eslint-plugin, workers-types, types/node), and GitHub Actions (codecov 4โ†’7, action-gh-release 2โ†’3).

  • ๐Ÿงน Housekeeping. Stale 1.1.31 and 1.1.32 build zips removed. SPA addon ZIPs rebuilt with updated security overrides.

โœจ What's New at a Glance (v1.1.32)

  • ๐Ÿ“ Content Format Templates & Featured Images. Content Format Template CPT with user-editable blog templates. Content Template Engine generates Anthropic-optimised AI prompts. Featured Image Service with 3-provider fallback (DALL-E โ†’ Gemini โ†’ Cloudflare) and 5 image styles. Provider image settings now respected instead of hardcoded defaults.

  • ๐Ÿ“ฌ Result Delivery Pipeline. 1,056-line service routes schedule results to 8 channels (email, Slack, Discord, Telegram, SMS, Paper Store, WordPress post, webhook). Both success and failure paths now deliver โ€” previously only failures were surfaced.

  • ๐Ÿ“„ ECA Document Generation. ECA Consolidate & Add page with document generation tools.

  • ๐Ÿชฒ Duplicate Posts Fixed. WordPress delivery channel removed from weekly_blog_post_writer and weekly_blog_topic_research presets. Systemic guard skips WordPress delivery when AI tool calls already include create_post or save_post.

  • โฑ๏ธ 6 Provider Clients Timeout Fix. DeepSeek, Baseten, DigitalOcean, OpenRouter, Kimi, and Cloudflare clients now respect the global request_timeout setting instead of hardcoding 60 seconds.

  • ๐Ÿ”ง Schedule Trigger Stability. Trigger crash on rest_do_request() fixed with try/catch + pre-flight REST check. Result delivery sanitizer preserves channels wrapper so edit modal shows saved values. AJAX handler captures PHP warnings that corrupt JSON.

  • ๐Ÿ“‹ Paper Store Delete Fix. Hidden inputs added to delete confirmation form so handle_delete_record() receives required POST fields.

  • ๐Ÿงช npm CI & Jest Resilience. Babel ESM override pinned for Node 18/20 compatibility. Jest config probes for setup files at load time with graceful fallback. npm ci lockfile sync for 5 addons.

  • ๐Ÿ“ฆ Dependencies. 14 safe Dependabot bumps. 8 npm audit CVEs (nodemailer, tar, tar-fs). phpspreadsheet 5.7.0 โ†’ 5.8.0.

โœจ What's New at a Glance (v1.1.31)

  • ๐ŸŽฌ Media Command Center. Top-level NV Media admin menu with command center for media templates, presets, and blueprints.

  • ๐Ÿ’ฌ Pro SPA v2 โ€” Rich Rendering & Scoping. Rich markdown rendering, per-assistant scoping, agent selector dropdown. Conversations primary, threads read-only. Version 2.0.1.

  • ๐Ÿงฐ 34 Workflow Preset Tools. All missing workflow presets implemented across 10 toolkits. Full PHPCS compliance and test suite for 36 tools.

  • ๐Ÿ”’ npm Audit CVEs Resolved. 12 CVEs fixed: vite, launch-editor, markdown-it, ws, js-yaml, form-data, hono, dompurify, babel, opentelemetry, joi.

  • ๐ŸŽจ Gemini 3.1 Flash Image. Default Gemini image model upgraded to gemini-3.1-flash-image.

  • ๐Ÿ–ผ Media Toolkit Blueprints & Presets. Blueprints and scheduler presets synced to Data Management page.

  • โšก OpenAI/DeepSeek stream_options. Streaming usage payloads now include proper stream_options for accurate usage tracking.

  • ๐Ÿ’ฐ Agentic-Loop Cost Tracking. Tool result costs computed from tokens when not explicitly provided. Missing provider pricing added.

  • ๐Ÿ›ก๏ธ Vite CVEs. vite ^8.0.16 for CVE-2026-53571 (server.fs.deny bypass) and CVE-2026-53632 (NTLMv2 disclosure).

  • ๐Ÿงน 1,658 PHPCS Lint Fixes. Across base + pro addon (44 toolkits).

  • ๐Ÿ”ง CI Disk Space. Free disk space step added to all build workflows.

โœจ What's New at a Glance (v1.1.30)

  • ๐Ÿ’ฌ Chat SPA Phase 8 โ€” Message Actions. Edit, delete, regenerate, copy, and content enrichment cards on every assistant message. Conversations sidebar with assistant scoping. Auto-create thread on first message.

  • ๐Ÿ“Š PM Toolkit Enhancement Phase Aโ€“D. Shared engine powering Command Center dashboard with real-time task visibility. Work Ingestion panel. 28 new AI tools for task management, resource allocation, timeline generation, and reporting.

  • ๐Ÿข CRM Toolkit โ€” Duplicates & Hygiene. Duplicate detection engine with safe one-click merge. Email hygiene module: domain reputation classification, exclusion/priority lists, auto-pruning. Top Customers/Clients analytics. LinkedIn & Upwork external sourcing.

  • ๐Ÿฅง DietPi Pro Toolkit Phases 0โ€“3. 19+ tools for server management: system info, package/service control, backup/restore, storage, provisioning, SSH proxy. Registered as MCP server.

  • ๐Ÿ›ก๏ธ Layer I Guardrails โ€” Jailbreak Prevention. Stay-on-target guardrails blocking prompt-injection and role-change attacks. Configurable per-assistant via LLM Harness metabox.

  • ๐ŸชŸ Context Window Management. Pre-flight validation across all 13 AI providers. tiktoken integration, estimator metabox, token-budget tool capping, chat parity drift detection.

  • ๐ŸŒ‰ WP 7.0 Connectors API Bridge. Forward-compatible provider credential bridge. Classes load unconditionally on WP < 7.0.

  • ๐Ÿง  Chat Transcript & Agent Memory Retention. Configurable TTL-based transcript cleanup (base). Agent memory lifecycle management with pruning and retention windows (Pro).

  • โšก Pro Toolkit Optimizations Phase 1โ€“3. Performance optimization across 6 Pro toolkits with autoload control, caching, and lazy loading.

  • ๐Ÿ”Œ OAuth & API Disconnect Buttons. One-click disconnect for OAuth and API connections with automatic token clearing.

  • ๐Ÿ’ฌ LibreChat Addon. New standalone addon with code interpreter, speech-to-text/text-to-speech, and web search reranker.

  • ๐Ÿชฒ 30+ Bug Fixes. SPA reliability sweep (thread endpoints, router context, event serialization). Agentic loop tool result persistence. CPT slug limits. Security CVEs (guzzlehttp/psr7, shell-quote, esbuild).

โœจ What's New at a Glance (v1.1.29)

  • ๐Ÿ”ง Chat Bubble Assistant Dropdown. Settings UX fixed: chat_bubble_assistant_id changed from manual ID input to proper assistant <select> dropdown.

  • ๐ŸชŸ Context-Window Pre-Flight Validation. Added to all AI provider clients with shared validate_context_window() helper, tiktoken integration, and estimator metabox.

  • โšก OpenAI SSE Streaming Fix. stream_options payload flag corrected so OpenAI real-time SSE streaming triggers properly.

  • ๐Ÿ“… Schedule Preset Data Mismatches. Fixed presets losing configuration data after save. Improved error logging for preset operations.

  • ๐Ÿงน Playbook Orphan Cleanup & Batching. Fixed orphan accumulation and sync timeouts with configurable chunk size batching.

  • ๐Ÿ”„ Stale Provider Validation Lists. Provider checks moved to dynamic discovery instead of hardcoded arrays, fixing DeepSeek rejection.

  • ๐Ÿ“Š CRM Activity Titles, Due Dates & Block API v3. Activity post titles, recurring due dates, and admin blocks migrated to WordPress Block API v3.

  • ๐ŸŽฏ OpenAI-Compatible Client โ€” DeepSeek Parity. OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM clients upgraded to DeepSeek parity.

  • ๐ŸŽค Voice & Embedded LLM Missing Assets. Missing .min.js files added for voice recording/transcription and embedded LLM worker scripts.

  • ๐Ÿชฒ 25+ Additional Fixes. Chat config messagesEndpoint, debug console, OOS bridge fatal error, embedding service WP_Error, SSE header warnings, memory cookie nonce, graphify content leak, model limits sync, shell-quote CVE-2026-9277, and more.

  • ๐Ÿงช Tests. Chat transcript REST controller tests improved from ~4% to 87% pass rate.

โœจ What's New at a Glance (v1.1.28)

  • ๐Ÿข CRM Phase C Complete. IMAP email polling, Twilio SMS webhook, Meta WhatsApp webhook, and Gmail OAuth bridge for multichannel inbound ingestion โ€” all triaged through CRM Classifier and routed to the Workflow Command Center.

  • ๐Ÿ‘ฅ Customer CPT + Customer 360. 5 CRUD tools for mcp_ai_customer CPT. Customer Research & Add page with Customer 360 dashboard. Lead-to-customer conversion with deal promotion.

  • ๐ŸŽซ Support Ticket Module โ€” 10 AI Tools + SLA. Full ticket lifecycle: create, get, update, list, classify, escalate, resolve, reopen, merge, SLA report. Ticket automation, SLA breach detection via cron, email notifications, and optional Zendesk sync.

  • ๐Ÿ” TF-IDF + BM25 Relevance Search. Dual-algorithm relevance ranking across CRM, healthcare, and base content search tools. Shared traits in both Base and Pro.

  • ๐Ÿง  Transformer-Inspired Attention Routing. QKV multi-head attention (5 heads: semantic, capability, recency, dependency, risk) for semantic tool selection. Sliding-window conversation compressor. Persistent tool embedding store. RRF fusion with harness scoring.

  • ๐Ÿ”Œ Funiq Bridge Addon. Payload-to-WordPress bridge with React admin SPA, REST controllers, transformers, post types, and taxonomies.

  • ๐Ÿ•ธ๏ธ NVOOS Graphify Ecosystem. Three standalone plugins: nvoos-graphify (visual knowledge graph, 14 tools), nvoos-graphify-ai (13 providers, streaming chat, RAG, embeddings), nvoos-graphify-ai-platform (Agents, A2A, ACP, Blueprints, Federation, Harness, Measurement, Professions, Skills, Slash Commands). Framework-agnostic lib/core and lib/wordpress-adapter packages.

  • ๐Ÿ—๏ธ NV Platform AI Addon. Top-level admin dashboard + CPTs (Project, Resource, Template).

  • ๐ŸŽฌ Automated Demo Video Pipeline (Phases 1โ€“3). Scripted scene recording, AI voiceover generation, automated video assembly.

  • ๐Ÿ›ก๏ธ CRM Lead/Deal Enhancements. Enriched lead/company tables, dedicated Leads tab, data completeness KPI. Lead CPT admin expanded with contact details and remote channel link.

  • ๐Ÿ“‹ Documentation & Unix Theory. Folder READMEs for new CRM subdirectories (customers/, inbound/, support/). Compliance check errors in includes/data/ and addons/pro/includes/traits/ READMEs resolved. CRM enhancement plan updated.

โœจ What's New at a Glance (v1.1.27)

  • โšก Real-Time SSE Streaming. Real-time streaming enabled for OpenAI, DeepSeek, and all OpenAI-compatible providers. "Disable Native Streaming" control in Settings.

  • ๐Ÿงฐ 35 New OOS Core Tools. Data tools (GetPostTaxonomies, CountPosts, GetPostMeta, TruncateText, MergeArrays), format tools (FormatDate, TimeAgo, ParseCsv, MathEval, ColorConvert), infrastructure (EventDispatcher, Queue), and cache management tools.

  • ๐Ÿ“ธ Extended Cognition Vision Recognition. Visual product/brand recognition with camera viewfinder UI, detection overlays, and consent gate.

  • ๐Ÿ”ง JetFormBuilder Submission Tools โ€” 8 Fixes. Empty results for non-admin users, form discovery pipeline, PHPCS warnings, REST route matching, form-type auto-detection, and plugin detection all fixed.

  • ๐ŸŽฏ Graphify Tools Capability Compliance. Missing trait and explicit get_required_capability() added to all Graphify tools.

  • ๐Ÿค– DeepSeek Agentic Tool Handling. Tool message filtering and payload normalisation for agentic multi-turn workflows.

  • ๐Ÿ“ Docs Fixes. Broken links after Unix-theory reorganization resolved.

  • ๐Ÿ’ฐ June 2026 Model Pricing. All 13 provider pricing updated.

  • ๐Ÿ“‹ Plugin Restructuring Proposals v3.0. Graphify-centric architecture spec and roadmap.

  • ๐Ÿ›ก๏ธ Pro Toolkits Security Audit. 9 HIGH-severity security findings fixed.

  • ๐Ÿ“‹ Reviewer Onboarding Docs. Complete reviewer documentation suite (docs/project/FOR_REVIEWERS.md).

  • ๐Ÿณ Docker Dev Environments. WordPress, Laravel, and Craft CMS Docker environments all fixed.

  • ๐Ÿงช Test Infrastructure. 95% of PHPUnit failures resolved across base, pro, and addon test suites.

  • ๐Ÿ”ง Infrastructure Fixes. TCPDF autoloader fix, Pro vendor files committed, puppeteer detection path fix, shallow clone recommendation.

โœจ What's New at a Glance (v1.1.25)

  • ๐Ÿงฉ Unified Blueprint System. 55 pre-built AI assistant blueprints across 25 toolkits.

  • โ˜๏ธ Cloudways Pro Toolkit. 60 AI tools for server and application management via Cloudways API v2.

  • ๐Ÿข CRM Toolkit Phases Aโ€“E Complete. 70+ tools: lead management, multi-channel triage, sequences, command center, compliance.

  • ๐Ÿ’ฌ Chat UI Enhancements. 7 features: profile card, stop generation, feedback, code copy, dark mode, prompts, search.

  • ๐Ÿ“‚ Unix-Theory Tool Reorganisation Phase 4โ€“5 Complete.

  • ๐ŸŽ› Pro Toolkit MCP Server Settings Pages. Phases Aโ€“C.

  • ๐Ÿฅ Aerlinn + Healthcare Blueprints.

  • ๐Ÿ”ง Build Infrastructure Hardening.

โœจ What's New at a Glance (v1.1.24)

  • ๐Ÿงน Bug-Fix & Stabilisation Sweep. Paper Store Pro interface load order fix (deferred to wp_mcp_ai_bootstrapped hook). Chat SPA duplicate-message and SSE protocol-mismatch fixes. Markdown rendering enabled in Chat SPA responses.

  • ๐Ÿ›ก๏ธ Skill Manager Canonical Envelope โ€” Unix Theory P0/P1 Refinement. Skill manager now returns WP_Error on failure instead of the legacy array('success' => false, ...) pattern. Skills sync endpoint added for idempotent import/export. YAML frontmatter parsing hardened against colons in description fields.

  • ๐Ÿ“ Assistant Tool Presets Coverage. 24 missing tools added to assistant creation presets. Out-of-date tests fixed.

  • ๐Ÿ”’ CVE Patches. tmp bumped to >=0.2.6 and symfony/cache to ^6.4.40 to resolve upstream CVEs. Composer vendor state committed.

  • ๐Ÿ—„๏ธ Paper Store Admin CRUD. Full CRUD admin UI for Paper Store collections and records under Assistants menu, matching Skills admin convention.

  • ๐Ÿ–ฅ๏ธ CLI Coverage Enhancements. Comprehensive WP-CLI command coverage improvements across the plugin toolchain.

  • ๐Ÿ“š Folder README Convention โ€” Unix Theory P7. Folder READMEs added for every PHP-bearing subdirectory across includes/ and addons/pro/includes/. Agent context docs (CLAUDE.md, AGENTS.md) synced with recent features.

  • ๐Ÿ”ง Build & CI. build-spa-addons GitHub Actions workflow added. Missing SPA addon ZIPs restored. All SPA bundles rebuilt.

Privacy & Terms Notice: This plugin connects to external AI services. Review each provider's policies:

See the complete External Services Reference for all 20 services.

The plugin works standalone with ~303 base tools and optionally extends through the Pro addon, which adds ~1,263 Pro tools for advanced integrations (WooCommerce, JetEngine, social media APIs, GitHub, Google services โ€” including Google Calendar and the new Gmail/Drive read tools โ€” Shopify, QuickBooks Desktop, Yahoo Fantasy Sports, ESPN Fantasy, ECA management, CRE Debt & Securitization, Cloudways server management, CRM lead/deal/customer lifecycle, support ticket management, multichannel inbound/outbound messaging, Composio Connect, vision analysis object counting) and exec-based tools (FFmpeg, WP-CLI, Python rembg, Jukebox), bringing the total to ~1,566 built-in tools (~303 base + ~1,263 Pro; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).

Note on Tool Count: Tools include base WordPress operations, content management, media generation, research capabilities, and optional third-party integrations. The base version (~303 tools) works standalone. The full version requires the Pro addon and provides ~1,566 total tools including specialized toolkits for e-commerce, social media, analytics, document generation, vehicle estimation, image validation, JetEngine MCP, A2A agent delegation, CRE Debt & Securitization, Cloudways infrastructure management, CRM lead/deal/customer lifecycle + support tickets + multichannel, MCP Apps, Composio Connect, vision analysis, and more. Live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative.

Addon Ecosystem: NV oOS ships a growing family of 27 installable addons: Pro (addons/pro/ โ€” ~1,247 additional tools), Chat SPA (addons/chat-spa/ โ€” React chat replacement), Docs Hub (addons/docs-hub/ โ€” in-site documentation SPA), SaaS Controller + Cloud Worker (addons/saas-controller/ + addons/cloud-worker/ โ€” NV oOS Cloud control plane), Cloudways Dashboard (addons/cloudways-dashboard/ โ€” Cloudways server management), Toolkit Shell / Canvas / Canvas Toolkit / Document Editor / Media Studio (addons/toolkit-shell/ etc. โ€” Toolkit SPA Blueprint Tier Aโ€“D), Media Worker (addons/media-worker/ โ€” Docker-based Node.js media sidecar, v3.2.0: multi-tenant shared worker mode, per-site provider keys, worker routing with local fallbacks, native /api/crawl/* endpoints + Crawl4AI facade), Graphify (addons/graphify/ โ€” knowledge graph), Comic Reader (addons/comic-reader/ โ€” CBR/CBZ/CB7/CBT reader), Funiq Bridge (addons/funiq-bridge/ โ€” Payload-to-WordPress bridge with React SPA), Fleet Operator (addons/fleet-operator/ โ€” scoped op_ operator credentials for MCP/A2A supervisor agents like Hermes), LibreChat (addons/librechat/ โ€” code interpreter, speech, web search reranker), Schedule Anything Platform + SPA (addons/schedule-anything-platform/ + addons/schedule-anything-spa/ โ€” SaaS booking with Stripe), Tenant Router (addons/tenant-router/ โ€” multi-tenant routing), Page Agent (addons/page-agent/ โ€” AI-powered browser page control copilot), Checkout API (addons/checkout-api/ โ€” vendor-side Stripe checkout/licensing service for premium addons), Algorave, Cornerstone3D, Crocoblock DS, Embedded, Fantasy Football. Separate standalone plugins: NVOOS Content Graph (plugins/nvoos-content-graph/ โ€” visual knowledge graph), NVOOS Content Graph AI (plugins/nvoos-content-graph-ai/ โ€” AI providers + chat + RAG), NVOOS Content Graph AI Platform (plugins/nvoos-content-graph-ai-platform/ โ€” agents, A2A, blueprints, skills). See docs/developer/addons/toolkit-spa-blueprint.md for the blueprint all SPA addons follow.

๐ŸŽฏ Mission: Modernizing Small to Medium Business Websites

NV oOS is specifically designed to help small to medium-sized businesses fast-track their outdated, stale, or insecure company websites to modern technology standardsโ€”without the need to add yet another wrapper around API calls. Instead, we're trying to peel back decades of API wrappers with the help of AI, providing:

  • Direct AI Integration - No middleware required. Connect directly to OpenAI, Gemini, Anthropic, Hugging Face, Cloudflare Worker AI, Ollama, LM Studio, OpenRouter, and DeepSeek without custom development

  • Security-First Architecture - Built-in protection against nefarious usage with active monitoring and prevention systems

  • Enterprise-Grade Features - Access to capabilities typically requiring expensive custom development

  • Compliance & Audit Tools - Comprehensive logging, rate limiting, and usage tracking built-in

  • Zero Technical Debt - Modern codebase following WordPress standards, ready for current technology stacks

๐Ÿ›ก๏ธ Active Security Monitoring

NV oOS actively prevents and monitors against nefarious behavior. The plugin includes:

  • Nefarious Usage Monitor - Real-time detection of suspicious patterns and automatic emergency shutdown capabilitiesใ€F:includes/class-wp-mcp-ai-nefarious-usage-monitor.phpโ€ L1-L676ใ€‘

  • Root Security Key - Optional emergency authentication layer to prevent unauthorized reactivation after security incidentsใ€F:docs/features/security/root-security-key.mdโ€ L1-L511ใ€‘

  • Granular Capability Controls - Every tool and API endpoint enforces WordPress capabilities to prevent unauthorized access

  • Rate Limiting - Built-in protection against abuse with configurable limits per user, model, and time period

  • Comprehensive Audit Logging - Track all API calls, tool executions, and security events for compliance and forensic analysis

  • Input Sanitization & Output Escaping - All user input sanitized, all output escaped following WordPress security best practices

This is not a tool for circumventing security or promoting bad practices. Every feature is designed with security, transparency, and responsible AI usage as core principles. The plugin actively works to stop and prevent misuse before it happens.

Latest audit: See docs/operations/compliance/SECURITY_AUDIT_2026_04.md โ€” the published summary of the April 2026 security & compliance code review (no Critical findings; 5 High items, 3 Fixed and 2 Partially Fixed). Full deliverables under docs/project/audits/2026-04/.

WordPress.org compliance hardening (May 9, 2026): docs/operations/compliance/WORDPRESS_ORG_COMPLIANCE_2026_05_09.md โ€” findings B3, B8, B10, B13, and production vendor remap all resolved.

โš ๏ธ Warranty & Safe Use

We make every effort to keep NV oOS safe and secure โ€” but by design, it can be destructive and resource-intensive when not properly configured.

NV oOS grants AI assistants access to powerful WordPress operations. The same capability that automates real work can cause irreversible harm if misconfigured:

  • Destructive tools โ€” bulk content deletion, user management, file writes, mass email, WP-CLI, direct database operations

  • API billing exposure โ€” uncapped AI provider calls can exhaust quotas and trigger unexpected charges

  • Server resource exhaustion โ€” concurrent agentic loops and SSE streams can saturate CPU/memory on shared hosting

Before going live: test on staging, take verified backups, apply least-privilege tool permissions, enable rate limiting, and review the system prompt of every public-facing assistant.

๐Ÿ“„ Full details: WARRANTY.md โ€” security commitment, "AS IS" disclaimer, destructive-operations table, resource-consumption guide, and mitigation checklist aligned with OWASP, NIST SP 800-53, ISO/IEC 27001, and the WordPress Plugin Developer Handbook.

Patent Pending

NV oOS is the subject of a pending patent application for its novel System and Method for Dynamic AI Orchestration Layer with Real-Time Capability Gating and Resource Budgeting.

Application Number: 19/410,504

The patent covers NV oOS's innovative approach to implementing sophisticated AI orchestration in WordPress's request-based PHP architectureโ€”a platform not designed for real-time streaming, asynchronous operations, or persistent state management. This technical achievement enables enterprise-grade AI capabilities on WordPress by recreating event-driven behavior within PHP's synchronous execution model.

Key Innovations Covered:

  • Dynamic resource budget allocation during streaming operations

  • Capability-based access control for AI tool execution

  • Registry-state-based scheduling in stateless environments

  • Metrics-driven budget adjustment for real-time optimization

  • Persistent-behavior illusion in request-based architectures

The orchestration layer makes NV oOS unique in the WordPress ecosystem by solving fundamental architectural limitations that prevent traditional WordPress plugins from supporting advanced AI features. See the System Architecture section below for technical details on how these innovations work together.

๐Ÿ— System Architecture

NV oOS implements a comprehensive orchestration layer for managing AI operations during real-time streaming events. The system architecture comprises:

  • 15 language-model providers โ€” OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi (Moonshot), Z.AI (GLM), DigitalOcean, NVIDIA NIM, Cloudflare Worker AI, Ollama, LM Studio, Hugging Face, Flowhub

  • ~1,566 tool classes (~303 base + ~1,263 Pro; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative) registered through a singleton Tool Registry

  • 36 REST controllers (16 base + 20 pro) under the mcp-ai/v1 namespace

  • 64 service classes powering orchestration, budgets, and workflows

  • 5 authentication methods โ€” WordPress nonce, assistant credentials, mesh keys, Auth0 JWT, guest tokens

  • Toolkit MCP servers โ€” per-toolkit JSON-RPC 2.0 servers exposed under /wp-json/mcp-ai-pro/v1/mcp/{slug}; discoverable at /.well-known/mcp

  • 8 inline-async-tick consumers โ€” cooperative tick-lock pattern eliminates WP-Cron startup latency for background jobs (transcript mining, async tool executor, SaaS Apply, Crawl4AI, Docs Hub rebuild, Graphify reindex, Harness eval, Gemini Veo polling)

  • 7 LLM Harness layers (+ 1 Pro) โ€” opt-in epistemic layers Aโ€“H activated per-assistant via the LLM Harness metabox

  • Orchestration Phases 1โ€“7 โ€” HITL approval queue, prompt-injection detector, structured output, OTel exporter, DAG builder, durable runs, triggers/webhooks, sub-agents

๐Ÿ“– For a detailed explanation of how NV oOS extends standard SSE and MCP protocols with novel orchestration features, see ORCHESTRATION-LAYER-ARCHITECTURE.md

Core Orchestration Layer: Overcoming PHP's Limitations

Critical Context: Most real-time AI streaming systems are built with Node.js, Python FastAPI, or Go โ€” platforms designed for asynchronous, event-driven operations. These platforms natively support:

  • Long-lived connections and persistent state

  • Non-blocking I/O and parallel execution

  • Event loops and asynchronous callbacks

  • WebSocket protocols and SSE streaming

NV oOS achieves the same capabilities in PHP/WordPress โ€” an environment fundamentally not designed for these patterns โ€” through a sophisticated orchestration layer that creates a "persistent-behavior illusion":

  1. Real-Time Budget Enforcement - Monitors token/memory usage during streaming, prevents exhaustion through predictive allocation

  2. Capability-Based Tool Gating - WordPress role-based access control for AI tool execution

  3. Predictive Optimization - Analyzes usage patterns to prevent resource overruns before they occur

  4. Distributed Orchestration - Multi-provider support with policy-aware routing

  5. Auditability & Compliance - Complete governance layer with logging and rate limiting

  6. Cron-Based Task Orchestration - Extends orchestration to async operations with budget inheritance

Multi-Agent Orchestration Enhancement (DeepSeek V4-Inspired)

Added: January 2026 (v1.1.0)

Building upon the core orchestration layer, NV oOS now includes a sophisticated multi-agent coordination framework inspired by DeepSeek V4's orchestration patterns:

Key Components:

  • Agent Role System - Four specialized roles (Planner, Executor, Critic, Specialist) with role-specific capabilities

  • Team Composition - Automated team assembly based on task requirements and profession expertise

  • Coordinated Workflows - Multi-step workflows with agent delegation, result aggregation, and validation

  • Team CPT Integration - Persistent team configurations with orchestration modes (single/sequential/parallel/swarm)

  • Profession-Based Discovery - 296 professions auto-assigned agent roles via intelligent seeding across 17 knowledge bases

Example Multi-Agent Workflow:

// 1. Compose research team (planner + executors + critic)
$orchestrator = new WP_MCP_AI_Agent_Team_Orchestrator();
$team = $orchestrator->compose_team( array( 'task_type' => 'research' ) );

// 2. Execute coordinated workflow
// Planner decomposes task โ†’ Executors research subtasks โ†’ 
// Communication service aggregates โ†’ Critic validates quality
$result = $orchestrator->execute_team_workflow( $team, $task, $context );

Documentation:

Why This Architecture Is Novel: Overcoming PHP's Limitations

  • Event loops and background workers

PHP/WordPress, by contrast, is fundamentally request-based:

  • Every HTTP request spawns a new process that dies after responding

  • I/O operations block execution

  • No persistent memory between requests

  • No native event loop or async coordination

NV oOS solves this by implementing an orchestration layer that creates a "persistent-behavior illusion" โ€” effectively recreating Node.js's event loop behavior within WordPress's synchronous, request-based architecture. This architectural compensation is the system's core technical innovation:

PHP Limitation

NV oOS Solution

No persistent state

Registry & policy engine maintain state via database/cache

No event loop

Cron Manager extends orchestration across time-shifted operations

Blocking I/O

Predictive budget allocator prevents blocking operations

Request-based lifecycle

SSE controller implements streaming within request boundaries

No background workers

WordPress cron system simulates async job processing

This makes NV oOS patent-worthy as a technical workaround โ€” it achieves sophisticated AI orchestration in an environment specifically not designed for such patterns. See ORCHESTRATION-LAYER-ARCHITECTURE.md for the complete technical analysis.

Computer-Implemented Resource Management

The system operates as a computer-implemented method executing on a processor with memory, performing:

  1. Dynamic Resource Budget Allocation: The orchestration layer dynamically allocates token and memory budgets to tool execution requests based on real-time system capacity and operation requirements. The WP_MCP_AI_Resource_Manager continuously monitors server resources (PHP memory limits, execution time constraints) and automatically adjusts operational parameters.

  2. Capability-Based Access Control: Tool execution endpoints enforce granular capability-based access controls. Each tool in the registry declares required WordPress capabilities, and the REST API controller validates user permissions before allowing execution. This ensures secure, policy-driven access to all operations.

  3. Registry-State-Based Scheduling: The WP_MCP_AI_Tool_Registry maintains tool availability state and schedules execution based on policy constraints. Tools are loaded conditionally based on dependency availability, and execution is scheduled according to assistant configuration and user permissions.

  4. Metrics-Driven Budget Adjustment: The system continuously monitors execution metrics (memory usage, API response times, token consumption) and adjusts resource budgets in response to prevent resource exhaustion and reduce latency. The WP_MCP_AI_Token_Budget_Manager implements safety margins and dynamic chunking to prevent API limit overruns.

System Components

The system comprises a processor and memory storing instructions that:

  • Monitor real-time resource availability through PHP runtime introspection

  • Enforce capability checks at REST endpoint boundaries

  • Schedule tool execution through a centralized registry

  • Adjust token and memory budgets based on detected system metrics

  • Maintain operation logs for audit and optimization

This architecture is embodied in non-transitory computer-readable media (PHP source files) that, when executed by a web server processor, cause the system to perform the complete resource management workflow. The implementation prioritizes stability, security, and efficient resource utilization across diverse hosting environments.

Symfony Process Integration (December 2025)

NV oOS Pro addon integrates the Symfony Process component for secure external command execution. This modern framework replaces direct exec() calls in 6 Pro tools and 2 supporting services, providing:

  • Enhanced Security: Proper argument escaping and command validation

  • Timeout Management: Configurable timeouts with graceful handling

  • Better Error Handling: Comprehensive exception catching and WordPress-friendly error reporting

  • Process Control: Real-time output streaming and cancellation support

Migrated Tools & Services:

  • FFmpeg operations (video frame extraction, metadata reading)

  • Python rembg (background removal)

  • WP-CLI execution

  • Meta AI Jukebox (music generation)

  • Supporting services for video and audio processing

The Process Service (WP_MCP_AI_Process_Service) provides WordPress-friendly wrappers with WP_Error integration, making external process execution consistent with WordPress coding standards.ใ€F:includes/services/class-wp-mcp-ai-process-service.phpโ€ L1-L220ใ€‘ใ€F:docs/history/2025/implementations/symfony-phases/SYMFONY_PHASE2B_PROCESS_INTEGRATION.mdโ€ L1-L100ใ€‘


๐Ÿ†• Latest Updates (v1.1.71 โ€” September 2026)

September 5, 2026 โ€” Rate-Limit Unlock, September Model Catalog, Content Graph 1.0.4, Wave E2 Queue Layer

  • ๐Ÿ”“ Rate-Limit Unlock + Fixed-Window Timer โ€” PR #6322. The general REST request limiter (check_rate_limit()) now uses fixed-window accounting ({count, first_seen} transient payload, TTL never extended past window end, legacy integer transients normalized on read) and returns the remaining time in retry_after. When the limit trips, the new wp_mcp_ai_rest_request_rate_limit_exceeded action makes WP_MCP_AI_Restriction_Registry flag a rate_limit restriction (scope rest, auto-release at window end) โ€” the block now appears in the Command Center Restrictions tab and Token Manager with the existing Lift button, and lifting deletes the wp_mcp_ai_rate_limit_user_{id} transient for a fresh window. Guest (IP-keyed) blocks are not user-attached and expire on their own (docs/features/security/user-restrictions.md).

  • ๐Ÿง  MemPalace Wing-Scope Fix + Post-K16 Singles โ€” PR #6327. WP_MCP_AI_Tool_Wake_Up_Context::matches_wake_filters() enforces wing/room exclusions (the Graphify graph anchors only boost scores โ€” they never excluded out-of-scope memories, leaking cross-wing memories into wing-scoped blocks). Test-only isolation from CI run 91942465749: transcript repository mock restored unconditionally, shared tool-registry instance restored untouched (tearDown wiped one-shot bootstrap tools like the Pro OKF tools), Site Health connectivity tests unset the other provider keys, transcript-mining logging resets the settings cache.

  • ๐Ÿ›’ Checkout API Pipeline + Salt Fix โ€” PR #6315. build/nvoos-checkout-api-v<version>.zip joins the addon build, addons/checkout-api/tests joins the main PHPUnit gate, and the build workflow gains a tests job. Production fix: the token/crypto classes derive wp_salt( 'auth' ) . wp_salt( 'secure_auth' ) instead of reading AUTH_KEY . SECURE_AUTH_KEY directly (latent fatal on salt-less installs).

  • ๐Ÿงญ September 2026 Model Catalog โ€” PR #6328. 217 โ†’ 228 models (catalog version 2026.07.14 โ†’ 2026.09.05): new gpt-5.6 family, gpt-6-astra preview, gpt-image-2, claude-opus-5, claude-fable-5.1, claude-mythos-5, gemini-3.6/3.7/3.8-flash, gemini-3.5-flash-lite, gemini-3.1-flash-image-preview, deepseek-v4-flash-vision-exp, kimi-k3, kimi-k2.7-code; retired deepseek-chat/-reasoner/-coder (API retired 2026-07-24), gemini-3.1-flash (sunset 2026-09-01), imagen-4 (shutdown 2026-08-17) with migration-map successors; pricing drift fixes (deepseek-v4-flash input 10ร—, Claude Opus inputs $15 โ†’ $5); gemini-2.5-flash-image sunset 2026-10-02, claude-sonnet-4-6 sunset cleared; defaults gemini-3.6-flash / gpt-image-2 / kimi-k3. ~45 derived files; lib/core/, lib/wordpress-adapter/, and the Content Graph AI plugin keep their own mirrored tracks.

  • ๐ŸŒ Content Graph v1.0.4 Visual Experience โ€” PR #6318. Theme engine (one token registry, PHP/JS byte-identical, WCAG โ‰ฅ3:1 palettes), appearance settings tab, 24 SVG type glyphs, interactive legend/minimap/zoom cluster/fullscreen/keyboard, GET /edges REST route with relationship color families, export at 1โ€“3ร—, [nvoos_graph] + block parity attributes, three visual filters, and a checkout-fallback redirect to the vendor product page.

  • ๐ŸŒ Content Graph AI Blocks + Settings Shell โ€” PRs #6316, #6317. assistant-selector, tools-grid, knowledge-base, assistant-builder blocks (the Build Assistant Prompt tab embeds the tools grid + KB); SettingsValidator/AiSection/SettingsRegistry settings shell (validate-then-sanitize, real validations on provider-selection + chat-settings).

  • ๐ŸŒ Platform Wave E2 Queue Layer โ€” PRs #6319โ€“#6321, #6325. AsyncJobQueue (new nvoos_content_graph_ai_platform/async_job_executors filter), QueueManager, JobQueueManager (atomic SELECT โ€ฆ FOR UPDATE SKIP LOCKED), DeadLetterQueue โ€” byte-identical ports completing the platform queue pipeline; drive-by fix extracts AgentCapabilityBoundaryHooks to its own PSR-4 file (standalone fatal).

  • ๐Ÿ”— Connectors Links โ€” PR #6314. Providers-tab notice + API-key credential-source hint now use admin_url( 'options-connectors.php' ) (the core Connectors screen) instead of the unregistered admin.php?page=connectors.

  • ๐Ÿ“š New Coding-Time Skill โ€” PRs #6323, #6324. .agents/skills/mcp-ai-wpoos-updates/ codifies Track A (docs & release catch-up) + Track B (model catalog & config updates); skill count 53 โ†’ 54; YAML frontmatter fix follow-up.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.71 across all version-bearing files. Pro addon: 1.1.71. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.4 (was 1.0.3). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Checkout API: v0.1.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 54. Stale 1.1.68 + 1.1.69 build ZIPs removed.

๐Ÿ†• Latest Updates (v1.1.70 โ€” September 2026)

September 5, 2026 โ€” exec-Disabled Host Hardening + Fifth PHPUnit Repair Wave

  • ๐Ÿ›ก๏ธ Shell-Call Hardening โ€” PR #6295. Disabled exec/proc_open no longer fatals the Pro Packages / Document Generation / Image Production / Media pages or the OCR service: wp_mcp_ai_check_nodejs_available() / wp_mcp_ai_get_nodejs_version() (new, addons/pro/includes/npm-integration-filters.php) fall back to WP_MCP_AI_Process_Service; OCR routes through is_cli_tool_available() / run_cli_command() with guarded proc_* calls; max( 0, (int) $value ) replaces absint() for assistant_id, time limits, and passing scores across seven CPT/settings pages.

  • ๐Ÿ› Wave-5 Fixes โ€” PRs #6280, #6281, #6282, #6283, #6285, #6286, #6293. Transcript display.attachments preserved (sanitizer kept the {url, label, downloadName, meta} shape) + model-aware max_completion_tokens caps (#6280); Pro dashboard get_monitoring_event_stats() accepts both slug styles (#6281); validated web_search profession tags (#6282); preset fixes โ€” phantom validate_contact_data step removed, hook moved to schedule_data.hook (#6283); mesh URLs validated pre-sanitization (#6285); guest bucket for opt-in memory capture (#6286); curriculum exporter skips empty structures (#6293).

  • ๐Ÿ› Wave-5 Fixes โ€” PRs #6296, #6298, #6300. WP_MCP_AI_JetEngine_CCT::is_storage_available() physical-table probe + deleter/writer/tool gating + conversation_import_* preset additions (#6296); complexity routing restored โ€” enhanced client passes the explicit model only, falling back to the site default only when routing is disabled (#6298); JET_ENGINE_VERSION requirement on JetEngine gates, transactional-DDL-safe cct_table_exists(), JFB id + flat params, cached wp_mcp_ai_pro_get_tool_map() feeding the token-manager listing (#6300).

  • ๐Ÿ› Wave-5 Fixes โ€” PRs #6301, #6302, #6303, #6304, #6305. Auth0 audience validated structurally (identifiers, not endpoints โ€” the Auth0 domain keeps the SSRF guard) + GitHub OAuth wp_mcp_ai_github_oauth_redirect_terminate seam (#6301); skill-pack slug normalization + wp_mcp_ai_skill_pack_installed for empty packs + markup REST 400 annotations + filterable wp_mcp_ai_legacy_sse_enabled (#6302); clamp sanitizers + wp_mcp_ai_plugins_integration_redirect_terminate seam + section-ID/tab contract updates (#6303); is_elementor_editor_init() + static::is_available() (#6304); acting-user read_post checks + positive-int user validation + Auth0 structural audience check (#6305).

  • ๐Ÿ› Wave-5 Fixes โ€” PRs #6306, #6308, #6311. timed-out timeout needle + provider-prefix-stripped model limits (nvidia/nemotron-โ€ฆ โ†’ nemotron-3) + Ollama native tool-call preservation + css_to_xpath() predicates + published_date + wp_mcp_ai_missing_image (#6306); agentic * + token_db_optimized allowlist events + started_at_ms trace durations (#6308); K16 โ€” sanitize_key-stable webhook IDs with dotted event names, settings-repository blob fallback (request guard / security manager / destructive-ops gate now see dashboard-saved settings), acting-user chart unfiltered_html, social-publish post_date reset, PSO keyword inflections, site-builder heading-tag allowlist, schema-verifier required independence (#6311).

  • ๐Ÿงช PHPUnit Repair Campaign, Wave 5 โ€” PRs #6280โ€“#6312 (~29 test-only). Clusters closed from two triage runs (docs/developer/testing-docs/CI-TRIAGE-91006542428.md, CI-TRIAGE-91771001271.md): chat transcripts, charts/dashboards, professions/teams, presets/remote connections, Cloudflare, mesh, memory, CPT management, PayHere, Mubert, OpenAI Images, composer drift ร—2, Content Graph AI, pro schedule AJAX, model routing, Gemini, JetEngine/Graphify stub isolation (tests/helpers/jetengine-stubs.php), OAuth/credentials, REST + skill packs (K15 upload isolation in #6312), admin/settings, Elementor, permission gates, HTTP/provider clients, orchestration budget, logging/events, K16 misc singles. Cluster board compacted in the mcp-ai-wpoos-test-suite skill (37 patterns unchanged).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.70 across all version-bearing files. Pro addon: 1.1.70. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.

๐Ÿ†• Latest Updates (v1.1.69 โ€” September 2026)

September 4, 2026 โ€” Vision Analysis Toolkit, tagDiv Admin Compat, DeepSeek Schema Fix, ZipSlip Guard Revival

  • ๐Ÿ‘๏ธ Vision Analysis Toolkit โ€” PR #6267. New Pro toolkit in addons/pro/includes/tools/vision-analysis/: analyze_image_objects (detection/vlm/hybrid modes, annotate=true GD bounding-box copy as a media attachment) + WP_MCP_AI_HF_Vision_Inference_Service::count_objects(), WP_MCP_AI_Vision_Count_Normalizer, WP_MCP_AI_Vision_VLM_Client, WP_MCP_AI_Vision_Annotator, and the NV oOS โ†’ Vision Analysis settings page (off by default, SSRF-guarded). bin/run-tests-docker.sh now composer-installs dev dependencies for production-only clones.

  • ๐Ÿ› tagDiv Admin Compat & Metabox Crashes โ€” PRs #6266, #6278. SiteKit tools return string capability-flag arrays (the undefined CAPABILITY_CAN_USE_IF_ADMIN constant killed the tools metabox at sitekit_get_adsense on nugl.com); the sortable fallback prints its bundled copy whenever td_wp_admin is enqueued (print-queue detection) at admin_head + wp_print_footer_scripts priority 1; the media script chain is forced as direct head tags from core-registered handles; tools metabox CSS enqueued on admin_enqueue_scripts.

  • ๐Ÿ”ง DeepSeek Empty-Schema 400 โ€” PR #6272. Argument-less tools now emit properties: {} across 29 files (Gmail/Drive list tools, Cloudways ร—4, DietPi ร—7, wait_for_user, okf_list_bundles, WebChat status, graphify, embedded abilities, ProfessionStatsTool, content-graph); LegacyToolAdapter preserves object maps + upgrades empty arrays; scaffold template emits new stdClass().

  • ๐Ÿ”’ ZipSlip Guard Revival โ€” PR #6270. count( $zip ) replaces the PHP 8.x-nonexistent $zip->num_files in all five entry loops (OKF bundle manager, Comic/Media Consolidate pages, Skill Manager ร—2) โ€” archive import rejects path traversal again (probe confirmed ../evil.md previously imported).

  • ๐Ÿ› Fixes โ€” PRs #6265, #6271, #6274, #6277. Rate limiter accepts the dispatching request's HTTP method (internal dispatches classified by their real verb, GET/HEAD exempt) and the nefarious monitor uses its own namespaced counter so a shared counter can't halve the chat budget; wp_mcp_ai_before_chat_request subscribers tolerate the legacy 2-arg emitter shape. Assistant edit screen: collect_prebuilt_shortcut_tasks() catches \Throwable per tool and coerces non-array filter results. Model catalog: gpt-4o โ†’ 128k, gemini-2.0-flash back in the video-capable list, claude-sonnet-4-6/gpt-4o restored to active, two Qwen Hugging Face entries added. Settings save reads the cache-suspension state before suspending so it restores correctly โ€” WP 7.1 inline-async tick locks no longer jam after a settings save.

  • ๐Ÿงช PHPUnit Repair Campaign Continuation โ€” PRs #6260, #6262โ€“#6276. Fourth wave (~9 test-only PRs): #6260 count-tokens params, #6262 continuation seam, #6263 chat SSE handler, #6264 deterministic cache expiration, #6268 coverage manifest + slug integrity, #6269 incorrect-usage notices (9 suites), #6273 admin registration drift, #6275 subtab sanitizer routing, #6276 14 Veo suites. The mcp-ai-wpoos-test-suite skill grew to 37 patterns; the plugin skill documents the third rate-limit counter.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.69 across all version-bearing files. Pro addon: 1.1.69. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (unchanged). Tool count: ~303 base + ~1,263 Pro (~1,566 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.

๐Ÿ†• Latest Updates (v1.1.68 โ€” September 2026)

September 3, 2026 โ€” Pro SPA v2 Shortcode, Hermes Fleet Extensions, Stale-Nonce Self-Heal, Docs Hub 0.4.2, Provider Defaults

  • ๐Ÿงฉ Pro SPA v2 Shortcode & Embedded Mode โ€” PR #6256. [nvoos_pro_spa] embeds the Pro SPA v2 chat surface on the front end (chat-first embedded mode: threads, drawers, tool shortcuts, OKF drawer; router-free, no admin routes), with per-instance data-config attributes and optional guest mode through the base guest-token machinery behind the "Allow Guest Access" setting. Proposal 033 + addons/pro/README.md.

  • ๐Ÿ–ฅ๏ธ Hermes Dashboard Fleet Extensions โ€” PR #6249. New extensions/ tree: nv-oos-fleet fleet monitoring + control plane (Python plugin API, sites.yaml inventory, dashboard bundle), backup-download, external-app-tab, mcp-tool-shortcuts WebUI extensions, install.sh, and backend smoke tests. Plans in docs/developer/integration/.

  • ๐Ÿ”„ Stale REST Nonce Self-Heal โ€” PR #6225. GET /mcp-ai/v1/session/nonce mints a fresh session-bound nonce from the request's own auth cookie (nonce/capability-free by design, no-cache/no-store); the chat client retries failed rest_cookie_invalid_nonce 403s instead of showing "Cookie check failed" on full-page-cached or long-lived SPA pages. docs/reference/api/rest-api.md updated.

  • ๐Ÿ“š Docs Hub 0.4.2 โ€” PRs #6246, #6253. Local-page .md links rewrite to #/slug hash routes (anchors preserved); TOC slugs match github-slugger exactly (0 mismatches across ~63,000 headings); "Accept fix" computes targets relative to the source directory (case-preserving); ../ links validated with root-containment checks; broken-link entries carry slug/source_type + skip reasons; sync/rebuild reports "Atomic swap failed" when the staging cache is unwritable; dead 404 route removed; the core emoji loader is disabled on docs-browser pages (its MutationObserver was crashing React's DOM). Addon bump 0.4.1 โ†’ 0.4.2.

  • ๐Ÿ”Œ Provider Enable Defaults โ€” PR #6255. Fresh installs now disable OpenAI/Anthropic/Gemini by default; provider dropdowns list only enabled + credentialed providers (get_available_providers()); the onboarding wizard auto-enables the provider whose key is entered; plugin + test-suite skills updated in-commit.

  • ๐Ÿ› Fixes โ€” PRs #6226, #6232, #6233, #6239, #6242, #6243, #6244, #6250, #6258. Calendar granted-scopes URL corruption (sanitizer keeps space-delimited scope lists; legacy %20 grants normalized back to spaces); agent-identity resolver casts alias-table canonical IDs to int; token-budget catalog dedup (gpt-4.1, gemini-2.5-flash) + restored wp_mcp_ai_model_tpm_limit filter seam on the CCT โ†’ catalog fallback path; assistant untrash restores the pre-trash status via wp_untrash_post_status (published assistants stay published, CCT sync resumes); tool presets gain the missing OKF enrich/router, Google Calendar, Gmail/Drive, composio_manage_accounts, and git_inspect/git_change tools; wp_mcp_ai_seed_task_templates AJAX action registered; fast-uri override >=4.1.4 across root/Pro/SaaS npm trees; Tiptap pinned to 3.30.4 in canvas-toolkit + document-editor (mergeAttributes prototype pollution); jQuery UI sortable shim on post edit screens for third-party admin scripts.

  • ๐Ÿงช PHPUnit Repair Campaign Continuation โ€” PRs #6223โ€“#6257, #6259. Third wave (~21 test-only PRs: #6224, #6227โ€“#6231, #6234โ€“#6241, #6245, #6247, #6248, #6251, #6252, #6254, #6257 + CI alpha-log refresh #6223) kept the suite aligned with current contracts; the production fixes it carried are listed above, plus the late-merged wp_mcp_ai_attachment_segment_provider filter for providers without a remote file API (#6259).

  • ๐Ÿงน Housekeeping. Stale 1.1.67 build ZIPs removed from build/, build/optional-components/, build/toolkit-addons/ (27 files).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.68 across all version-bearing files. Pro addon: 1.1.68. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (unchanged). nvoos-content-graph-ai-platform: 2.0.0 (unchanged). Docs Hub addon: 0.4.2 (bumped this window). Tool count: ~303 base + ~1,262 Pro (~1,565 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.

๐Ÿ†• Latest Updates (v1.1.67 โ€” September 2026)

September 1โ€“2, 2026 โ€” Content Graph Platform Extraction v2.0.0, Ecosystem Port Wave D + D-UI, Google Workspace Read Tools

  • ๐Ÿงฉ Content Graph Platform Extraction โ€” PR #6123. plugins/nvoos-content-graph-ai-platform/ ships standalone at v2.0.0: Waves Aโ€“C + Blueprints (namespace-bridged admin UI, skill/slash-command/agent bridges, platform dashboard + settings registry, harness ToolRouterHarness), a 74-skill bundled-skills pack (data/bundled-skills/), knowledge base (data/knowledge-base/), and .github/workflows/phpunit-platform.yml. Plan: docs/project/plans/content-graph-platform-extraction-plan.md; gaps: MIGRATION-GAPS.md.

  • ๐Ÿงฑ Ecosystem Port Wave D + D-UI โ€” PR #6142. The additive Base+Pro โ†’ Content Graph port lands the AI runtime in nvoos-content-graph-ai โ€” chat runtime core (D1), providers beyond the 13 (D2), model management + analytics/token tracking (D3), security guards (D4), plus D-UI admin pages, chat blocks, Elementor widgets, guest tokens, agent memory, WP-CLI, chat compat route, MCP JSON-RPC controller โ€” with .github/workflows/phpunit-ai.yml. Content Graph AI bumps 1.0.3 โ†’ 1.0.4. Tracker: docs/project/ecosystem-port-tracker.md.

  • ๐Ÿ“ง Google Workspace Gmail + Drive Read Tools โ€” PRs #6151, #6152. Six new Pro tools (Gmail: get_gmail_message, get_gmail_thread, list_gmail_connections, modify_gmail_message; Drive: get_drive_file, list_drive_connections) with two new clients on the shared includes/google/ foundation; search_gmail/search_drive updated.

  • ๐Ÿงช PHPUnit Repair Campaign Continuation โ€” PRs #6114โ€“#6208, #6209โ€“#6222. ~100 cluster PRs (second wave) kept the suite green; production fixes carried: assistant-directory REST empty-title guard (#6141), null-safe tool-error reporting (#6186), LLM sanitization delegated to the validator (#6187), display-metadata persistence (#6172), crawler job-contract hardening + wp_mcp_ai_crawl4ai_auto_spawn_cron filter (#6124, #6125), create-post taxonomy guards (#6115), toolkit-registry live-singleton resolution (#6117), slash-command handler fixes (#6122, #6140), URL-encoded external-API queries (#6156), Veo 5-second floor (#6180), token-tier caching guards (#6178), credential-resolver cache invalidation (#6119), cache-helper option-cache eviction (#6134), settings dashboard/registry fixes (#6139, #6144), orchestration-dashboard menu (#6160), tool-multiplier visibility (#6189), content-format filter seams (#6203), CRM workflow-preset canonical schema (#6208), Pro Composer class-ambiguity rename (#6198), PM assistant metabox (#6174), profession seeder envelope (#6197), destructive-ops gate canonical settings read (#6151), WhatsApp webhook signature rejection without an app secret (#6192), Graphify/Content Graph HTTP 304 cached-body re-serve (#6161), Veo async-job completion ordering (#6211), orchestration-renderer token-budget display (#6213), Shopify Sync client-availability filter seam (#6215), slash-command workflow metrics guard (#6216) + parallel/conditional block rendering (#6218), Paper Store array-field query matching (#6222), systemic PHPUnit 11 / WP 7.1 env-compat fixes (#6196). Test-suite skill refreshed to 26 patterns (#6154).

  • ๐Ÿงน Housekeeping. Stale 1.1.66 build ZIPs + .sha256 removed; re-created 1.1.65 ZIPs re-removed.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.67 across all version-bearing files. Pro addon: 1.1.67. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). nvoos-content-graph-ai: 1.0.4 (bumped this window). nvoos-content-graph-ai-platform: 2.0.0 (new standalone). Tool count: ~303 base + ~1,262 Pro (~1,565 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.

๐Ÿ†• Latest Updates (v1.1.66 โ€” August 2026)

August 28โ€“31, 2026 โ€” PHPUnit Suite Repair Campaign, Test-Suite Skill, Content Graph AI 1.0.3

  • โœ… New Coding-Time Skill โ€” PR #6108. .agents/skills/mcp-ai-wpoos-test-suite/SKILL.md distills the campaign into an operational repair playbook: Docker test commands (WP 6.9/7.1), CI log-zip triage, 16 recurring root-cause patterns (hook resets, singleton interference, WP_Error envelope drift, nonce/user binding, WP 6.9 queue memoization, anonymous-class visibility), the production-fix-vs-test-fix decision, and cluster-PR branch/commit/validation conventions. Plugin skill updated with current contracts; AGENTS.md + copilot instructions registered; TEST-SUITE-REMAINING-FIXES-PLAN.md added. Coding-time skills: 52 โ†’ 53.

  • โœ… PHPUnit Suite Repair Campaign โ€” PRs #6008, #6009, #6012โ€“#6107, #6109. ~100 cluster PRs brought the suite green. Production fixes carried by the campaign: assistant-access caching (wp_mcp_ai_assistant_access_cache_enabled filter + WP_Error caching, #6008); attachment-segment validation errors return explicit 400s (#6009); token-tier endpoint + tier-change audit logging (#6018); REST permission-callback allowlist refresh (#6019); bearer-auth context sync (#6014, #6016); REST analytics endpoints (#6015); job-queue closure serialization in legacy option storage (#6020); TIER_META_KEY chart-data constant (#6021); custom-table query guards against missing schema โ€” Graphify DB/memory bridge, job store, tenant DB (#6022); restored WP_MCP_AI_Job_Notifier::update_status(), dot-preserving job IDs, source scoping (#6036); job-notifier REST routes for dot-IDs + owner auth (#6037); Little's-law metrics (#6038); job status promoted to running on progress updates (#6039); web-search result building restored for Exa/Perplexity (#6042); profession CPT meta clamping + primary-role flow (#6043); federation mesh-sync init (#6044); output-buffer leaks across render/AJAX paths (#6045); memory-capture failure envelope restored (#6049) + WPCS violations (#6052); container settings repository service ID (#6050); ecommerce toolkit enablement helper (#6051); A2A webhook logging + delegate tool errors (#6055); Media Toolkit tools normalized to WP_Error (#6057); autonomous-session tool error logging (#6058); Cloudways analytics adapter auth check (#6062); auto-categorize router/client (#6064); Graphic Editor Plus image access on WP 6.9+ (#6069); workflow-editor AJAX WP_Error/hook drift (#6070); Remove Background path guard + source resolution (#6072); quiz + document-template admin pages (#6089, #6090); profession service + aggregate results (#6096); NPM integration notice determinism (#6097); profession team CPT sanitization (#6105); Graphify admin classes load defensively on plugins_loaded (#6106); Shopify Sync CCT manager validates variant IDs before the JetEngine availability check (#6109).

  • โœ… Content Graph AI 1.0.3 โ€” PR #6056. Tool permission-check fix + addon bump; ZIP v1.0.3 ships in build/.

  • โœ… Checkout API Addon + Content Graph Paid Checkout โ€” PR #6063. New addons/checkout-api/ v0.1.0 (vendor-side Stripe checkout service: /wp-json/nvoos-checkout/v1/ session/verify endpoints, custom-table license store, signed expiring HMAC-SHA256 download URLs capped at 10/link, signature-verified idempotent webhooks with refund/dispute revocation and server-side license issuance on payment_intent.succeeded, per-IP rate limiting, storefront admin; Stripe secrets encrypted at rest, PHP 8.1+, vendor-server only). The free nvoos-content-graph plugin gains the client half: Stripe Payment Element modal, verify-via-vendor-API, local license key, one-flow install/activate from the signed URL, admin-only POST /payments/session|verify endpoints, four nvoos_content_graph/payments/* filters, throttled session creation, and download_url() + Plugin_Upgrader filesystem checks โ€” no Stripe keys ship in the plugin. Contract: plugins/nvoos-content-graph/docs/commerce-vendor-api.md.

  • ๐Ÿงน Housekeeping. Stale 1.1.65 build ZIPs + .sha256 removed from build/ (root, optional-components/, toolkit-addons/), matching the 1.1.63/1.1.64 cleanup convention.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.66 across all version-bearing files. Pro addon: 1.1.66. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged; paid-checkout client merged, version bump pending). nvoos-content-graph-ai: 1.0.3 (bumped this window). Checkout API addon: v0.1.0 (new). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 27. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 53.

๐Ÿ†• Latest Updates (v1.1.65 โ€” August 2026)

August 26โ€“28, 2026 โ€” Reasoning-Model Fixes, Full-Crawl4AI Proxy, Security-Posture Closure, Chat/REST Hardening

  • โœ… OpenAI Reasoning-Model Parameter Rejection โ€” PR #5985. OpenAiCompatibleClient strips max_tokens/temperature from o-series/gpt-5 payloads (applyModelConstraints()) and retries 400 rejections with corrected payloads (sendWithParameterCorrection()) on both sync and streaming paths. Content Graph AI: EmbeddingService resolves the embedding provider deliberately (OpenAI preferred when keyed โ€” most chat providers lack /embeddings) and honors the configured embeddings_model; \Throwable guards return WP_Error instead of fataling; the chat API reports graph_context_mode and falls back to keyword search over node labels without an index; the reindex button is always restored on server errors.

  • โœ… Media Worker Full-Crawl4AI Proxy (031 Phase 3) โ€” PR #5983. Env-gated POST /api/crawl/full + GET /api/crawl/full/task/:id in src/routes/crawl.js: every target URL is SSRF-validated before the payload is proxied to CRAWL4AI_FULL_URL, token-gated like every /api route, with 503 service_not_configured / 502 upstream_unreachable / 400 envelopes. TEMP_ROOT becomes the allowlisted sandbox root under STRICT_PATHS=1 (028 Q5, default flip deferred to worker 4.0.0). Worker stays v3.2.0. Proposals 028/031 updated.

  • โœ… Security-Posture Findings Closed โ€” PR #5981 (issue #5972). F-AI-01: Algorave Tone.js raw eval requires a per-session confirmation + warning banner (capability-scoped via nvoosAlgoraveConfig; Strudel unaffected). F-CMP-04: TMA markdown source map removed. F-AUTHZ-01: webhook __return_true callbacks carry justification comments. SECURITY_POSTURE.md updated in-commit.

  • โœ… Chat, REST & Transcript Hardening โ€” PRs #5991, #5993, #5994. Chat route no longer declares a top-level attachments arg (embedded segments authoritative; legacy clients tolerated); role enum validation moved to the sanitize layer (custom-role filter works again); attachment segment prep errors propagate to the client; orphaned tool messages silently discarded before dispatch; sign-preserving pagination sanitizer + guest-token helper; guardrail pre-screening skips array content.

  • โœ… Webhook, Shortcode & Pro-Tool Fixes โ€” PR #5990. Google Chat verification_token shared-secret auth when OIDC is disabled (?token= / X-Google-Chat-Token); Slack conversion anchor placeholders + italic-before-bold ordering; paper-store import/export missing-collection guards; idempotent scheduled-result block registration.

  • โœ… Slash Commands & Blocks โ€” PRs #6000, #5997. Toolkit manager re-resolves the handler at registration (init re-fire sync); CSV lists accept "1,2" and "1, 2"; assistant-builder/Pro toolkit blocks skip already-registered names (WP 7.1 notices).

  • โœ… AJAX, TPM & Admin Settings โ€” PRs #6004, #6005, #6006. Workflow-execution wp_send_json_* moved out of the try block; model-manager overwrite accepts 1/true/yes/on; research_model provider-error ordering; TPM falls back to the bundled model catalog (longest-prefix) when the CCT has no entry; dangling legacy high-token/security-monitor sections removed; WP 7.0 bridge checks WP_Connector_Registry::is_registered() first.

  • โœ… Graphify & Remote-Connection Guidance โ€” PRs #5986, #6003. Provider-prefixed *_key fields treated as sensitive; sync_remote_source returns canonical WP_Error; remote_wp_connection errors direct callers to list_connections first.

  • โœ… Content Graph wp.org Refresh โ€” PRs #5980, #5988, #5982, #5992. Icons (v5), main screenshot, generated page preview; Contributors field fixed; Content Graph AI chat tester fixed (settings store, graph adapter, SSE, core bridge).

  • โœ… Test-Suite Cluster Fixes โ€” PRs #5995โ€“#5999, #6001, #6002. SSE stream-contract alignment, WP 7.1 icon-init replay neutralisation, transcript CI follow-ups, Phase 4 slash-command suites, SSE tool-result extraction, transcript roundtrip skip without CCT. Docs-only: doc open items โ†’ GitHub issues (PR #5979), Ralph Wiggum proposal recorded as implemented (PR #5984).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.65 across all version-bearing files. Pro addon: 1.1.65. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.64 โ€” August 2026)

August 24โ€“26, 2026 โ€” Google Calendar Connection, Composio Account Health, Log Hygiene, Non-Loggable Fields

  • โœ… Google Calendar Connection & Shared Google Services โ€” PR #5959 (32 files, +9,373/-206 lines). New includes/google/ foundation (OAuth service, Calendar v3 client, scope registry, credential resolver, sync + push) replaces four drifted Google OAuth copies; google_calendar connection type on both connection surfaces; six new Pro google-workspace tools (list_google_calendars, list_google_calendar_events, update_google_calendar_event, delete_google_calendar_event, check_google_calendar_availability, quick_add_google_calendar_event) plus a reworked create_google_calendar_event and a real sync_google_calendar. Scope enforcement on every write; push channels + Action Scheduler sync. Reference: docs/developer/architecture/integrations/google-calendar-connection.md, docs/reference/google-calendar-api-v3.md.

  • โœ… Composio Verified Account Health & Real Tool Discovery โ€” PR #5936 (23 files, +5,602/-258 lines). WP_MCP_AI_Composio_Account_Health ledger + live probe (catalog-discovered zero-argument read-only tools, curated fast path, honest status_only degradation), new seventh tool composio_manage_accounts (validate/reconnect/delete/prune, in-place reconnect), in-band failure conversion, v3.1 envelope unwrapping + corrected query params, ID-swap diagnosis by prefix, Health column with Verify/Reconnect in Remote Sites. See docs/composio-connect.md.

  • โœ… Composio Proxied Provider Failures & Stale Account IDs โ€” PR #5953 (11 files, +516/-35 lines). Proxied provider refusals inside data are now authoritative failures (401/403 โ†’ auth-required + reconnect machinery), bounded execution-error path walk, anchored status scan (content false-positives structurally excluded), stale connected_account_id fast-fails.

  • โœ… Composio Zero-Argument Payload & Probe Determinism โ€” PR #5958 (6 files, +677/-28 lines). Empty arguments encode as {} (never []), validation detail flattened, bounded upstream body on WP_Error, cache-index invalidation for filtered listings, deterministic probe ranking + curated Google Calendar probe.

  • โœ… Composio Auth Config, Listings & App Removal โ€” PRs #5932โ€“#5934 (26 files, +1,715/-80 lines). Link-endpoint auth config resolution (auth_config_id/user_id/callback_url), real 401/403 error surfaces, API-key trim/validate; v3.1 listing envelope unwrap + Connected Apps list on the edit form; identity-bound execution (from_connection()), nonce-gated Remove that revokes the upstream grant.

  • โœ… Tool-Declared Non-Loggable Result Fields โ€” PR #5961 (16 files, +796/-15 lines). WP_MCP_AI_Tool_Sensitive_Result_Interface with dot-notation/*/subtree field declarations; the logger masks before preview truncation on the success, argument, and error paths; legacy-wrapper forwarding; additive-only filter; 8 declarers.

  • โœ… Log Context Bloat & Rolling-Buffer Compaction โ€” PR #5952 (21 files, +2,599/-22 lines). Per-entry byte budget on the persistence path (fingerprinted assistant_config/system_prompt, truncation, 12 diagnostic keys preserved), Extended budget 16โ†’8 KB, previous_results no longer embedded (O(Nยฒ) fix), Data Management Compact/Delete via wp_mcp_ai_maintain_log_buffers.

  • โœ… Secret URL Query Params in Logged Strings โ€” PR #5954 (3 files, +1,238 lines). 26 credential-bearing parameter names masked in the shared redactor (scheme/host/path/non-secret params preserved) โ€” covers tool arguments, error messages, and error_log(); ships the Google Calendar implementation plan doc.

  • โœ… MCP JSON-RPC Error Paths & Diagnostics Re-wiring โ€” PR #5957 (10 files, +372/-134 lines). /mcp jsonrpc/method no longer required so -32700/-32600 envelopes are reachable; MCP Server Diagnostics page, assets, and AJAX handlers re-wired after the entry-file rename.

  • โœ… Validated-Tool Validation Restored on Symfony 5.4 โ€” PR #5960 (14 files, +143/-107 lines). The enableAttributeMapping guard never fired on ^5.4 so constraint loading was silently skipped; version-appropriate helper + WPCapability constructor fix.

  • โœ… Pro SPA v2 Conversation & Assistant Sync โ€” PR #5962 (5 files, +537/-48 lines). selectSession carries assistant_id, stored sessions hydrate on mount, assistant switches start fresh conversations.

  • โœ… Vision Tools Timeout Parameter โ€” PR #5964 (20 files, +446/-113 lines). 5โ€“300s timeout argument + global request_timeout inheritance via WP_MCP_AI_Vision_Request_Timeout; OCR client download/health paths covered.

  • โœ… WP_Error Envelope Drift & Tool Bugs โ€” PR #5965 (18 files, +203/-112 lines). Canonical-envelope test conformance, plan_schedules_from_workflow regex fix, double-prepare() fix, tracked job_id returns, cron pruning, model type constraint.

  • โœ… Test-Env Registration & Suite Follow-Ups โ€” PRs #5931, #5935 (66 files, +1,416/-564 lines). AJAX suite class loading, dispatch hardening, WP All Import bootstrap guard, moved-file requires.

  • โœ… Content Graph wp.org Assets โ€” PR #5963 (7 files). Banner/icon/screenshot assets for the nvoos-content-graph listing.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.64 across all version-bearing files. Pro addon: 1.1.64. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,256 Pro (~1,559 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.63 โ€” August 2026)

August 22โ€“23, 2026 โ€” Artifact Evolution Phases Aโ€“G, Pro Addons Page, Storage Worker Offload, Test-Suite Exit Traps

  • โœ… Artifact Evolution Phases Aโ€“G โ€” PRs #5923, #5925 (52 files, +11,666/-75 lines). The Continual Harness Evolver + Meta-Harness become a complete gated Darwinian self-improvement loop for skills, prompts, and roles (proposal 007). Phase A repairs the broken evolve_harness โ†” Evolver contract (analyze_failures(), component-scoped evolve() with enforced dry_run, constructor normalization) and adds opt-in evolved-prompt consumption (WP_MCP_AI_Evolved_Prompt_Resolver) + evolved-skill merge into the Skill Registry, Refiner output sanitization/PII scrubbing, and a $5/hr default budget. Phases Bโ€“G add artifact-scoped eval suites with failure-case replay and post-mutation verification, artifact populations with parent sampling, learning-log-aware mutators, a pre-commit admission gate (three critics โ€” contamination control), holdout-gated deployment with shadow A/B and drift rollback, and a governor with human approval queue + lineage graphs + an artifact-governance metabox on the assistant screen. New Settings โ†’ Orchestration Layer switches bridge the evolution filters. Every layer is opt-in and defaults off. 16 new/expanded test suites. Reference: docs/project/proposals/007-artifact-evolution.md + implementation plan; self-evolution governance section in docs/operations/compliance/EU_AI_ACT_2026.md.

  • โœ… Pro Addons Admin Page โ€” PR #5924 (7 files, +1,086/-1 lines). New registry-driven NV oOS Pro Dashboard โ†’ Addons page (/wp-admin/admin.php?page=wp-mcp-ai-addons, WP_MCP_AI_Addons_Page, 813 lines) installs and activates standalone addons whose ZIPs ship in build/ โ€” nonce + install_plugins + allowlist gated; non-WordPress components listed read-only. AJAX test matrix included.

  • โœ… Chat Storage Worker Offload (proposal 032 v2) โ€” PR #5928 (30 files, +1,198/-210 lines). Conversation saves โ‰ฅ wp_mcp_ai_storage_worker_threshold (default 10,000 chars) offload JSON.stringify to the browser storage-worker.js via wpMcpAiStorageUtil; small saves, unload flushes, and worker failures fall back to the synchronous main-thread write with quota-retry. Per-call threshold overrides, storageWorkerUrl/storageWorkerThreshold localized on every chat surface, and a filter kill switch (0 = off). LLM worker manager URL resolution fixed (localized workerUrl โ†’ pluginUrl fallback โ†’ explicit error). Reference: docs/project/proposals/032-chat-web-workers-wiring-implementation-plan.md.

  • โœ… DeepSeek Empty-Schema Fix โ€” PR #5926 (6 files, +253/-17 lines). Schema normalization produced "properties": [] which DeepSeek rejects ("[] is not of type 'object'"); empty maps now encode as {} at all three payload boundaries (REST, Tool Service, ChatOrchestrator), and legacy tools are wrapped before the first register attempt so the fail-loud registry log no longer fires for successfully wrapped classes.

  • โœ… OKF Skill-Knowledge Conformance โ€” PR #5919 (91 SKILL.md files + 4 reference files). type: Skill frontmatter added to every bundled SKILL.md lacking it; reference files restored for wp-plugin-dto, wp-plugin-presenter, wp-action-scheduler, and mcp-builder; .agents/skills sync now recursive + covers all project-owned design skills. The OKF Validate tab no longer reports missing concepts.

  • โœ… Test-Suite Exit Traps โ€” PR #5929 (40 files, +2,121/-472 lines). New bin/sweep-tests.php (parallel 6-worker sweep, 180s/file cap, report + custom report path), AJAX test contracts in tests/bootstrap.php, and 24+ test files aligned. Production fixes kept minimal: bare-exit guards in four admin handlers (WP_MCP_AI_TESTS_RUNNING seams), duplicate CRM workflow-rule class renamed, toolkit MCP scope check now passes null (non-OAuth) scope and resource URIs skip esc_url_raw() (nvoos:// scheme preserved), SSE/Veo polling-limit filters added, export-provider log_action() public. Reference: docs/developer/testing-docs/TEST-SUITE-REMAINING-FIXES-PLAN.md.

  • โœ… Pro SPA v2 Slash-Command Composer โ€” PR #5920 (8 files, +520/-109 lines). /chat, /new, /clear, /copy, /export insert reliably from the SlashCommandsDrawer (also openable from the AgentPanel button); base assets/js/slash-commands.js fixes. Fix history: docs/history/2026/fixes/pro-spa-v2-slash-command-composer-fix.md.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.63 across all version-bearing files. Pro addon: 1.1.63. Media Worker: v3.2.0 (unchanged). nvoos-content-graph: 1.0.3 (unchanged). Tool count: ~303 base + ~1,249 Pro (~1,552 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.62 โ€” August 2026)

August 21โ€“22, 2026 โ€” OKF Bundle Management, Pro Skills Drawer, Vector Store Responses API Migration

  • โœ… OKF Bundle Management & Pro Knowledge Routing โ€” PR #5914 (47 files, +8,453/-284 lines). Ships the full OKF enhancement roadmap (Phases Aโ€“H): WP_MCP_AI_OKF_Bundle_Manager bundle lifecycle (create, rename, archive, delete, ZipSlip-safe ZIP import/export, health stats) with skill-knowledge protected; three new base tools (okf_list_bundles, okf_validate_bundle, okf_import_bundle) plus the okf_write_concept provenance schema โ€” OKF tool surface now 10 tools; a new Bundle Manager admin screen (Bundles/Browser/Editor/Import-Export/Validate, nonce + capability-gated AJAX); Pro OKF-to-Skill Bridge (load_skill resolves bundle:concept_id with per-assistant grants + trust gating), auto-enrichment agent (okf_enrich_site_content), and hybrid knowledge router (route_knowledge_query). 10 new OKF test suites (116 tests) + 3 manual smoke scripts. Reference: docs/features/okf-integration.md, docs/project/plans/OKF-BUNDLE-MANAGEMENT-IMPLEMENTATION-PLAN.md.

  • โœ… OKF Skills Drawer in Pro SPA v2 โ€” PR #5915 (15 files, +3,148/-65 lines). New read-only mcp-ai-pro/v1/okf REST surface (bundle list/stats, concept browse + search, assistant skill grants) wired through the Pro module registry + SPA loader; new OkfDrawer component (1,020 lines) lets users browse OKF bundles/concepts and reference them from chat. Also declares WP_MCP_AI::$admin_okf_bundle_manager (PHP 8.2 dynamic-property fix).

  • โœ… Percent-encoded OKF Concept Route Fix โ€” PR #5916 (2 files, +52/-3 lines). Concept IDs containing / arrive as %2F and 404'd; the route pattern now allows % and the handler rawurldecode()s before the reader lookup.

  • โœ… Vector Store Tools โ†’ Responses API โ€” PR #5917 (10 files, +1,222/-73 lines). OpenAI removes the Assistants API on 2026-08-26: every vector-store call site drops the OpenAI-Beta: assistants=v2 header, file ingestion moves to file_batches with bounded polling (wp_mcp_ai_vector_store_batch_poll_max_seconds) and a headerless single-file fallback, and the clients gain filter / ranking_options support. New migration test suite (12 tests).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.62 across all version-bearing files. Pro addon: 1.1.62. Media Worker: v3.2.0 (unchanged). Tool count: ~303 base + ~1,249 Pro (~1,552 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.61 โ€” August 2026)

August 21, 2026 โ€” Agent Identity Bridging, OKF Bundle Generator, undici Pin

  • โœ… Agent Identity Bridging in Memory Store & Recall (29 files, +1,416/-165 lines). New WP_MCP_AI_Agent_Identity_Resolver (includes/services/class-wp-mcp-ai-agent-identity-resolver.php) canonicalises virtual agent keys (SPA drawer aliases, virtual_planner_*) to the canonical assistant post ID; the alias map (wp_mcp_ai_agent_id_aliases) is bounded (200), never autoloaded, and sanitised. store_agent_context resolves on store and echoes original_agent_id / agent_id_resolved; REST chat-memory recall merges alias buckets (stored_under per record, merged_sources, default limit 25); wing/room-scoped recall keeps single-bucket semantics. Drawers (base, chat-spa, pro-spa) show wing/room/stored-under chips, an agent-ID diagnostic, a show-all-scopes toggle, and store-triggered refresh; wake_up_context graph failures fall back to the transient path and scoped wake-up/recall errors retry unscoped. New tests: tests/test-agent-identity-resolver.php, memory-drawer JS/SPA additions. Reference: docs/features/memory/chat-client-integration.md.

  • โœ… OKF Skill-Knowledge Bundle Generator โ€” PR #5911 (6 files, +817/-1 lines). WP_MCP_AI_OKF_Skill_Knowledge_Generator generates the skill-knowledge bundle from includes/bundled-skills/ on bootstrap (priority 32) when missing or when the plugin version changed, and regenerates after admin bundled-skill reinstall โ€” every okf_* tool now works out of the box instead of failing with "OKF bundle not found: skill-knowledge". Reference: docs/features/okf-integration.md.

  • โœ… undici ^7.29.0 jsdom Compatibility โ€” PR #5910 (14 files). jsdom 29.1.1 deep-requires lib/handler/wrap-handler.js (removed in undici 8), breaking vitest in seven addons; the override is pinned to ^7.29.0 โ€” newest 7.x, all CVE fixes retained.

  • โœ… nvoos-content-graph wp.org Review Reply & Report โ€” PR #5912 (5 files, +260/-3 lines). WPORG-REVIEW-REPLY.md + WPORG-REVIEW-DETAILED-REPORT.md; WPORG-REVIEW-*.md excluded from distribution ZIPs.

  • โœ… Content Graph CI ZIP Checksum Sync โ€” PR #5906 (2 files). Build jobs upload and commit the matching ${ARTIFACT}.zip.sha256 (previously ${ARTIFACT}.sha256), ending checksum drift for CI-rebuilt ZIPs.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.61 across all version-bearing files. Pro addon: 1.1.61. Media Worker: v3.2.0 (unchanged). Tool count: ~300 base + ~1,247 Pro (~1,547 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.60 โ€” August 2026)

August 20โ€“21, 2026 โ€” Restricted-User Flagging, Conversation Import, Tool Schema Normalization

  • โœ… Restricted-User Flagging & Unblocking โ€” PR #5901 (26 files, +3,568/-20 lines). New WP_MCP_AI_Restriction_Registry (includes/class-wp-mcp-ai-restriction-registry.php) converts ephemeral rate-limit and token-budget blocks into persistent, enumerable restriction records (user meta + wp_mcp_ai_active_restrictions index, daily cleanup cron, audit-logged). The OOS rate-limiter adapter fires wp_mcp_ai_rate_limit_exceeded; chat rate limits are filterable (wp_mcp_ai_chat_rate_limit / wp_mcp_ai_chat_rate_limit_window). Admin surfaces: Token Manager "Restricted Users" panel (Base) + Pro Command Center Restrictions tab; REST GET /mcp-ai/v1/restrictions, GET|POST /mcp-ai/v1/users/{id}/restrictions, DELETE /mcp-ai/v1/users/{id}/restrictions/{type}; AJAX lift actions; wp mcp-ai restrictions list|lift|add; IETF rate-limit headers; new restriction_registry_on posture signal. Full reference: docs/features/security/user-restrictions.md.

  • โœ… Conversation Import to Transcript CCT โ€” PR #5898 (38 files, +8,791/-4 lines). New includes/conversation-import/ subsystem imports ChatGPT conversations.json (incl. ZIP), Google Takeout Gemini activity, Claude conversations.jsonl, ShareGPT, and OpenAI fine-tuning JSONL into the JetEngine ai_chat_transcripts CCT โ€” one row per conversation โ€” with format detection, tree/branch linearization, idempotent dedupe, dry-run, batching, and checkpoint resume. Four new tools (conversation_import_detect|run|status|delete), an admin upload/preview page with progress reporting, wp mcp-ai conversation-import detect|import|status|delete, GDPR exporter/eraser + retention coverage, media sideloading, and opt-in memory mining via mine_agent_memory. Five PHPUnit suites. Guide: docs/user-guides/conversation-import.md.

  • โœ… Tool Schema Normalization โ€” PR #5903 (5 files, +162/-14 lines). Tool argument schemas are normalized before being embedded in provider payloads โ€” WP_MCP_AI_DeepSeek_Client, REST /tools schema output, WP_MCP_AI_Tool_Service, and the OOS ChatOrchestrator โ€” preventing provider streaming failures from non-compliant schemas; the registry now logs tool registrations skipped for a missing tool contract.

  • โœ… WP_Error Fatal Fixes โ€” PR #5905 (8 files, +216/-50 lines). Memory tools (mine_agent_memory, retrieve_agent_memory, wake_up_context), the request guard, and the REST chat-memory controller now handle WP_Error returns before array/object access.

  • โœ… nvoos-content-graph v1.0.3 wp.org Resubmission โ€” PRs #5897, #5899, #5904. WPCS fixes for the renamed plugins, wp.org review fixes, readme/README polish, .wordpress-org screenshot assets, and the standalone build ZIP.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.60 across all version-bearing files. Pro addon: 1.1.60. Media Worker: v3.2.0 (unchanged). Tool count: ~300 base + ~1,247 Pro (~1,547 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.59 โ€” August 2026)

August 19, 2026 โ€” Media Worker Crawling & Crawl4AI Facade, Research Tools Hardening, Docs Hub + Tool Registration Fixes

  • โœ… Media Worker Crawling & Crawl4AI Facade โ€” PR #5892 (25 files, +3,556/-16 lines). New /api/crawl/* endpoints in the worker โ€” single-URL Markdown, batched crawling (sync or queued async), and link scans โ€” using a two-tier extraction pipeline: static HTTP fetch โ†’ Readability โ†’ Turndown first (zero browser cost), with the hardened Chromium launcher as an automatic fallback for JS-heavy pages. Every URL passes the shared SSRF guard before fetch or navigation. A Crawl4AI-compatible facade (/api/crawl4ai/*) lets the plugin's run_crawl4ai_job remote mode target the worker as a drop-in Crawl4AI replacement, plus an LLM-based extraction utility (src/utils/llm-extract.js) for structured page data. Worker bumped to v3.2.0. Toolkit memory estimate now accounts for the worker sidecar (docs/features/TOOLKIT_MEMORY_TRACKING.md). Plan: 031-media-worker-crawl4ai-integration-plan.md.

  • โœ… Research Tools Multi-Provider Hardening โ€” PR #5893 (22 files, +2,728/-155 lines). semantic_content_search now resolves embeddings through the shared embedding-provider abstraction (OpenAI, Gemini, Ollama, DigitalOcean) independent of the assistant's chat provider, falls back to keyword search when unconfigured (fallback_mode: "keyword"), and skips stored vectors from mismatched models. New Gemini embedding provider (includes/services/embedding/class-wp-mcp-ai-embedding-provider-gemini.php). deep_research validates non-empty completions, falls back to reasoning_content for reasoning-only models, retries finish_reason: length with a doubled budget, walks the provider chain, and never caches empty reports. Two new read-only base tools: list_terms + list_taxonomies. New test suites: test-tool-deep-research.php, test-tool-semantic-content-search.php, test-tool-list-terms.php, test-tool-list-taxonomies.php, test-mempalace-phase3-embedding-providers.php.

  • โœ… Docs Hub Rebuild & Broken-Link Suggestions โ€” PR #5894 (9 files, +708/-54 lines). The copy-in-place updater bypasses Plugin_Upgrader, so upgrader_process_complete never fired and Docs Hub caches went stale after updates. The updater now fires wp_mcp_ai_plugin_updated after every successful in-place update; Docs Hub 0.4.1 reacts with a cache clear + async rebuild (cached remote content preserved) plus an admin_init version-mismatch guard for manual replacements/restores. Broken-link detection now resolves relative links against the slug map (fixing the "626 broken links" false positive on remote-only indexes); suggestions are case-insensitive with confidence clamped to [0.3, 1.0]. New tests: test-rebuild-job.php, test-indexer.php.

  • โœ… Tool Registration & QA Infrastructure โ€” PR #5895 (44 files, +1,151/-207 lines). Legacy-format tool classes (pre-interface) are transparently wrapped (WP_MCP_AI_Legacy_Tool_Wrapper + WP_MCP_AI_Tool_Legacy_Definition trait); ~32 previously-orphaned base tool files are now registered; a new wp_mcp_ai_tools_init action gives side-loaders (e.g. includes/orchestration-init.php) a late registration point; the registry tracks skipped tools in unavailable_tool_slugs. QA container memory limits raised (tests/qa/docker/docker-compose.qa.yml) and bin/install-test-plugins.sh hardened.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.59 across all version-bearing files. Pro addon: 1.1.59. Media Worker: v3.2.0. Tool count: ~300 base + ~1,243 Pro (~1,543 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 52.

๐Ÿ†• Latest Updates (v1.1.58 โ€” August 2026)

August 18, 2026 โ€” Composio Connect, OOS Runtime Consolidation, Content Graph Rename

  • โœ… Composio Connect Integration โ€” PR #5889 (29 files, +5,318/-2 lines). New addons/pro/includes/composio/ subsystem bridges WordPress to the Composio MCP gateway: OAuth connection flow with state nonce (WP_MCP_AI_Composio_Auth_Handler), API client (WP_MCP_AI_Composio_Client), trigger bridge (WP_MCP_AI_Composio_Trigger_Bridge), and signed webhook controller (WP_MCP_AI_Composio_Webhook_Controller). Six new beta tools โ€” composio_list_tools, composio_get_tool_schema, composio_list_connected_accounts, composio_create_connect_link, composio_execute_tool, composio_manage_triggers โ€” plus remote-sites admin and metabox panels (connected-apps badge). 4 test classes (+887 lines). Full details: docs/composio-connect.md, docs/toolkits/composio-connect.md.

  • โœ… OOS Runtime Consolidation Phases 0โ€“5.8 โ€” PR #5881 (8 commits). The OOS engine reaches parity with the legacy path: Phase 0โ€“2 parity foundations (includes/bootstrap/oos-bridge.php, tool-surface + security-gate contracts), Phase 3 event-sourced session log (SessionLog/SessionEvent/SessionTelemetry + observer), Phase 4 shadow mode (includes/oos/ parallel parity runs serving the legacy result; wp mcp-ai oos parity CLI) + canary routing (per-assistant _wp_mcp_ai_engine opt-in), Phase 5 scoped tools (ToolScope) + compaction seam (CompactionProvider) + Pro composition & child binding (addons/pro/includes/composition/), and Phase 5.8 telemetry single-path. Full details: docs/project/proposals/029-oos-orchestration-runtime-consolidation-implementation-plan.md.

  • โœ… Graphify Standalone Plugins โ†’ Content Graph โ€” PR #5890. plugins/nvoos-graphify โ†’ nvoos-content-graph (v1.0.2), nvoos-graphify-ai โ†’ nvoos-content-graph-ai (v1.0.2), nvoos-graphify-ai-platform โ†’ nvoos-content-graph-ai-platform (v1.0.2), with matching build/sync workflow renames and bin/build-*-content-graph*.sh scripts. The addons/graphify/ knowledge-graph addon is unchanged.

  • โœ… Security Center wp.apiRequest Fix โ€” PR #5887 (1 file, +8 lines). The security tab's inline scripts (posture refresh, IP tests, snapshot restore, compliance export, self-test) call wp.apiRequest() but wp-api was never enqueued there. Now enqueued when ?tab=security is active. See docs/history/2026/fixes/security-center-wp-api-request-fix.md.

  • โœ… deepmerge-ts CVE-2026-40345 โ€” PR #5888 (4 files, +30/-6 lines). Override pinned in addons/media-worker/package.json and addons/pro/package.json.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.58 across all version-bearing files. Pro addon: 1.1.58. Media Worker: v3.0.0 (unchanged). Tool count: ~265 base + ~1,243 Pro (~1,508 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.

๐Ÿ†• Latest Updates (v1.1.57 โ€” August 2026)

August 15, 2026 โ€” Updater Rework, Hermes Async Chat, Provider Detection Fix

  • โœ… Plugin Updater: Base-Only Updates & In-Place Install โ€” PR #5871 (5 files, +530/-266 lines). New base-only update flow for wp.org installs: check_for_base_update() plus the wp_mcp_ai_check_base_update / wp_mcp_ai_start_base_update AJAX handlers power a new "Base Version" panel in Settings โ†’ Advanced, resolving the GitHub base package (ASSET_BASE pattern, incl. legacy mcp-ai-wpoos-base-* naming) so base installs can update without upgrading to complete. Installation reworked from Plugin_Upgrader to copy-in-place (replace_plugin_from_zip()): the live plugin directory is never renamed, a backup snapshot is restored on failure, and base โ†’ complete upgrades deactivate a separately installed Pro addon to avoid double-loading. Pro version now read from the plugin header (get_pro_installed_version(), constant fallback), fixing drift in the imaging admin page and Pro CLI status. Full details: docs/features/plugin-updater.md, docs/history/2026/fixes/base-update-path-fix.md.

  • โœ… Hermes WebUI Chat โ€” Async Submit/Poll โ€” PR #5872 (2 files, +15/-7 lines). hermes_chat submits via /api/chat/start and polls /api/chat/stream/status instead of a blocking request: runs keep executing server-side if the MCP client drops mid-run, HERMES_CHAT_TIMEOUT expiry returns status: "still_running" with the stream_id, and approval gates are answered with the configured HERMES_APPROVAL_MODE choice (ask leaves it pending). Answer extraction fixed for live WebUI payload shapes. bin/README.md updated.

  • โœ… Fleet Operator Agent Context โ€” PR #5873 (18 files, +574 lines). New addons/fleet-operator/.context/ tree: addon conventions, Hermes ops, MCP integration, design content, wp-plugin-dev rules, 6 operator roles (analyst/architect/developer/product-manager/qa/scrum-master), active/archive scratch areas, and task/memory templates.

  • โœ… Service Status AI-Provider Detection โ€” PR #5874 (2 files, +168/-20 lines). Provider detection now resolves credentials through WP_MCP_AI_Credential_Resolver (plugin settings, WP 7.0 Connectors, environment variables, PHP constants) with a merged-settings fallback for early bootstrap; Ollama remains keyless. New test suite tests/test-service-status-provider-detection.php. See docs/history/2026/fixes/service-status-provider-detection-fix.md.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.57 across all version-bearing files. Pro addon: 1.1.57. Media Worker: v3.0.0 (unchanged). Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.

๐Ÿ†• Latest Updates (v1.1.56 โ€” August 2026)

August 14, 2026 โ€” Media Worker Multi-Tenancy & Scale (v2.4.0 โ†’ v3.0.0), Worker Routing, Hermes Tooling

  • โœ… Media Worker Multi-Tenant Shared Worker Mode โ€” PR #5866 (21 files, +1,349/-304 lines). SITE_TOKENS JSON map switches the worker into per-site isolation: every /api/* request must carry a token belonging to a known site (fail-closed with AUTH_MODE=strict), and temp files, job queues, and rate limits are namespaced per site slug via the new src/utils/site-paths.js. Per-site rate-limit overrides (RATE_LIMIT_*_<SITE>), SITE_TOKENS_PREVIOUS rotation overlap, audit logs tagged site=<slug>. Specs: 026-media-worker-multi-tenancy-sidecar-proposal.md and 027-media-worker-multi-tenancy-phase2-spec.md. (PR #5866)

  • โœ… Media Worker Phase 2 โ€” Per-Site Provider Keys & Observability โ€” PR #5868 (8 files, +366/-50 lines). SITE_PROVIDER_KEYS JSON map resolves per-tenant AI provider credentials before falling back to the shared pool (PROVIDER_KEYS_STRICT=1 disables the fallback); tenants.usage per-site provider usage counters; grouped temp TTLs (TEMP_TTL_UPLOAD/VIDEO/BROWSER/DOC) with storage stats; cluster-mode boot warnings and a k6 load-test kit under addons/media-worker/bin/load-test/. (PR #5868)

  • โœ… Media Worker Phase 3 โ€” Scale Without Breaking Changes (14 files, +602/-63 lines). Worker bumped to v3.0.0. W1: per-blog worker tokens on WordPress multisite (additive option chain in the sidecar trait). W2: new WP_MCP_AI_Media_Worker_Usage_Reporter (includes/class-wp-mcp-ai-media-worker-usage-reporter.php) โ€” daily cron snapshots tenants.usage into an option and fires wp_mcp_ai_media_worker_usage_updated (opt-in, off by default). W3: SITE_TOKEN_<SLUG> / SITE_PROVIDER_KEYS_<SLUG> env-var merges over the JSON maps (env wins). W4: opt-in Redis rate-limit store (RATE_LIMIT_REDIS=1 + rate-limit-redis optional dep) for PM2 cluster mode. W5: PROVIDER_KEYS_FILE hot-reload with atomic replace and malformed-update rejection. W6 revised: permissive-mode boot notice only โ€” the strict-path default flip is deferred (open Q5). W7: manual Velocity deploy workflow. 59 unit tests passing. Plan: 028-media-worker-phase3-proposal.md.

  • โœ… Worker Routing Expansion (4 PRs, +2,370/-408 lines). Document generation (Word/Excel/PDF merge/watermark), OCR, video frame extraction, health charts, email (Nodemailer/MJML), QR/translate/PDF-extract, image vectorization, Prettier, and FFmpeg now route through the connected worker with local fallbacks unchanged; Pro settings page lists worker-routed packages. New addons/media-worker/bin/probe-wordpress.php probes the WordPress side (connectivity, tokens, package availability).

  • โœ… Zero-Downtime Token Rotation & Canvas v3 โ€” PRs #5864, #5865. WORKER_API_TOKEN_PREVIOUS accepted during the rotation overlap window; Canvas upgraded to v3 napi prebuilds for compiler-free installs on managed hosts. Cloudways readiness hardening (endpoint test script, queue/route resilience) โ€” PR #5863. Live data/PDF route bug fixes โ€” PR #5867.

  • โœ… Hermes WebUI MCP Server, SSH Bridge & Skill Sync โ€” PR #5862 + 3 follow-ups (8 files, +788/-13 lines). bin/hermes-mcp-server.js drives a Hermes agent from Zed as a stdio MCP server: serialized WebUI logins, session cookie + synchronous chat, tools hermes_list_sessions / hermes_chat / hermes_session_detail / hermes_sync_skills. bin/mcp-bridge-ssh.js + bin/utils/fake-ssh.js add the SSH bridge; bin/hermes-skill-sync.js / bin/sync-skills-to-hermes.js mirror the repo .agents/skills/ tree into the agent (idempotent upsert + prune); env-file parser hardened. Zed Hermes Console profile added to .zed/settings.json.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.56 across all version-bearing files. Pro addon: 1.1.56. Media Worker: v3.0.0. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15. Addon count: 26. Bundled skills: 74 base + 41 Pro. Coding-time agent skills: 51.

๐Ÿ†• Latest Updates (v1.1.55 โ€” August 2026)

August 13, 2026 โ€” MCP Agent Compatibility, Fleet Operator, Media Worker Hardening, Connection Pooling

  • โœ… MCP Agent Compatibility & Tool Reliability โ€” PR #5859 (8 files, +1,435/-32 lines). JSON-RPC errors now return HTTP 200 with the error envelope so client SDKs that drop non-2xx bodies relay tool errors instead of leaving agents hanging (auth/permission failures and pre-dispatch guards keep real HTTP statuses; filter wp_mcp_ai_mcp_error_http_status). Legacy MCP HTTP+SSE transport added for SSE-only clients (Accept: text/event-stream or ?stream=true) with a credential-bound session handshake from GET /mcp and responses delivered as event: message on the GET stream โ€” backed by the new WP_MCP_AI_SSE_Session_Store (327 lines), gated by WP_MCP_AI_LEGACY_SSE_ENABLED. Tool rate limiter is now settings-driven (tool_rate_limit_max / tool_rate_limit_window / tool_rate_limit_exempt_tokens) with a security admin section; credential-token traffic exempt by default. GET/HEAD exempt from the request quota so discovery/SSE probe retry loops don't exhaust the hourly budget. Raw cred_* authorization headers (no Bearer prefix) accepted for agent configs that forward headers verbatim (filter wp_mcp_ai_accept_raw_credential_header). Async tool polling bounded at ~45s (15 polls ร— 3s) with inline kick of stuck jobs to stay under Cloudflare 524 timeouts. (PR #5859)

  • โœ… Hermes Fleet Operator Addon โ€” PR #5858 (18 files, +2,587/-8 lines). New addons/fleet-operator/ addon issuing scoped op_ operator credentials with audience binding, expiry, rate limits, and instant revocation so a supervisor agent (Hermes or any MCP/A2A host) can operate the site within an allowlist. Server-side MCP tools/list scoping plus tools/call enforcement and audit attribution via base-plugin hooks; /mcp method enum relaxed so ping and notifications from standard clients reach the JSON-RPC handler. Ships admin page, WP-CLI commands, Hermes config generator, 3-skill nvoos pack (nvoos-approvals, nvoos-operations, nvoos-site-context), runbook (docs/operations/fleet/hermes-operator-setup.md), and PHPUnit coverage (406 lines). (PR #5858)

  • โœ… Media Worker v2.2.0 Security Hardening โ€” PR #5857 (22 files, +1,247/-215 lines). Nine security controls: timing-safe X-Site-Token auth middleware, SSRF guard with OWASP controls (src/utils/safe-url.js, 248 lines), sandboxed Puppeteer launcher, express-rate-limit global + per-route-group limits, Helmet headers, split health endpoints with real capability detection, structured request logging (no secrets), graceful shutdown, and unit tests. Bumped to v2.2.0 with helmet ^8 and express-rate-limit ^7.5. Plugin sidecar: WP_MEDIA_WORKER_TOKEN constant now takes priority over the option; settings page shows constant mode, warns on cleartext URLs, and links the Velocity guide. New Cloudways Velocity setup guide (docs/operations/deployment/media-worker-velocity-setup.md), .env.example, and CI workflow. (PR #5857)

  • โœ… Media Worker Subtree Sync โ€” PR #5856 (4 files, +56/-2 lines). New sync-media-worker.yml GitHub Action mirrors addons/media-worker/ to the standalone nvdigitalsolutions/mcp-ai-wpoos-media-worker repo on pushes to main/alpha-working. Folder-level .gitignore keeps node_modules out of the standalone repo history; addon README doc links switched to absolute URLs that resolve after the split. (PR #5856)

  • โœ… Database Connection Pooling Stance (Proposal 023) โ€” PR #5855 (16 files, +2,572/-62 lines). Wave 1: Action Scheduler fallback enqueue gated when the RabbitMQ worker is active; concurrency guard slot tracking made atomic (Redis wp_cache_incr with InnoDB INSERT โ€ฆ ON DUPLICATE KEY UPDATE fallback); new mcp_ai_concurrency_slots table with daily cleanup cron. Wave 2: PDO persistent connection support in the Graphify remote SQL driver; DB polling cron gated behind the RabbitMQ transport preference; queue worker batch size configurable (--batch-size=N + filter); Site Health checks for MySQL pool, queue depth, and RabbitMQ health. RabbitMQ admin UI: section registered with settings registry, view added to Orchestration tab navigation, broken render() fixed. Full spec: docs/project/proposals/023-database-connection-pooling-stance.md. (PR #5855)

  • โœ… PostCSS 8.5.26 โ€” GHSA-6g55-p6wh-862q (1 file, +2/-2 lines). postcss minimum bumped to >=8.5.26 in addons/schedule-anything-spa/package.json. Version constraint only.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.55 across all version-bearing files. Pro addon: 1.1.55. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26. Bundled skills: 74 base + 41 Pro. Total coding-time agent skills: 51 (20 wp-* + 30 design-* + 1 mcp-ai-wpoos-plugin).

๐Ÿ†• Latest Updates (v1.1.54 โ€” August 2026)

August 12, 2026 โ€” Security Fixes, Async MCP, Skill Enhancements, README Maintenance

  • โœ… PostCSS CVE-2026-69153 โ€” PR #5850 (2 files, +4/-4 lines). postcss minimum version bumped to 8.5.23 in package.json overrides across affected addons. The CVE (high severity) allowed crafted CSS to trigger unexpected behavior in the PostCSS plugin chain. No functional changes โ€” version constraint only. (PR #5850)

  • โœ… MCP Async Tool Response Handling โ€” PR #5845 (1 file, +111 lines). Fixed tools/call endpoint dropping async tool responses. The handler was not waiting for deferred/promise-based tool execution results, causing silent failures for long-running tools (video generation, deep research, batch OCR). Now correctly awaits and serializes async results. (PR #5845)

  • โœ… Plugin Updater Integrity Check v2 โ€” PR #5846 (1 file, +16/-2 lines). Follow-up hardening to the v1.1.52 post-install integrity check: fixed a false-positive on the bridge/ directory path caused by stale PHP stat cache, added clearstatcache() after every file check to force fresh filesystem reads, and handled a main-file rename edge case where the old filename persisted in cache. (PR #5846)

  • โœ… API Key Merged-Settings Fix for Research Tools โ€” PR #5852 (20 files, +37/-33 lines). deep_research, web_search, semantic_content_search, semantic_context_search, retrieve_agent_memory, recall_memory, wake_up_context, and 13 other tools were reading API keys from get_option('wp_mcp_ai_api_key') directly instead of using the merged credentials system. This meant per-assistant and per-provider API key overrides were silently ignored for all research operations. All 20 tools now use WP_MCP_AI_Credentials_Manager::get_merged_credentials(), which respects the provider โ†’ assistant โ†’ global fallback chain. (PR #5852)

  • โœ… Design Skills Audit & Enhancement โ€” PR #5847 (61 files, +7,971/-57 lines). Comprehensive enhancement of all 22 existing design-* coding-time agent skills with detailed operational instructions, multi-step workflow guidance, cross-references to related skills, and specific MCP tool-calling patterns. 7 new pro-toolkit skills created:

    • design-ai-assistant-admin โ€” manage AI assistants, model configs, provider setup, peer mesh networking

    • design-crm โ€” complete CRM pipeline (leads, deals, companies, contacts, BANT/MEDDIC scoring)

    • design-project-management โ€” projects, tasks, sprints, events, task plans, PM workflows

    • design-communications โ€” multi-channel messaging (SMS, email, WhatsApp), contacts, delivery tracking

    • design-services โ€” service components, dependency tracking, approval workflows

    • design-team-management โ€” organizational teams, professions, role assignments

    • design-vault โ€” encrypted vault for passwords, secure notes, payment cards, digital identities

    • design-security-ops โ€” security operations, audit logging, posture management Total coding-time skills: 44 (22 wp-* + 22 design-*). (PR #5847)

  • โœ… OKF YAML Frontmatter Compliance โ€” PRs #5844, #5849 (65 files combined). Added missing type: Skill frontmatter field to all 22 design-* skills โ€” required by the OKF v0.2 trust-signal specification for concept categorization (PR #5844, +68 lines in 45 files). Fixed YAML frontmatter spec compliance violations in 9 design skills where duplicate top-level keys and invalid field structures violated the OKF v0.2 schema (PR #5849, -100 lines in 20 files). All 44 skills now pass OKF v0.2 frontmatter validation.

  • โœ… README TOC Anchor Fixes โ€” PR #5853 (2 files). Fixed broken TOC anchor links caused by Unicode emoji rendering differences between GitHub's markdown parser and the anchor generator. VS16-based emojis (๐Ÿชฒ๐Ÿ›๐Ÿ›’๐Ÿ“Š) and U+26xx/U+27xx symbols (โš ๏ธโšกโœ…) now generate correct, clickable anchor links in the Table of Contents. (PR #5853)

  • โœ… Stale Build Artifacts Removal โ€” PR #5851 (30 files). Removed stale v1.1.52 build ZIPs and compiled assets that were superseded by v1.1.53 builds. (PR #5851)

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.54 across all version-bearing files. Pro addon: 1.1.54. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Bundled skills: 67 base. Total coding-time agent skills: 44 (22 wp-* + 22 design-*).

๐Ÿ†• Latest Updates (v1.1.53 โ€” August 2026)

August 12, 2026 โ€” Shared Analytics Service, Circuit Breaker Hardening, Agent Skills Sync, SSE Fixes

  • โœ… Shared Analytics Service โ€” PR #5836 (18 files, +2,489 lines). New unified analytics subsystem (addons/pro/includes/analytics/) consumed by all NV oOS Pro toolkits. 7 platform adapters: Meta (Facebook + Instagram), Twitter/X, LinkedIn, TikTok, WooCommerce, Google Analytics 4, and Cloudways monitoring. 5 immutable DTOs (Account, Post, Metric, TimeSeries, Report) with strict coercion and WP_Error validation. Cross-platform normalization maps platform-specific metric names to a unified schema via WP_MCP_AI_Metric_Normalizer. Smart caching with transient-based per-data-type TTLs and cache stampede prevention via WP_MCP_AI_Analytics_Cache. Token-bucket rate limiter per platform via WP_MCP_AI_Analytics_Rate_Limiter prevents API exhaustion. Extensible adapter pattern โ€” single WP_MCP_AI_Analytics_Adapter_Interface, register new platforms via $service->register_adapter(). MCP server registration in the Pro toolkit fleet. Site Health integration for analytics health checks. All 8 phases complete (DTOs โ†’ Adapters โ†’ Service โ†’ Tools โ†’ Migration โ†’ Admin UI โ†’ MCP Server โ†’ Site Health). Design Stack skill: design-analytics-reporting. (PR #5836)

  • โœ… Circuit Breaker & Execution Pipeline Hardening โ€” PR #5839 (12 files, +384/-42 lines). Circuit breaker protection added to all remaining AI provider clients that lacked it โ€” now active on all 15 first-class providers with configurable failure thresholds and cooldown periods. Concurrency guard (WP_MCP_AI_Concurrency_Guard) wired into the execution pipeline to prevent overlapping destructive operations across the full tool execution lifecycle. Cost tracker (WP_MCP_AI_Cost_Tracker) per-operation cost estimation now enforced at the pipeline level, not just at the provider client boundary. Backpressure signals from concurrency guard and cost tracker now feed into the agentic loop's iteration budget, automatically throttling tool calls when system load is high. Plugin updater no longer shows base-only UI after upgrade to complete (base+Pro) package. Silent build asset failure now surfaces a clear error when the complete build asset is missing from a GitHub release. (PR #5839)

  • โœ… Agent Skills Sync & Discovery โ€” PR #5842 (1 file, +78/-24 lines). sync-agent-skills command now syncs project-owned design-* skills alongside the existing wp-* skills. The 22 new design-* coding-time agent skills (design-analytics-reporting through design-video-creation) are now auto-discovered by the Zed editor alongside the wp-* WordPress development skills. New mcp-ai-wpoos-plugin bundled skill covering complete NV oOS plugin operational guide (setup, assistant creation, MCP bridge tokens, API key bridging, Docker/WSL2 troubleshooting). Base bundled skills count increased from 45 to 67. (PR #5842)

  • โœ… SSE Stream Backoff & Rate-Limit Fixes โ€” PR #5841 (2 files, +18/-6 lines). SSE backoff counter now properly resets between successful stream reconnections, preventing unnecessary progressive delays. Rate-limit counter correctly cleaned up after stream termination, preventing false throttling on subsequent connections. (PR #5841)

  • โœ… Load Guard Fatal Error Fix โ€” PR #5840 (1 file, +3/-3 lines). Fixed WP_MCP_AI_Load_Guard calling private count_active_jobs() method, causing a fatal error on PHP 8.1+ when strict visibility enforcement is enabled. Now calls the public get_active_job_count() accessor instead. (PR #5840)

  • ๐Ÿ“š Documentation Catch-Up (this release) โ€” CHANGELOG v1.1.53 entry documenting Shared Analytics Service, circuit breaker hardening, skills sync, SSE/load guard fixes, and all changes from PRs #5836โ€“#5842 that were missing from the v1.1.52 entry. README updated with v1.1.53 highlights and "What's New" section. CLAUDE.md updated: Paper Store section expanded with remote/REST/discovery details, bundled skills count corrected (45โ†’67), circuit breaker/backpressure added to Security Infrastructure, Shared Analytics Service section added, context file references added for new docs. AGENTS.md updated: bundled skills count (45โ†’67), coding-time skills count (22โ†’44). Six .context/ files updated with August 2026 review dates and content: conventions.md (tool counts, analytics directory), tool-registry.md (list_mcp_tools, design-system preset), security-checklist.md (circuit breaker, post-install integrity check), rest-api.md (Paper Store REST endpoint), pro-vs-base.md, and .context/README.md.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.53 across all version-bearing files. Pro addon: 1.1.53. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Bundled skills: 67 base (up from 45).

๐Ÿ†• Latest Updates (v1.1.52 โ€” August 2026)

August 11, 2026 โ€” Paper Store Remote, CPT Auto-Discovery, Design System Preset, Integrity Check

  • โœ… Paper Store Remote Site Support โ€” PR #5835 (13 files, +1,272/-73 lines). All 8 Paper Store tools (paper_store_list, paper_store_read, paper_store_search, paper_store_write, paper_store_update, paper_store_delete, paper_store_import, paper_store_export) now accept an optional connection_id parameter to proxy operations through Remote Site Manager. New REST API controller at mcp-ai/v1/paper-store (697 lines) with full CRUD + search + import/export endpoints for remote site access. New WP_MCP_AI_Paper_Store_Remote trait (96 lines) handles HTTP dispatch and response normalization. New list_mcp_tools discovery tool (234 lines) enables AI agent self-discovery โ€” returns all available MCP tools with JSON Schema parameter definitions, filterable by toolkit namespace and search term. (PR #5835)

  • โœ… Remote Connection CPT Auto-Discovery โ€” PR #5834 (1 file, +16/-4 lines). Plugin-registered custom post types (including paper_store) now appear automatically in remote connection post type access controls via get_post_types(). Users no longer need to manually type each CPT slug, save, and reopen. resolve_post_type_access() mirrors the same discovery logic on form submission. Multi-Site Gateway plan (docs/project/plans/multi-site-gateway-plan.md, 1,429 lines) for hub-and-spoke federation targeting v1.5.0+. (PR #5834)

  • โœ… Design System Tool Preset โ€” PR #5837 (1 file, +108 lines). New design-system preset in WP_MCP_AI_Tool_Presets_Helper with 72 tools across 13 categories: WordPress content (9), image generation (4), image analysis (4), image processing (5), web search/research (5), charts (2), document generation (14), Paper Store (8), video generation (2), video processing (5), social media (3), AI/memory (6), and utility (4). (PR #5837)

  • โœ… Post-Install Integrity Check โ€” PR #5833 (1 file, +74 lines). WP_MCP_AI_Plugin_Updater now runs verify_installation_integrity() after every update, checking 15 critical file paths against the plugin directory before reporting success. Prevents silent update corruption on distributed filesystems (Cloudways) where unzip can drop files without errors. REST controller require_once calls now guarded with file_exists() checks. (PR #5833)

  • โœ… Pro Update Visibility Fix โ€” PR #5832 (1 file, +10 lines). Pro addon update section now visible for wp.org base + standalone Pro plugin installs.

  • โœ… Docker Chmod Suppression โ€” PR #5831 (3 files). Suppressed chmod() warnings during plugin install in Docker environments by checking filesystem constants.

  • ๐Ÿ“š Documentation โ€” 3 new feature docs: Paper Store, Remote Sites & Connections, MCP Protocol Version Negotiation. Updated: Tool Presets System (Design System preset), Plugin Updater (integrity check), DOCUMENTATION_INDEX, QUICK_REFERENCE, README, CHANGELOG.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.52 across all version-bearing files. Pro addon: 1.1.52. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

๐Ÿ†• Latest Updates (v1.1.51 โ€” August 2026)

August 11, 2026 โ€” Orchestration Gap Remediation, MCP Version Negotiation, Media Worker Security Bumps

  • โœ… Orchestration & Harness Layer Gap Remediation โ€” PR #5830 (28 files, +3,295/-29 lines). Comprehensive audit of AI orchestration and LLM harnessing subsystem against August 2026 industry standards โ€” OWASP LLM Top 10, EU AI Act, NIST AI RMF, MCP/A2A protocols, and OpenTelemetry GenAI conventions. OWASP LLM Top 10 coverage: 20% โ†’ 60%. EU AI Act compliance: 17% โ†’ 67%. Six new classes: WP_MCP_AI_Output_Guardrail (338 lines, OWASP LLM05 โ€” validates LLM responses for PII, credentials, unsafe content before downstream consumption), WP_MCP_AI_Citation_Verifier (295 lines, OWASP LLM09 โ€” cross-references claims against source documents to detect hallucinations), WP_MCP_AI_Model_Integrity_Verifier (274 lines, OWASP LLM03 โ€” supply chain security with blocked model list and TLS verification), WP_MCP_AI_Semantic_Cache (289 lines, two-tier prompt caching: exact-match + embedding-based similarity), WP_MCP_AI_Canary_Deployment (404 lines, progressive model rollout with automatic rollback on threshold breach). Workflow Engine V2 graduated from feature-flag to GA release. Red Teaming scripts: bin/red-team.php (160 lines, 9 probe categories) and bin/red-team.sh (172 lines, 6 attack vectors). Harness init registers Output Guardrail + Citation Verifier by default. Three new docs: Orchestration & Harness Reference (202 lines covering all 10 layers Aโ€“J, protocols, security, observability, and 2026 standards alignment), EU AI Act Compliance Mapping (Articles 13โ€“15, 50, 52), and OWASP LLM Top 10 coverage matrix. OWASP coverage: 20% โ†’ 60% | EU AI Act: 17% โ†’ 67% | Overall: ~65% โ†’ ~82%. All PHPCS checks pass with zero errors. (PR #5830)

  • โœ… MCP Protocol Version Negotiation โ€” PR #5829 (2 files, +123/-3 lines). Older MCP clients (Zed, Claude Desktop, Cursor) rejected the hardcoded 2026-07-28 protocol version. class-wp-mcp-ai-rest-mcp-methods.php (+77 lines) and class-wp-mcp-ai-toolkit-mcp-rest-controller.php (+49 lines) now negotiate the highest version both server and client support, falling back to 2024-11-05 when the client provides no version information. Maintains full backward compatibility. (PR #5829)

  • โœ… Security Bumps โ€” Media Worker โ€” PR #5828 (2 files, +11,728/-3 lines). multer 1.4.5-lts.1 โ†’ 2.2.0 (deprecated 1.x line with multiple DoS vulns patched). nodemailer 8.0.5 โ†’ 9.0.5 (GHSA-p6gq-j5cr-w38f: raw header bypass fixed in 9.0.1). sharp 0.33.0 โ†’ 0.35.3 (libvips CVE-2026-33327 and related CVEs fixed in 0.35.0). No code changes required โ€” all three packages maintain backward-compatible APIs across the version bumps. (PR #5828)

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.51 across all version-bearing files. Pro addon: 1.1.51. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

๐Ÿ†• Latest Updates (v1.1.50 โ€” August 2026)

August 10, 2026 โ€” Media Worker Sidecar, Site Health Fix, NPM Security, BMAD Agent Updates

  • โœ… Media Worker Sidecar โ€” PRs #5822, #5823 (132 files, +6,283/-2,779 lines). New addons/media-worker/ package providing a Docker-based Node.js sidecar that offloads heavy media processing from WordPress. Uses a service cascade pattern with Express routing across 11 handlers: browser (Puppeteer-based automation), code (sandboxed execution), data (transformation/ETL), document (generation/conversion), email (rendering/sending), image (manipulation/optimization), ocr (Tesseract-based), pdf (generation/manipulation), social (cross-platform posting), video (transcoding/extraction), and workflow (pipeline orchestration). Queue module (src/queue.js, 217 lines) with concurrent processing, retry logic, and Jest test suite. Pro integration: WP_MCP_AI_Media_Worker_Settings (256 lines) for admin configuration, WP_MCP_AI_Media_Worker_Client trait (219 lines) for tool-to-sidecar communication. Docker service name to private IP resolution in loopback detection (includes/class-wp-mcp-ai-http-helper.php). docker-compose.yml updated with media-worker service. Pro services updated (Fluent FFmpeg, Language Detection, MJML, Nodemailer, OCR, Prettier, Video Frame Extractor) and tools (export calendar ICS, analyze geospatial, generate health chart, render math equation). Documentation: deployment guide (280 lines) and proposal (237 lines).

  • โœ… Site Health Redeclaration Fix โ€” PR #5824 (1 file). Fixed PHP fatal error from function redeclaration in ensure_site_health_dependencies() inside includes/tools/class-wp-mcp-ai-tool-get-site-health.php. Now guarded with function_exists(). (PR #5824)

  • โœ… NPM Security Fixes โ€” PR #5821 (12 files). Resolved nanoid, js-yaml, and dompurify vulnerabilities across 11+ addon package-lock.json files (chat-spa, cloud-worker, comic-reader, docs-hub, document-editor, media-studio, pro/spa, pro/spa-v2, saas-controller, schedule-anything-spa, tenant-router, toolkit-shell). (PR #5821)

  • โœ… BMAD Agent Editing Conventions โ€” PR #5825 (2 files). Developer and QA agent YAMLs (.bmad/agents/nv-oos-developer.yaml, .bmad/agents/nv-oos-qa-engineer.yaml) updated with code editing conventions for consistent agent behavior during file modifications. (PR #5825)

  • โœ… WPCS Formatting Cleanup โ€” repository-wide. PHPCS fixes applied across all PHP files: tabs, docblock formatting, and code style corrections. No functional changes.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.50 across all version-bearing files. Pro addon: 1.1.50. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

๐Ÿ†• Latest Updates (v1.1.49 โ€” August 2026)

August 8, 2026 โ€” Gemini Model Fix, Update Reactivation, Release ZIP Cleanup

  • โœ… Gemini Model Resolution Fix โ€” PR #5817 (1 file, 2 lines). includes/class-wp-mcp-ai-gemini-client.php โ€” model resolution now uses the correct settings key instead of the deprecated fallback. The old gemini-pro model fallback has been removed; all Gemini model lookups now go through the canonical provider settings path. (PR #5817)

  • โœ… Update Reactivation & Release ZIP Cleanup โ€” PR #5816 (68 files, +164/-18 lines). includes/class-wp-mcp-ai-plugin-updater.php (+152/-18 lines) โ€” update reactivation flow fixed; plugin now correctly handles post-update reactivation. Nonce-scoped update actions hardened. .distignore and .gitattributes updated to exclude development-only files (.agents/, .context/, .github/, IDE configs, test fixtures) from release ZIPs. bin/build-plugin-zip.sh updated with new exclusion rules. Minor fixes in OCR service, research report generator, research project tool, video analysis service, and 5 image-analysis tools. (PR #5816)

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.49 across all version-bearing files. Pro addon: 1.1.28. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

August 8, 2026 โ€” Shopify Sync Toolkit Fixes, PHPCS Security, Skill Catalogues (v1.1.48)

  • โœ… Shopify Sync Toolkit โ€” 7 Fixes (PR #5815, 6 files). Fatal error fix: graphql_query() โ†’ graphql() in Admin API connection test. Dead list_by_status code removed โ€” replaced two broken per_page => 1 loops with a direct SELECT COUNT(*) WHERE status = %s. Always-zero analytics count now uses count($edges) from the actual API response. Duplicate get_option() call and redundant $sync_mode assignment removed. Infinite loop risk eliminated โ€” paginated truncate() while-loop replaced with direct DELETE FROM {table} SQL. Double DB query per upsert halved โ€” upsert() now accepts a by-reference &$operation output parameter. Missing orderby/order schema parameters added with sanitization passthrough.

  • โœ… PHPCS CVE-2026-67434. squizlabs/php_codesniffer bumped 3.13.4 โ†’ 3.13.6 in all 3 composer.lock files. Resolves arbitrary code execution via crafted ruleset XML. Dev dependency only โ€” no functional impact.

  • โœ… Default Skill Catalogues. Brave Search Skills and all 22 WordPress Agent Skills added to default skill catalogue for new assistants out of the box.

  • โœ… NVoOS Graphify Standalone Plugins. 3 new standalone plugin ZIPs in plugins/ directory: Graphify v1.0.1, Graphify AI Platform v1.0.0, and Graphify AI v1.0.0.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.48 across all version-bearing files. Pro addon: 1.1.28. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live registry authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

August 7, 2026 โ€” MySQL Connection Exhaustion Fix, Update Cache Bust, Mermaid Security (v1.1.47)

  • โœ… MySQL Connection Exhaustion Fix (Cloudways) โ€” PR #5809 (7 files, +438/-89 lines). Cron system overhaul in includes/bootstrap/cron.php โ€” unified concurrency limits, per-process memory caps, and staggered offset scheduling prevent connection-pool saturation on Cloudways and similar hosts with restrictive MySQL connection limits. Each cron hook now respects a concurrency ceiling and memory budget before forking additional workers. Activation bootstrap (includes/bootstrap/activation.php) updated with resource-aware connection throttling โ€” batched queries with explicit connection release during activation. Service status registry (includes/class-wp-mcp-ai-service-status-registry.php) hardened with transient caching to reduce database round-trips during status polling. Maintenance CPT streamlined. Pro status page: JS improvements (+99 lines), AJAX handler enhancements (+74 lines), dashboard fixes. (PR #5809)

  • โœ… Update Checker Cache Bust โ€” PR #5810 (1 file, +6 lines). ajax_check_update() and ajax_check_pro_update() in includes/class-wp-mcp-ai-plugin-updater.php now delete cached release data before fetching from the GitHub Releases API. Manual "Check for Updates" clicks always return live data instead of the stale 12-hour TTL cache.

  • โœ… Mermaid Security Fixes (1 addon, 2 files). npm audit fix in addons/canvas-toolkit/: mermaid 11.15.0 โ†’ 11.16.1 resolves 5 CVEs (GHSA-3rrr-jr9j-h3q3 prototype pollution, GHSA-6x64-9x62-f2gx CSS injection, GHSA-rhh3-jpg6-66xh radar DoS, GHSA-2v8p-3f2j-5mp7 XY Chart DoS, GHSA-c4c3-pg64-4m4v config prototype pollution). Transitive bumps: dompurify 3.4.12 โ†’ 3.4.13, nanoid 3.3.16 โ†’ 3.3.18. Canvas toolkit dist bundle regenerated. Zero functional impact โ€” mermaid mode is an unused stub.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.47 across all version-bearing files. Pro addon: 1.1.27. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27.

๐Ÿ†• Latest Updates (v1.1.46 โ€” August 2026)

August 5โ€“6, 2026 โ€” Backup & Restore, Plugin Updater, Abilities API, Status Page Fixes, PHPCS Cleanup

  • โœ… Comprehensive Backup & Restore โ€” Proposal 020 (14 files, +3,660 lines). New modular export system with export manager (512 lines) and 11 export providers (8 base + 3 Pro). Base providers: Core Settings (258 lines), Assistants (285 lines), CPTs (319 lines), Custom Tables (394 lines), Federation (253 lines), Addon Options (337 lines), Toolkit Options (282 lines). Pro providers: JetEngine CCTs (329 lines), License keys (190 lines), Remote Sites (324 lines). All implement WP_MCP_AI_Export_Provider_Interface with export() and import() methods. JSON-based export/import with chunked file I/O and progress reporting. Admin UI in Settings โ†’ Advanced expanded by 638 lines with provider checkboxes, export/import buttons, and progress feedback. Subsystem architecture documented in includes/admin/export/README.md (202 lines). Proposal 020 includes proposal (308 lines) and implementation plan (1,249 lines). (PRs #5805, #5807)

  • โœ… GitHub-Based Plugin Updater โ€” 5 PRs, +772 lines. New WP_MCP_AI_Plugin_Updater class fetches release metadata from the GitHub Releases API, compares versions against installed, downloads ZIP artifacts, and installs updates via WordPress Plugin_Upgrader. Base-to-complete upgrade path added to Settings โ†’ Advanced โ€” one-click upgrade from base-only to complete package. Pro addon update support detects and updates the Pro addon alongside the base plugin when bundled; hides redundant Pro updater UI when already included. Core updates use Plugin_Upgrader; Pro updates use direct copy with rollback. Nonce-scoped update actions with proper capability checks. WPCS formatting and phpcs:ignore annotations for pre-existing nonce warnings in updater files. (PRs #5800โ€“#5804)

  • โœ… Abilities API Selective Adoption โ€” Proposal 019 (11 files, +2,364 lines). New includes/abilities/ framework introducing machine-readable plugin operations with JSON Schema contracts for AI agent and MCP tool discovery. Registrar (188 lines) for ability registration/discovery/lifecycle. Bridge (235 lines) connecting abilities to the tool registry for MCP and AI agent discovery. Category Registrar (92 lines) for hierarchical ability grouping. Security Bridge (289 lines) providing capability-based access control per ability. New WP_MCP_AI_Tool_Ability_Interface (61 lines) โ€” contract for tools exposing discoverable abilities. Bootstrap integration at abilities-init.php (49 lines). 5 PHPUnit test files: backward compatibility (139 lines), bridge (279 lines), registrar (190 lines), category registrar (96 lines), mock tool (158 lines). Reference documentation at docs/reference/abilities-registry.md (106 lines). Folder README at includes/abilities/README.md (33 lines). Proposal 019 includes proposal (220 lines), implementation plan (452 lines), and appendix (580 lines). OOS Bridge Wave 2 updated with new tool registry integrations. (PR #5799)

  • โœ… Status Page Fixes โ€” 2 files, +108 lines. Fatal error in Pro status REST endpoint resolved โ€” missing methods in class-wp-mcp-ai-pro-status-ajax.php causing 500 errors on status API calls. JavaScript errors on the status dashboard page fixed with proper i18n text domain consistency. pro-status-page.js (32 lines changed) and pro-status-dashboard-page.php (12 lines changed). (PR #5806)

  • โœ… Knowledge Base Auto-Build. CI workflow auto-builds knowledge-base.zip when playbook files change, ensuring the packaged knowledge base stays current with the profession registry. (PR #5797)

  • โœ… PHPCS Cleanup & Canonical Envelope Compliance. Remaining parse errors from the canonical envelope conversion resolved across tool files. Text domain mismatches (mcp-ai-wpoos vs mcp-ai-wpoos-pro) corrected across Pro tool files. WPCS indentation, alignment, and inline comment fixes applied to 100+ files across base, Pro, and core tool directories. (PRs #5798, #5804)

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.46 across all version-bearing files. Pro addon: 1.1.29. Tool count: ~265 base + ~1,237 Pro (~1,502 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).

๐Ÿ†• Previous Updates (v1.1.45 โ€” August 2026)

August 5, 2026 โ€” Self-Hosted OCR, Embedded v0.2.0, AI Transparency, Graphify, Build Automation

  • โœ… Self-Hosted OCR (Unlimited-OCR + DeepSeek-OCR) โ€” Proposal 018 (17 files, +4,087 lines). New unified vLLM client class supports both Baidu Unlimited-OCR (3B, MIT, 93.23% OmniDocBench) and DeepSeek-OCR (~3B, MIT) via self-hosted GPU infrastructure. Both models share the same integration pattern (vLLM + OpenAI-compatible REST API + NGramPerReqLogitsProcessor). New Pro tools: pro_unlimited_ocr (dedicated long-horizon OCR with structured output modes โ€” text/structured/raw, table extraction, form field detection, Paper Store persistence) and pro_batch_ocr (Action Scheduler batch processing, sync up to 10 docs, async up to 100). Structured extraction service with marker parsing, table/form-field extraction. Existing extract_image_text (Base) and pro_document_ocr (Pro) tools now include unlimited_ocr and deepseek_ocr as provider enum values. Admin settings: two new endpoint URL fields with AJAX Test Connection buttons. OCR client: 640 lines.

  • โœ… Embedded Addon v0.2.0. Backend registry expanded with voice tool calling, OpenMed healthcare tools, and new MCP โ€” CCT Stability, Proposal 016+017 Hardening, API Key Fixes, Docs ๐Ÿ›๐Ÿ›ก๏ธ๐Ÿ”‘๐Ÿ“

  • โœ… CCT Stability Fixes (4 PRs). CCT duplicate registration race condition resolved with database-backed mutex lock (wp_mcp_ai_cct_registration_mutex option). FlowHub CCT duplicate registration corrected โ€” second menu title entry removed, registration guard now checks for existing CCT before attempting re-registration. Base plugin fatal error when lib/core/ is absent (require_once of non-existent PlatformFlushInterface.php) โ€” now guarded with file_exists() check, plugin continues gracefully without core features.

  • โœ… API Key & Provider Fixes (2 PRs). Gemini API key resolution in video services (generate_video_via_veo, generate_video_via_imagen) restored after the v1.1.43 credential split moved keys to wp_mcp_ai_credentials option. Veo fallback chain now correctly forwards async context parameters (task ID, poll URL) between fallback attempts โ€” fixes silent failures when primary model is unavailable. Omni API endpoint URL corrected. Audio completion hook registration fixed.

  • โœ… Security & Architecture Hardening โ€” Proposal 016 (all waves). 277 require_once calls for class-only files wrapped in spl_autoload_register conditional โ€” reduces filesystem stat calls on every request. Autoload class-name heuristic corrected to strip wp_mcp_ai_ prefix from file names before resolution. Repository-wide phpcs auto-fix applied (trailing commas, blank lines, Yoda conditions, short array syntax). Docker QA container vendor mismatch fixed (runs composer install --no-dev inside container). All medium-severity findings addressed (error-log guarding, auto-index detection, debug output gate). 6 low-severity findings resolved (DNS info leak, master-key constant, version-drift alignment, shell-command denylist documentation, orphaned comment removal).

  • โœ… Polling, Queue & Load Balancing Hardening โ€” Proposal 017. Twelve structural weaknesses across three subsystems: polling timeout inconsistencies resolved with unified 30s cap; queue worker deduplication via wp_mcp_ai_queue_lock transient; load-balancer health-check interval standardized to 15s with jitter. Stale .php.bak backup file removed (was shadowing the real class file and causing ambiguous resolution).

  • โœ… Deferred Security Items (#5755, items 5โ€“7). Post meta values escaped via esc_html() before rendering in admin tables. Term description output hardened with wp_kses_post(). REST response field list filtered to remove internal-only debug keys (_debug_trace, _internal_state).

  • โœ… Docs & Ecosystem. FOR_REVIEWERS.md updated for v1.1.43: total tool count ~1,500 (~263 base + ~1,232 Pro), 10 security classes, security posture status refreshed. 16 broken cross-reference links fixed across 5 docs files after the July docs reorganization. Graphify ecosystem audit completed: wp.org Plugin Check compliance verified, migration gap analysis documented, chat shortcode integration plan with NV oOS REST endpoints drafted.

  • โœ… npm Security โ€” Dependency Override Floors. undici >=8.10.0 (5 HIGH + 4 MODERATE CVEs) applied across 11 package.json files. fast-uri >=3.1.4 (CVE-2026-16221 backslash authority confusion) across 3 package.json files. ip-address >=10.4.0 (IPv4-mapped/NAT64 SSRF bypass + CIDR suppression) across 3 package.json files. All 11 package-lock.json files regenerated via npm install --package-lock-only.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.44 across all version-bearing files. Pro addon: 1.1.27. Tool count: ~263 base + ~1,232 Pro (~1,500 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).

๐Ÿ†• Previous Updates (v1.1.43 โ€” August 2026)

July 30โ€“August 1, 2026 โ€” MCP Protocol Upgrade, Security Hardening, OKF v0.2, ICP System, Sync Fixes ๐Ÿ”’๐Ÿ†™๐Ÿ“š๐ŸŽฏ๐Ÿ”ง

  • โœ… Security Hardening v1.1.43 (16 files, 427 additions). SSRF protection across 7 provider connection handlers (blocks cloud metadata endpoints + private IPs). A2A agent URL SSRF guard with federation peer allowlist. SQL table-name regex validation for injection defense. A2A per-assistant agent cards now require authentication (was publicly exposed). Chat SPA /config and /manifest endpoints changed from __return_true to logged_in_permission. Missing args schemas on 7 REST endpoints (voice, security center, chat transcripts, A2A webhook). Guest rate-limiting changed from shared counter to IP-based hashed keys (DoS vector closed). 3 tool capability mismatches corrected (check_site_security, delete_cron_job, purge_cache). Centralized defense-in-depth capability gate in Tool Registry. PHP object injection prevention via safe_unserialize helper with allowed_classes => false. Post meta/term output escaping hardened.

  • โœ… MCP Protocol Upgrade (2026-07-28). Largest MCP revision since launch โ€” stateless core removes sessions and initialize/initialized handshake (SEP-2567, SEP-2575). New server/discover RPC for capability probing. _meta per-request for protocol version, client identity, capabilities. Mcp-Method/Mcp-Name headers on Streamable HTTP (SEP-2243). TTL/cache-scope on tools/list responses (SEP-2549). Legacy client shim preserves backward compatibility. 10 files changed. SSE transport preserved (deprecated per SEP-2596, 12-month off-ramp).

  • โœ… OKF v0.2 Trust-Signal Support. Indentation-aware recursive descent parser replacing flat frontmatter. Inline YAML mappings, nested object lists, flow sequences. Reader: get_trust_tier() (unverified/machine-confirmed/human-reviewed), is_stale(), extended search() with trust filters. Writer: validate_bundle() checks v0.2 fields. New tool: okf_validate_attestation. All 6 existing OKF tools surface trust signals. 15 files, 27 standalone smoke tests. Full backward compatibility with v0.1.

  • โœ… Pro Module Registry (Architecture). wp_mcp_ai_pro_init() decomposed from ~625-line monolithic init function into a PSR-4 module registry. Per-module loading with dependency ordering. Graceful degradation when modules or their dependencies are unavailable. Fixes broken require paths that caused class not found fatals under certain load orders.

  • โœ… ICP System (Pro CRM Phase G). Data-driven Ideal Customer Profile system with 7-dimension scoring engine (Firmographic 25%, Technographic 20%, Intent 15%, Engagement 15%, Buying Triggers 10%, Economic Outcome 10%, Negative Signals 5%) โ€” fit+intent separation, behavioral decay, negative disqualifier scoring. 2 new MCP tools: compute_icp_score (score Company/Lead CPTs or manual data) and manage_icp_profile (CRUD via AI). Admin UI with profile list table and 7-tab weighted editor.

  • โœ… Profession & Playbook Sync Fixes (7 PRs). Playbook: bulk sync silent failures now report {synced, errors} to admin UI. Force-regenerated playbook files no longer incorrectly deleted. Undefined array key orphaned_attachments in playbook stats fixed. Test Model page assistant dropdown restored. Profession: duplicate slug detection in knowledge base JSON files (312โ†’311 entries). Title fallback matching prevents Update from creating duplicate posts when slugs change between versions. Consumed-post collision fix ensures all unique KB entries create distinct posts (resolves 310-published vs 311-KB mismatch).

  • โœ… Hexagonal Architecture Purity (PlatformFlushInterface). Last WordPress reference removed from nvoos/core library. New PlatformFlushInterface contract in lib/core/, WordPress adapter in includes/bridge/. SseHandler now receives flush interface via constructor injection โ€” zero framework dependencies remain.

  • โœ… Phase 3 Operational Security Hardening. Audit logger REST route hook corrected from init to rest_api_init. Security posture signal coverage hardened.

  • โœ… Dependency Updates. wp-coding-standards/wpcs bumped to 3.4.1 for CVE-2026-45293. Dev tooling: replaced hardcoded Intelephense LSP with Phpactor in Zed settings.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.43 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27. Knowledge base: 311 professions (12 industry categories).

๐Ÿ†• Previous Updates (v1.1.42 โ€” July 2026)

July 23โ€“29, 2026 โ€” Security Infrastructure, Framework-Agnostic Core, Status Page, Agent Skills, Algorave ๐Ÿ›ก๏ธ๐Ÿ—๏ธ๐Ÿ“ก๐Ÿค–๐ŸŽต

  • โœ… Security Infrastructure Hardening (4 PRs). 7 new security infrastructure classes: Request Guard (SSE limits, JSON depth, body size, error verbosity, asset version stripping), Security Posture (21 signals, 0-100 weighted score, A-F grading), Destructive Ops Gate (confirmation gate), URL Guard, Concurrency Guard, Cost Tracker, API Key Store. Site Health checks for cron + security posture. 13 new security unit tests covering API key encryption, auth split-brain, break-glass, credentials expiry, destructive ops, rate limiting, SSE auth/CORS/rate limiting, SSRF protection, tool scope sanity, URL guard, and validated upload.

  • โœ… Security Defaults & Headers Hardening. CORS configurable origin control (new cors_restricted posture signal, weight 5). Auth brute-force protection with rate limiting (new auth_brute_force_on signal, weight 4). Error verbosity three-tier filtering Safe/Moderate/Debug (new error_verbosity_safe signal, weight 4). Request body size enforcement (new body_size_limited signal, weight 3). OAuth token lifetime admin control, guest scope docs, SSE CORS filter, webhook secret indicator. DICOM PHI auto-redaction filter. Asset version stripping. Centralized exception guard.

  • โœ… Security Dashboard Posture Signals. Dynamic signal count replaces hardcoded 17. Accurate audit-log empty-state text. CORS origin preview in header tool. Production hardening guide with WAF/OAuth/DICOM checklist.

  • โœ… Framework-Agnostic Core (lib/core/). nvoos/core package with Hexagonal Architecture (Ports & Adapters), PHP 8.1+, separate composer.json. 32 domain contracts covering chat, caching, content, cost tracking, cron, email, events, files, HTTP, memory, models, OCR, providers, speech, streaming. 21 WordPress adapters. ChatOrchestrator with RateLimiter + SemanticCompressor. ProviderRouter (12-provider routing). Framework-agnostic ToolRegistry + SkillRegistry. 109 tools migrated to nvoos/core format. 5 chat parity gaps closed: finish_reason handling, prompt caching, input sanitization, vision image processing, transcript store contracts.

  • โœ… Status Page & Incident Communication (Pro). Maintenance window CPT with REST CRUD, frontend banner + countdown timer, email/webhook/channel broadcast notifier. Incident CPT with phase state machine, phase-aware notification dispatcher, incident-to-lesson bridge. 4 new AI tools: get_service_status, create_incident, update_incident, resolve_incident.

  • โœ… Agent Skills & BMAD Agents. 21 coding-time agent skills (.agents/skills/) for Zed editor covering WordPress plugin development patterns โ€” abilities API, action scheduler, HTML API, i18n audit, plugin architecture, assets loading, bootstrap, cron, DTO, hooks, lifecycle, options storage, presenter, rewrite rules, query cache, REST API, security audit (with reference doc), security deep, security secrets, UTF-8 text. 6 BMAD workflow agent YAML definitions (.bmad/agents/) โ€” analyst, architect, developer, product-manager, qa-engineer, scrum-master โ€” with team composition config. Full .context/ subsystem context system with 8 topic files + 5 templates + active/archive directories.

  • โœ… Algorave Addon. New standalone addon for live coding and algorithmic music generation. 9 tools: export-midi, generate-music-ai, generate-pattern, midi-output, modify-pattern, play-control, sample-manager, strudel-reference, visualizer. Pattern and session CPTs. REST API. Admin settings.

  • โœ… Critical Bug Fixes. Request Guard wrap_dispatch parameter order mismatch with WP >= 6.5 rest_dispatch_request filter (was causing fatal error). Nonce authenticator now accepts _wpnonce query parameter in addition to X-WP-Nonce header (fixes 401 on legacy chat client streams).

  • โœ… Dependency Security Updates. brace-expansion overrides across all addons. js-yaml and postcss security overrides. All npm lock files regenerated. undici pinned to 7.x for Node 20 compat in canvas-toolkit.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.42 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 27 (new: Algorave).

July 20โ€“22, 2026 โ€” OKF Integration, Security Compliance, Playbook Sync, Model Credentials, Dependency Bumps ๐Ÿ“š๐Ÿ”’๐Ÿ”ง๐Ÿ”‘๐Ÿ›ก๏ธ

  • โœ… OKF Integration (Open Knowledge Format v0.1). Pure-PHP YAML frontmatter parser and bundle reader/writer with atomic concept CRUD and conformance validation. 6 new MCP tools: okf_read_concept, okf_browse, okf_traverse, okf_search, okf_write_concept, okf_delete_concept. All 41 bundled skills now OKF v0.1-conformant. Zero new Composer dependencies.

  • โœ… Security Compliance (11 HIGH/P0 Fixes). HMAC-signed policy tokens for professional selector with 1h expiry. Health endpoint auth-gating (public response reduced to status only). ZIP path traversal prevention with realpath() containment. CSRF nonces on Shopify/EZuite/FlowHub sync endpoints. CDN SRI integrity hashes for all 6 libraries. Google Chat OIDC hardening with shared-secret token. Privacy imaging path traversal fix. Autoload fallback cleanup. Version alignment across all package.json files.

  • โœ… Playbook Sync Fixes. Duplicate AJAX handler conflict resolved with nonce-aware cap bypass. CPT class loading guard in remove_duplicate_playbooks(). Silent sync failure detection โ€” sync_all() now returns {synced, errors} surfaced to admin UI. Profession prompt regression fixed after HMAC refactor.

  • โœ… Model Provider Credential Resolution. Model_Service now resolves API keys from all 4 sources โ€” settings, credentials option, environment variables, and PHP constants โ€” via Credential_Resolver.

  • โœ… Dependency Security Bumps. adm-zip >=0.6.0 (ZIP CVE), axios >=1.18.0 (6 CVEs), brace-expansion 1.1.16/2.1.2/5.0.7 across 5 package.json files (CVE-2026-13149). npm audit: 0 vulnerabilities. composer audit: 0 advisories.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.41 across all version-bearing files. Tool count: ~201 base + ~830+ Pro (~1,031+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.

๐Ÿ†• Previous Updates (v1.1.40 โ€” July 2026)

July 12โ€“15, 2026 โ€” Content Format Awareness, Research Pipeline, Settings Credential Split, Model Catalog, Provider Parity, SSE Fixes

  • โœ… Content Format Awareness. New WP_MCP_AI_Content_Format_Helper class (585 lines) detects and preserves Markdown, HTML, and plain text formats across post-modifying and analysis tools. Full 582-line test suite.

  • โœ… Research โ†’ Paper Store โ†’ WordPress Draft Pipeline. All research tools support save_to_paper_store parameter. New create_post_from_research Pro tool. New action hooks. Backward-compatible.

  • โœ… Settings Credential Split. Sensitive API keys moved to separate non-autoload wp_mcp_ai_credentials option with transparent merge via get_settings(). One-time migration. Defense-in-depth with wp_suspend_cache_addition. Settings import/export batch fixes (4 PRs).

  • โœ… Demo Video Pipeline Complete (Phases 0โ€“5). Scripted scene recording with AI voiceover. GitHub Actions CI workflow. 14 narration scripts.

  • โœ… Kimi & DeepSeek Client Parity. Full streaming, tool use, and token tracking parity. DeepSeek and 9 missing providers added to all research tools.

  • โœ… Model Catalog Update (July 2026). 24 files across base + pro. Default bumps: Gemini gemini-2.5-flash โ†’ gemini-3.5-flash, NVIDIA meta/llama-3.1-8b โ†’ nvidia/nemotron-3-nano-30b-a3b, Gemini Live gemini-2.5-flash-live โ†’ gemini-3.1-flash-live-preview.

  • โœ… OOS Engine: SchemaStoreInterface + Tests. New domain contract, entities, tool, and WordPress adapter. 45 new unit and integration tests.

  • โœ… SSE HTTP/2 Fixes. ob_clean() replaces ob_flush(). 524 timeout resolved in Pro SPA v2.

  • โœ… Vector Store Sync No Polling. Status checked only on assistant change and page load.

  • โœ… Validated Tool Slug Allowlist fix (PR #5680).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.40 across all version-bearing files. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.

๐Ÿ†• Previous Updates (v1.1.39 โ€” July 2026)

July 10โ€“13, 2026 โ€” Meta-Harness Auto-Optimization, Agent Delegation Rework, Pro SPA v2 Polish, Tool Presets Refactor, CRM Enhancements ๐Ÿง ๐Ÿ”„๐Ÿ’ฌ๐ŸŽ›๏ธ๐Ÿ“Š

  • โœ… Meta-Harness Auto-Optimization System (All 7 Phases). New self-improving agent infrastructure: Trace Store + Trace Capture for execution telemetry (Phases 0-1); Harness Search Engine for telemetry querying (Phase 2); Pro Coding-Agent Proposer for automated improvement suggestions (Phase 3); Cues, Population, Auto-Deploy, and DSpark orchestration (Phases 4-6); comprehensive test coverage (Phase 7). Enables plugins to observe, analyze, and self-optimize AI agent execution.

  • โœ… Agent Delegation โ€” Major Rework. Delegation now runs inline instead of async for immediate results. REST-based dispatch via chat endpoint replaces no-op role executor. Cron resilience: delegation jobs no longer silently fail without retry. spawn_cron() added after wp_schedule_single_event for instant deferred job execution. Name-based agent resolution in delegate_to_agent tool. Wire-up and tasks drawer fixes in SPA v2.

  • โœ… Pro SPA v2 โ€” Polish & Fixes (20+ PRs). Vector store indicator and slash autocomplete positioning (PR #5666). Double path in vector store preload URL fixed (PR #5665). TDZ crash in CommandAutocomplete resolved (PR #5664). Inline command autocomplete and Zed-style refresh (PR #5663). Cost badges restored in response UI (PR #5661). allowSensitiveTools config propagated to chat-spa, Pro SPA v2, and delegation dispatch (PR #5658). Tool result rich rendering, sidebar auto-refresh, and media cache-busting (PR #5651). Auto-save transcripts on onFinish callback (PR #5650). Attachment support, save button, and storage display (PR #5646). Tasks drawer toolbar button with failedCount badge (PR #5642). Speech/audio tool response envelope fix (PR #5636). Capability flags rendering fix (PR #5635). Usage badges and image+text rendering fix (PR #5634). Sidebar media panel visibility and ID column (PR #5633). Media insert button + speech button reposition (PR #5632). System prompt leak, sidebar empty state, media-to-chat bridge (PR #5631). Tool display and conversation duplication fix (PR #5626). Composer mobile bottom padding (PR #5625). Media grid flexbox layout fix (PR #5624).

  • โœ… Tool Presets Refactor. Essentials layers added, duplication stripped, auto-upgrade for validated variants (PR #5660). Validated tool auto-upgrade no longer causes duplicate names and not-allowed errors (PR #5662). Double tool execution fixed in SSE adapters with media refresh filter clear (PR #5652). tool_call_id fallback for DeepSeek streaming and SPA v2 tool results (PR #5638). Save button added, tool messages without tool_call_id stripped (PR #5648). Tool message block indentation auto-fixed (PR #5638).

  • โœ… CRM Enhancements. CRM cache loop fixed (PR #5645). Upwork rate limiting (PR #5645). Freelance Platforms & External Sourcing configuration enhanced (PR #5639).

  • โœ… Infrastructure. Veo 2.0 deprecated โ€” Gemini Omni Flash replacement (PR #5667): migration path, deprecation detection preventing wasteful 404 fallback loops, user-facing error messages recommending gemini-omni-flash (10s duration, native audio, multi-turn editing), cost calculator updated, tool schema defaults updated, admin settings updated, tests updated. Workflow auth and protected method errors fixed (PR #5659). ZAP scan Docker network isolation resolved (PR #5637). npm packages rebuilt and built assets updated (PR #5653).

  • โœ… Documentation. Comprehensive OpenMed integration plan v2 added (PR #5641).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.39 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, CHANGELOG.md, QUICK_REFERENCE.md, ROADMAP.md, and DOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.

๐Ÿ†• Previous Updates (v1.1.38 โ€” July 2026)

July 10, 2026 โ€” Page Agent Addon, Pro SPA v2 Parity, User Memory Toggle, Tool Enhancements, Workflow Improvements ๐Ÿค–๐Ÿ’ฌ๐Ÿ‘ค๐Ÿ“๐Ÿ”„

  • โœ… Page Agent Addon v0.1.0. New addon at addons/page-agent/ โ€” AI-powered browser page control copilot powered by Alibaba Page Agent (MIT). Gives any WordPress page its own AI agent that can click, type, and navigate via natural language. Runs entirely client-side with no headless browser, Python, or Chrome extension required. Includes shortcode [mcp_ai_page_agent], Elementor widget, REST endpoints, MCP tool bridge, and admin settings page.

  • โœ… Pro SPA v2 โ€” Major Parity & Polish. Voice pipeline, tasks drawer, workflow tracker, and file attachment upload to WordPress Media Library. Tool Shortcuts and Slash Commands drawers for quick tool access. Mobile hamburger sidebar toggle. Speech/audio button fixes using correct ToolsClient REST endpoint. Conversation title improvements and turn count display fix. Button and token NaN fixes. Model sync and auth bypass fixes. Assistant preloading in runtime config to fix sidebar loading.

  • โœ… Pro SPA v2 โ€” UI Polish. Autoscroll fixes (scroll-to-bottom on submit, streaming start, user-at-bottom guard, restored via direct scrollTop instead of scrollIntoView). Viewport height fixes via CSS height chain instead of calc(100vh - Xpx). overflow:hidden on height-chain ancestors. filemtime-based cache-busting across all SPA addons. Lint errors resolved in both chat-SPA and pro-SPA. Deduplicated model selector to prevent React duplicate-key warning. REST route registration fixed and production assets rebuilt.

  • โœ… Per-User Chat Memory Preferences. Users can now toggle chat memory on/off from their WordPress user profile. Individual control over AI memory retention without affecting site-wide defaults. Settings page integration.

  • โœ… create_post / save_post Tool Enhancements. Markdown-to-HTML conversion via new WP_MCP_AI_Tool_Markdown_Converter trait โ€” auto-converts Markdown content to HTML when creating or updating posts. Smart taxonomy suggestions auto-detect relevant categories and tags. Block content corruption fix for non-post post types.

  • โœ… Workflow Blueprint & Schedule Improvements. Existing-content awareness in Content Publisher and Keyword Pipeline blueprints. Blog schedule presets now check for duplicate content before publishing. Readable response generation for workflow schedule result delivery.

  • โœ… SPA Accessibility. Annotation pills made clickable with meaningful labels for screen readers.

  • โœ… Security. OWASP ZAP DAST medium findings triaged as false positives.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.38 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, CHANGELOG.md, QUICK_REFERENCE.md, ROADMAP.md, and DOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers. Addon count: 26.

๐Ÿ†• Previous Updates (v1.1.37 โ€” July 2026)

  • โœ… JetEngine Meta Helper (Universal). Unified REST exposure for all 25 Pro CPTs โ€” show_in_rest and register_post_meta applied across the board. ECA _eca_* and _student_* fields registered in the JetEngine meta registry. MCP routing and error reporting bugs fixed. Load-order fix ensures the helper is available before dependent toolkit inits.

  • โœ… Places Toolkit Enrichment. Two new AI tools โ€” enrich_place_coordinates (batch geocoding) and enrich_place_details (Google Places API enrichment). Social media and booking fields added to the Places CCT schema. CLI bin scripts for batch enrichment operations. HTTrack import hardened: redirect stub handling, coordinate parsing, parent-child linking, and CLI parameter validation.

  • โœ… RabbitMQ Client & Queue Infrastructure. RabbitMQ client wired with queue manager and async tool interception. Queue storage migrated from WordPress options to custom database tables for scalability. Health endpoint for queue monitoring. Dedicated queue worker for background processing.

  • โœ… Multi-Tenant Database Isolation (Phase 0โ€“4 Complete). Phase 0 laid the foundation with database isolation primitives and connection routing. Phases 1โ€“4 delivered query scoping, schema isolation, cross-tenant safety guards, and admin controls โ€” the full isolation stack is now operational.

  • โœ… DSpark Admin UI & Speculative Orchestration. New admin page with settings, threshold configuration, efficiency dashboard, presets, and a hook system for extensibility. Speculative orchestration enhancements with configurable execution strategies.

  • โœ… Crocoblock Design System Addon (All 5 Phases). New standalone addon at addons/crocoblock-ds/. Unified CSS custom properties, preset templates, and admin-controlled theming for JetEngine, JetSmartFilters, and JetFormBuilder. Registered in addon inventory and build pipeline.

  • โœ… Test Coverage โ€” 329 Tools Across 28 Toolkits. 301 previously untested tools now covered by batch tests. 6 previously untested pro toolkits with full coverage. 22 toolkits covered across 7 batch test files. HTTP testing infrastructure for remote tool tests. Docker plugin seed service for integration test coverage. CRM, PM, DietPi, and Cloudways test suites hardened with recursive file search, dependency resolution, and graceful skipping for abstract/missing classes.

  • โœ… Docs Hub Broken Link Detection & Repair Engine. Automated broken link scanning with results table. One-click Accept fix buttons on the detail table. Suggestion engine regression fixed (was producing no suggestions).

  • โœ… SPA Annotation Pills โ€” Accessible. Clickable pills with meaningful labels for screen readers.

  • โœ… CI/CD Hardening. OWASP ZAP DAST security scanning integrated into the CI pipeline. PHP bumped from 8.1 to 8.2 across all CI workflows. QA Docker setup fixed (unnecessary chmod on bind-mounted script).

  • โœ… Webhook & Agentic-Loop Resilience. Proactive agentic-loop context compaction prevents context overflow during long-running agent sessions. Webhook Context Manager enhanced with industry best practices. Sliding window context loss fixed across all 11 webhook controllers. max_history_messages section default normalized to match base settings (8).

  • โœ… Shopify Sync โ€” Catalog API & Minimal Mode. Catalog API sync support for product caching. Minimal sync mode (title, SKU, stock levels only) for fast updates. Price field added to minimal mode payload.

  • โœ… BME Chat History Context Strategy. RAG memory integration for chat history. Settings relocated to General โ†’ Behavior subtab on the new dashboard.

  • โœ… Bug Fixes. Shopify Catalog API silent failures and result reporting. Recurring sync stuck at old interval with missing connection IDs. Sync log batching via deferred writes to avoid per-item DB timeouts. Webhook auto-reply broken by missing Webhook Context Manager require. Import-blueprints and remaining-pro-tools file discovery. Extended-cognition toolkit missing requires for trait and interface. Tool tests: static data providers, constructor mocks, slug overrides, WP_Error returns. js-yaml DoS vulnerability override. ESLint and WPCS compliance across test files and enrichment tools.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.37 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, CHANGELOG.md, QUICK_REFERENCE.md, ROADMAP.md, and DOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers.

๐Ÿ†• Previous Updates (v1.1.36 โ€” July 2026)

June 29 โ€“ July 4, 2026 โ€” EZuite Inventory Sync, Ralph Loop Orchestration, JetBooking/JetAppointment, Moonshot/Z.AI Parity, 45+ Bug Fixes ๐Ÿญ๐Ÿ”„๐Ÿ“…๐Ÿง ๐Ÿ›

  • โœ… EZuite Inventory Sync Pro Toolkit. ERP-integrated inventory sync bridging EZuite ERP with WordPress/WooCommerce. Product pull, inventory query, item create/update, ERP settings, and CLI sync commands. Admin UI with connection selector, field mapping, and sync direction controls. Toolkit registered in Pro addon with auto-discovery.

  • โœ… Ralph Loop CCT Migration & Orchestration. Circuit breaker pattern with configurable failure thresholds prevents cascading failures during cross-environment operations. Execution logger with step-by-step tracking and error reporting. CCT migration tools for safe JetEngine data transfers. Orchestration tools for coordinating multi-step workflows.

  • โœ… JetBooking/JetAppointment Integration (8 Tools). Adapter layer for Crocoblock JetBooking and JetAppointment plugins. 8 new AI tools added to the Calendar Booking toolkit. 4 existing calendar tools enhanced with booking/appointment awareness. Full CRUD for appointments, bookings, and availability queries.

  • โœ… Moonshot AI (Kimi) & Z.AI (GLM) Provider Parity. Both providers upgraded to full DeepSeek-level chat client capabilities โ€” streaming, tool use, token tracking, and error handling. ZAI client service registered in DI container alongside client.baseten. Class loader updated for new provider adapters. WPCS formatting auto-fixed across all provider client files. Provider count now 15 first-class.

  • โœ… Unified Sync Log Manager. Per-item audit trail across EZuite, FlowHub, and Shopify sync toolkits. Sync history with timestamps, status codes, and detailed error tracking. Status dashboards on toolkit settings pages. WP-CLI integration for log querying and export.

  • โœ… Tool Presets Auto-Select & Chips Bar. Selected tools display as clickable chips below the tool selector with proper spacing. +N overflow toggle when too many chips are selected. Tool payload cap raised from 50 to 100 tools per assistant. Method-existence guard against tools lacking get_definition().

  • โœ… HTTrack Cache Support & Place-to-Service Bridge. HTML place import tool now supports HTTrack cache directories for proper mirror parsing. URL backfill for mirrors without hts-cache directory. Place-to-Service bridge auto-creates bookable services during batch place import. Service sharing prevented when source URLs collide.

  • โœ… FlowHub Per-Connection Overview. Remote Sites connection selector added to FlowHub config tab. Per-connection sync controls โ€” run sync for individual connections instead of all-at-once. Proxy support via http_api_curl hook with connection-level proxy resolution.

  • โœ… Generate Default Mapping + Read-Only Sync. One-click default mapping buttons for EZuite and FlowHub field mapping. Read-only sync direction option โ€” pull data without pushing changes back to source.

  • โœ… Web Search 429 Retry. Exponential backoff for rate-limited (HTTP 429) web search requests with configurable retry count and base delay.

  • โœ… wp_mcp_ai_log Global Helper. Centralized logging function available globally, defined in includes/bootstrap/ for availability before class autoloading.

  • โœ… JetEngine CCT Support for Remote WP Connections. Remote WordPress connections can now query and manage JetEngine CCT records โ€” full CRUD support for remote CCTs via the remote_wp_connection tool.

  • โœ… CCT Module API & CRUD Fixes (Cross-Toolkit). Replaced fragile jet_engine()->cct shorthand with canonical Module::instance() across EZuite, FlowHub, and Shopify CCT managers. Standardized CRUD using Factory/ItemHandler APIs. Added table_exists() fallback to is_cct_available() for lazy-init environments. Fixed get_cct_module false negatives when CCT module is active but not yet loaded.

  • โœ… EZuite Sync Fixes. Missing return value with error diagnostics. API field mapping response key mismatch. Remote Sites connections not showing in toolkit settings (2 rounds). CCT auto-registration reading from wrong option key.

  • โœ… FlowHub Sync Fixes. Silent success with 0 records now reports actual counts and errors. Proxy settings now correctly persist in Remote Sites connections. API auth header names corrected. Null CCT module guarded. Dry-run mode uses modules API instead of fragile shorthand. Location ID made optional with primary fallback.

  • โœ… Shopify Sync Fixes. Catalog API-only connections blocked with clear error. CCT registration lifecycle uses explicit sanitize-update cycle. Meta fields populated in CCT registration. Column add_field routed through module->manager instead of raw jet_engine()->cct.

  • โœ… CCT Infrastructure Fixes. Duplicate column errors prevented in ensure_columns across all three toolkits. add_field API replaced with direct SQL ALTER TABLE. Nonexistent get_item_by_slug() replaced with DB query. JetEngine CCT field definitions synchronized when columns missing.

  • โœ… SQLite Meta Cache Explosion Fix. Unbounded meta cache growth on SQLite-backed sites resolved.

  • โœ… masterminds/html5 Case Collision Fix. Class file collision on case-insensitive filesystems (Windows/macOS) resolved.

  • โœ… Base-Version Guard Fix. Guard no longer incorrectly blocks toolkit admin pages in base+pro mode.

  • โœ… HTTrack Import Robustness. URL resolution, redirect filtering, and type classification. File discovery bugs (SKIP_DOTS, isDot, substring skip-dir matching). Hex-encoded filename support. Non-GNU glob compatibility for subdirectory content. Improved mirror root detection.

  • โœ… Necessity Gate & Safety Profile Fixes. Request context crash guarded against missing get_instance(). Safety profile trait autoload fixed โ€” required from interface.

  • โœ… Auto-Select Compute Fix. O(n*m) timeout on assistant edit page resolved.

  • โœ… Tool Chip UI Fixes. PHP parse errors from unescaped double-quotes in inline JavaScript fixed.

  • โœ… Documentation. Comprehensive abilities registration plan (~1,000 tools as WordPress Abilities). Laravel-scale deployment architecture proposal with Graphify ecosystem cross-references. WP.org submission prep (readme, index.php, canonical envelopes, READMEs). Agent context sweep โ€” AGENTS.md, CLAUDE.md, .context/pro-vs-base.md updated. CHANGELOG v1.1.36 section.

  • โœ… Housekeeping. Stale build artifacts and toolkit-addons directory cleaned.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.36 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, CHANGELOG.md, QUICK_REFERENCE.md, ROADMAP.md, and DOCUMENTATION_INDEX.md. Tool count: ~195 base + ~830+ Pro (~1,025+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 15 first-class language-model providers (added Moonshot Kimi & Z.AI GLM at DeepSeek parity).

๐Ÿ†• Previous Updates (v1.1.35 โ€” June 2026)

June 27โ€“29, 2026 โ€” FlowHub + Shopify Sync Pro Toolkits, Necessity Gate Layer J, Local Voice STT, Remote Site Admin Blueprint, Bulk Import, Fixes ๐Ÿช๐Ÿ›’๐Ÿ›ก๏ธ๐ŸŽ™๏ธ๐ŸŒ

  • โœ… FlowHub Inventory Sync Pro Toolkit (PR #5501). 6-tool cannabis dispensary management toolkit. FlowHub Products (flowhub_products) โ€” query by location, category, brand, strain type. FlowHub Inventory (flowhub_inventory) โ€” real-time levels, room/zone filtering, low-stock detection. FlowHub Locations (flowhub_locations) โ€” address, contact, operational status. FlowHub Sync (flowhub_sync) โ€” scheduled sync with webhook support. FlowHub Analytics (flowhub_analytics) โ€” sales trends, top products, category performance. FlowHub Alert Manager โ€” configurable low-stock and compliance alerts. FlowHub Settings (flowhub_settings) โ€” API credentials, sync intervals, notifications. Connection resolver trait. Admin UI toggle on Features tab. Folder README at addons/pro/includes/tools/flowhub/README.md.

  • โœ… FlowHub P1+P2 Enhancements (PR #5502). P1: Proxy support via http_api_curl hook for environments behind forward proxies. P2: CCT auto-registration โ€” inventory data stored in JetEngine tables. Connection auth fixes: API header names corrected; class-name collision with WP_MCP_AI_FlowHub_Client resolved. API key decryption on credential update fixed (PR #5500). location_id made optional โ€” defaults to primary location. Null guard against jet_engine()->cct for sites without JetEngine.

  • โœ… Shopify Sync Pro Toolkit (PR #5502). 5-tool bi-directional e-commerce sync: Shopify Products (shopify_sync_products) โ€” product sync with variant support. Shopify Orders (shopify_sync_orders) โ€” order import with fulfillment tracking. Shopify Inventory (shopify_sync_inventory) โ€” real-time stock sync. Shopify Analytics (shopify_sync_analytics) โ€” cross-platform reporting. Shopify Settings (shopify_sync_settings) โ€” API credential and sync config. Dashboard widget. Connection resolver trait. Admin UI toggle. Tool reference docs at docs/tools/shopify-sync-toolkit.md and docs/tools/flowhub-toolkit.md. Folder README at addons/pro/includes/tools/shopify-sync/README.md.

  • โœ… Necessity Gate Layer J โ€” Irreversibility-Weighted Safety Profiles. Pre-execution safety layer (WP_MCP_AI_Necessity_Gate) scores tool calls by irreversibility risk. Write operations (create/update/delete) assigned risk scores by resource type. Safety profile trait loaded from interface for clean autoload. Request context crash fix: guards against WP_MCP_AI_Request_Context lacking get_instance().

  • โœ… Local Voice Embedded STT (PR #5498). Three pluggable browser-side speech-to-text backends: browser-native Web Speech API, Whisper.cpp (WASM), and Vosk (WASM). Offline-first โ€” STT engines run entirely in the browser with no server dependency. Auto-detection selects the best available backend based on browser capabilities.

  • โœ… Remote Site Administrator Blueprint. New 22-tool CRM-style blueprint remote-site-administrator.json in Site Creator toolkit. Pre-configured with remote_wp_connection, full JetEngine suite (11 tools), JetFormBuilder (2), site admin (4 โ€” install_and_activate_plugin, install_and_activate_theme, update_option, create_post/update_post/delete_post), woo_products, generic_rest_api. Comprehensive system prompt with discoveryโ†’schemaโ†’execution workflow, tool reference, and 8 safety rules. Temperature 0.3, manage_options capability. Auto-discovered by Unified Blueprints page and import_site_creator_blueprint tool.

  • โœ… Places & Calendar Bulk Import Tools (PR #5509). Batch import tools for Places and Calendar Booking toolkits. Places bulk import: batch geocode and store location records. Calendar bulk import: batch create events, appointments, bookings.

  • โœ… CLI site-import Subcommand. wp mcp-ai site-import โ€” multi-phase HTML mirror import for migrating static sites into WordPress. Handles page structure extraction, content mapping, and media sideloading.

  • โœ… Voice Realtime Auto-Detect (PR #5508). WebRTC realtime voice auto-detection โ€” automatically selects WebRTC or WebSocket transport. Duplicate message fix prevents echoed messages. VAD threshold improvements for better voice activity detection.

  • โœ… Remote Connections Fixes (PR #5499). WordPress connection case handling normalized. FlowHub and Printful credential storage fixed โ€” credentials correctly encrypted at rest. Printful connection type added to Remote Sites connection types.

  • โœ… Token-Scoped Assistant Resolution (PR #5497). Token-scoped assistant now preferred over site default in resolver, ensuring bearer-token-authenticated requests use correct assistant config.

  • โœ… User ID Empty Fallback (PR #5495). user_id resolution updated to use empty() instead of isset() for context fallback, fixing zero/empty-string bypass.

  • โœ… Local Credential Token Mapping (PR #5493). Local credential token user ID mapping corrected for consistent identity resolution.

  • โœ… Post Type Name Lengths (PR #5484). Post type names exceeding 20-char WordPress limit now truncated with validation warnings.

  • โœ… OpenAI Image Deprecation Cleanup (PRs #5489-#5491). Removed deprecated DALL-E models. Applied chat model fallback to edit_image_via_responses_api. GPT-5.x chat models for image generation. Defaults and response_format handling fixed.

  • โœ… Documentation. Agent context sweep โ€” AGENTS.md (v1.7), CLAUDE.md (v2.7), .context/pro-vs-base.md updated. CHANGELOG v1.1.35 section.

  • โœ… Housekeeping. Stale 1.1.34 build zips removed (6 files).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.35 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, CHANGELOG.md, QUICK_REFERENCE.md, ROADMAP.md, and DOCUMENTATION_INDEX.md. Tool count: ~195 base + ~810+ Pro (~1,005+ total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative). Provider count: 13 first-class language-model providers (unchanged).

๐Ÿ†• Previous Updates (v1.1.33 โ€” June 2026)

June 20โ€“24, 2026 โ€” WP 7.0 Connectors Credential Integration, nvoos-graphify v1.0.0, Security Fixes ๐Ÿ”Œ๐Ÿงฉ๐Ÿ›ก๏ธ๐Ÿ”’

  • โœ… WP 7.0 Connectors Credential Integration (PR #5458). Credential_Resolver integrated into all 17 AI client get_api_key() methods (Anthropic, Baseten, DeepSeek, DigitalOcean, Gemini, Gemini Live, Google Maps, Hugging Face, Kimi, LM Studio, NVIDIA, OpenAI, OpenAI Realtime, OpenRouter, plus 3 service classes). Fallback chain: WP 7.0 Connectors โ†’ plugin settings โ†’ environment variables โ†’ PHP constants. New get_key_source() / get_key_source_label() methods added to Credential_Resolver. Credential source badges and WP 7.0 Connectors hints rendered in admin settings UI (Settings โ†’ Providers). All 13 provider API key field descriptions updated to mention alternative credential sources. Provider diagnostics now show a Key Source column indicating where each provider's API key originates. Settings health check counts credentials resolved via the Credential_Resolver. 17 Pro addon files updated to use Credential_Resolver::has_credentials() / get_api_key() for provider selection, OCR routing, vector store, embeddings, speech, and performance checks. All PHPCS-clean with zero new errors.

  • โœ… nvoos-graphify v1.0.0 Release (PR #5456). Standalone nvoos-graphify plugin released at v1.0.0 โ€” Plugin Check compliant and ready for distribution. nvoos-graphify-ai plugin released at v1.0.0-dev. Fixed 8 output-escaping errors in Section.php via printf() with esc_attr(). Fixed critical ->prepare() spread-operator bug in Db::listNodes() causing runtime fatals. Renamed vector column โ†’ embedding_vector to avoid MariaDB/MySQL reserved-word conflict; bumped DB version. Fixed snake_caseโ†’camelCase method calls across tools (GetNode, GetNeighbors, QueryGraph, GraphStats), controllers (SyncRemoteSource, REST), and cross-plugin integrations (nvoos-graphify-ai). Guarded missing Webhook driver and fixed Crypto namespace. Added message field to Enricher stub for detectable false-success states. Updated Remote README to reflect stub reality (no drivers, no SSRF, no encryption). Documented actual REST access model: read + guest token for reads, manage_options for export/write.

  • โœ… Security Dependencies (PR #5457). guzzlehttp/guzzle 7.10.0 โ†’ 7.12.1 (CVE-2026-55568, CVE-2026-55767). guzzlehttp/psr7 2.11.0 โ†’ 2.12.1 (CVE-2026-55766). guzzlehttp/promises 2.3.0 โ†’ 2.5.0. undici npm override tightened from >=7.28.0 to >=8.5.0 to match resolved version and prevent downgrades.

  • โœ… npm Security (PR #5438). 29 npm security alerts resolved across 14 packages. undici: TLS bypass (CVE-2026-9697) and cache info disclosure (CVE-2026-9678) โ€” override applied to 11 addon lock files. http-proxy-middleware: CRLF injection (CVE-2026-55603) โ€” override >=3.0.7. nodemailer: raw option bypass (GHSA-p6gq-j5cr-w38f) โ€” bumped ^8.0.9 โ†’ ^9.0.1. webpack-dev-server: HMR interception (CVE-2026-9595) โ€” override >=5.2.5. dompurify: ALLOWED_ATTR pollution (GHSA-cmwh-pvxp-8882) โ€” bumped ^3.4.9 โ†’ ^3.4.11. Fixed critical duplicate overrides key in root package.json that silently discarded all 39 security overrides.

  • โœ… Bug Fix โ€” WP All Import/Export Pro Tools (commit 0de3cdf). Four require_once paths in the Pro bootstrap map (addons/pro/mcp-ai-wpoos-pro.php) were missing -pro- in the filenames, referencing class-wp-mcp-ai-tool-*.php instead of the actual class-wp-mcp-ai-pro-tool-*.php files on disk, causing fatal errors when those tools loaded.

  • โœ… Bug Fix โ€” Tool Status Label Loader (commit 749ffce). Replaced fragile @file_get_contents() with explicit set_error_handler('__return_true') / restore_error_handler() in both copies of load_tool_status_labels() (includes/class-wp-mcp-ai-tool-registry.php and includes/admin/sections/class-wp-mcp-ai-section-tools.php). The @ operator does not reliably suppress warnings across all PHP 8 configurations (e.g. xdebug.scream, custom error handlers), and leaked warnings corrupt MCP JSON-RPC HTTP responses.

  • โœ… Dependency Updates. 15 Dependabot version bumps across the monorepo: Composer (guzzlehttp/psr7 2.11.0โ†’2.12.1). npm/Pro (stripe 14.25.0โ†’22.2.3, csv-parse 5.6.0โ†’7.0.0, p-queue 8.1.1โ†’9.3.0, @puppeteer/browsers upgrade). npm/SaaS Controller (@wordpress/eslint-plugin 25.2.0โ†’25.4.1, zod 3.xโ†’4.4.3, @tanstack/react-query upgrade, wrangler upgrade). npm/Cloud Worker (stripe upgrade, vitest 2.xโ†’4.1.9, @cloudflare/workers-types upgrade). npm/Docs Hub (@typescript-eslint 8.xโ†’8.62.0, @types/nodeโ†’26.0.0). GitHub Actions (codecov/codecov-action 4โ†’7, softprops/action-gh-release 2โ†’3).

  • โœ… Housekeeping. Stale 1.1.31 build zips removed (PR #5437). Stale 1.1.32 build zips removed (6 files). SPA addon ZIPs rebuilt with updated security overrides and dependency bumps. nvoos-graphify standalone ZIP built at v1.0.0. nvoos-graphify-ai ZIP built at v1.0.0-dev.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.33 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, and CHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).

  • โœ… MCP Initialize: Assistant-Scoped Instructions & Model Preferences (PR #5462). Both the base /mcp-ai/v1/mcp endpoint and all 29 Pro toolkit MCP servers now carry the assistant's system prompt, professional role context, model preferences (modelPreferences โ€” supported by Zed, Claude Desktop, Cursor), and knowledge base references in the initialize handshake instead of a generic WordPress site description. serverInfo.name becomes the assistant's display title when an assistant_id is provided. New filter wp_mcp_ai_mcp_initialize_instructions for integrator customization. Zero breaking changes โ€” behavior is identical when no assistant_id is passed. Unix Theory P0-compatible: canonical return envelope and two-gate sanitisation rule unaffected (protocol-layer change only).

  • โœ… Content Format Templates & Featured Image Generation (PR #5433). Content Format Template CPT (mcp_ai_content_format_template) with user-editable blog post templates. New WP_MCP_AI_Content_Template_Engine generates Anthropic-optimised XML-sectioned AI prompts. New WP_MCP_AI_Featured_Image_Service with 3-provider fallback (OpenAI DALL-E โ†’ Google Gemini โ†’ Cloudflare AI) and 5 image styles. Image Generation Provider dropdown on the CPT metabox. Provider settings (model, quality, aspect ratio) now respected instead of hardcoding dall-e-3/hd. AI prompts updated across all schedule presets to instruct image generation before post creation. 5 workflow presets updated with image gen nodes, node reorder, and featured_image_id wiring. Template resolution via Content Template Engine in dispatch_assistant_run. resolve_node_template_variables for cross-node variable passthrough. 5 default templates seeded on activation.

  • โœ… Result Delivery Pipeline (PR #5425). New WP_MCP_AI_Result_Delivery_Service (1,056 lines) routes successful schedule results to 8 delivery channels: email, Slack, Discord, Telegram, SMS, Paper Store, WordPress post, webhook. Per-channel formatting and sending with deliver_success() and deliver_failure() pathways. result_delivery schema added to schedule CRUD. Result Delivery section in schedule edit modal UI. Delivery status appended to run history and result envelopes. Pre-configured Paper Store delivery for 8 research/audit presets. Both success and failure paths now deliver โ€” previously only failures were surfaced.

  • โœ… ECA Document Generation (PR #5423). ECA Consolidate & Add page with document generation tools. PHPCS alignment fixes across ECA admin pages.

  • โœ… Duplicate Posts & Provider Image Fixes (PR #5434). WordPress delivery channel removed from weekly_blog_post_writer and weekly_blog_topic_research presets to prevent duplicate draft posts when the AI already calls create_post during assistant runs. Systemic guard in Result Delivery Service skips WordPress delivery when AI tool calls include create_post or save_post. Provider image settings now properly flow through Content Template Engine and Featured Image Service.

  • โœ… 6 Provider Clients Now Respect Timeout (PR #5431). DeepSeek, Baseten, DigitalOcean, OpenRouter, Kimi, and Cloudflare clients had hardcoded 60-second timeouts ignoring the admin Request Timeout (seconds) setting. All six resolve_timeout() methods now read WP_MCP_AI_Admin_Settings, matching the existing Anthropic/Gemini/Ollama pattern. Kimi retains its provider-specific kimi_timeout override.

  • โœ… Schedule Trigger Stability (PRs #5429, #5430). Trigger crash on rest_do_request() wrapped in try/catch with pre-flight REST server check (PR #5429). User context restored and filters cleaned up in all error paths. display and result_delivery fields added to ajax_get_schedules response for edit modal persistence. sanitize_result_delivery preserves channels wrapper so all consumers read saved delivery config (PR #5430). Chat-channel channel field preserved through sanitize_delivery_channels. ajax_trigger_schedule wrapped in ob_start + try/catch to capture PHP warnings that corrupt JSON. Trigger debug output logged to browser console when WP_DEBUG is on.

  • โœ… Paper Store Delete Confirmation Fix (PR #5432). Hidden inputs added to record delete confirmation form so handle_delete_record() receives required POST fields. handle_delete_collection() updated to read from $_REQUEST for GET-based admin-post.php links.

  • โœ… ECA Settings Menu & Attachment Fix (PR #5421). ECA settings menu placement corrected. Attachment upload crash in ECA admin pages resolved.

  • โœ… npm CI & Jest Resilience (PR #5428). @babel/plugin-transform-modules-systemjs override pinned to v7 (v8 is ESM-only, breaking eslint on Node 18/20). Root package-lock.json regenerated with override applied. jest.config.js probes for setup files at load time with graceful fallback to empty array. jest.setup.js at repo root. || exit 0 on test:coverage for CI. npm ci lockfile sync for chat-spa, media-studio, docs-hub, comic-reader, and saas-controller.

  • โœ… Dependency Updates. 14 safe Dependabot version bumps across docs-hub, cloud-worker, saas-controller, Pro (react 19.2.6โ†’19.2.7, vitest 4.1.5โ†’4.1.9, stripe, workers-types, eslint 8.59.2โ†’8.61.1, php-stubs 6.9.1โ†’7.0.0, mailparser 3.7.1โ†’3.9.9, validator 13.12.0โ†’13.15.35). 8 npm audit CVEs fixed: nodemailer, tar, tar-fs. Security overrides added to 8 addon package.json files. phpoffice/phpspreadsheet lock synced 5.7.0โ†’5.8.0.

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.32 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, and CHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).

June 16โ€“17, 2026 โ€” Media Command Center, Pro SPA v2, Workflow Presets, npm CVEs, Gemini 3.1 Flash ๐ŸŽฌ๐Ÿ’ฌ๐Ÿงฐ๐Ÿ”’๐ŸŽจ

  • โœ… Media Command Center (PR #5402). Top-level "NV Media" admin menu with command center for managing media workflows. Template and preset management. PHPCS cleanup and implode() WP_Error crash fix in the templates tab.

  • โœ… Pro SPA v2 Migration & Rich Rendering (PRs #5401, #5412, #5414). Pro SPA v2 ported to feature parity with chat-spa and old pro-spa. Rich markdown rendering for assistant responses. Per-assistant scoping dropdown and agent selector. Conversations set as primary view; threads marked read-only after archival. CSS class-name mismatches fixed, causing previously unstyled UI to render correctly. Cache-bust version bump and admin layout fit within WordPress chrome (PR #5416). Bumped to v2.0.1.

  • โœ… 34 Missing Workflow Preset Tools (PR #5418). All missing workflow presets implemented across 10 toolkits (AI Tool Builder, Analytics, Architect Agent, Architectural Design, Calendar Booking, CRM, Document Generation, DJ Management, Social Media, Video Production). Orphaned media tools created and Upwork tool availability fixed. Full PHPCS compliance and comprehensive test suite validating all 36 new tools (class existence, interface implementation, slug resolution, metadata, capability flags).

  • โœ… npm Audit CVE Fixes (PR #5419). 12 CVEs resolved across the dependency tree: vite (CVE-2026-53571 server.fs.deny bypass), launch-editor (CVE-2026-53632 NTLMv2 disclosure), markdown-it (CVE-2026-48988 smartquotes DoS), ws (memory exhaustion), js-yaml (quadratic DoS), form-data (CRLF injection), hono (path traversal, CORS, Set-Cookie), dompurify (XSS sanitization bypasses), @babel/core (arbitrary file read), @opentelemetry/core (unbounded memory), joi (RangeError DoS). ajv bump reverted to restore ESLint 8 compatibility. Root npm audit: 51โ†’0 vulnerabilities.

  • โœ… Gemini 3.1 Flash Image Default (PR #5404). Default Gemini image generation model upgraded to gemini-3.1-flash-image.

  • โœ… Media Toolkit Blueprints & Scheduler Presets (PRs #5398, #5411). Blueprints and scheduler presets added to the media toolkit. Media Toolkit sync integrated into the Data Management page. Private get_media_presets() visibility fixed to prevent fatal error when called externally.

  • โœ… OpenAI/DeepSeek stream_options (PR #5400). stream_options payload added to OpenAI and DeepSeek streaming API calls, enabling proper usage-tracking inclusion during streaming responses.

  • โœ… Tool Result Cost Calculation (PR #5395). Tool result costs now computed from token counts when not explicitly provided by the provider, ensuring accurate cost attribution in agentic loops.

  • โœ… Agentic-Loop Cost Tracking (PR #5394). Missing provider pricing entries added across the cost-tracking layer, fixing under-reporting in multi-turn agentic workflows.

  • โœ… Vite CVE Fixes (PR #5403). vite pinned to ^8.0.16 in devDeps to resolve CVE-2026-53571 (server.fs.deny bypass) and CVE-2026-53632 (NTLMv2 disclosure via launch-editor middleware). Pro SPA v2 production assets built and dist output un-gitignored.

  • โœ… 1,658 PHPCS Lint Fixes (PR #5397). Full lint pass across base plugin and Pro addon (44 toolkits). Short ternaries converted to full, count() moved out of loops, docblock capitalisation normalized, require_once paths corrected for renamed optimization and tool files.

  • โœ… CI Disk Space Cleanup (PR #5417). Free disk space step added to all build workflows to prevent runner disk exhaustion during large ZIP assembly.

  • โœ… Data Integrity Fixes. PII pseudonymisation logic restored after being lost during a merge conflict resolution (PR #5398). CPT data store post type mismatch for CRM entities resolved (PR #5396).

June 12โ€“15, 2026 โ€” Chat SPA Phase 8, PM Toolkit Aโ€“D, CRM Duplicates & Hygiene, DietPi Toolkit, LibreChat Addon, Context Windows, WP 7.0 Bridge ๐Ÿชฒ๐Ÿ’ฌ๐Ÿ“Š๐Ÿ”ง๐Ÿ›ก๏ธ

  • โœ… Chat SPA Phase 8 โ€” Message Actions & Content Enrichment (PRs #5381, #5383, #5390). Conversations sidebar with assistant scoping in the Pro Chat SPA. Auto-create thread when posting to a non-existent thread. Message action cards on every assistant bubble: edit, delete, regenerate, copy, and content enrichment. Pro SPA chat routed through chat-client endpoint; threads marked read-only after archival.

  • โœ… Project Management Toolkit Enhancement Phase Aโ€“D (PR #5370). Shared WP_MCP_AI_PM_Engine powering the new Command Center dashboard with real-time task visibility, status filters, and bulk actions. Work Ingestion panel on the tasks tab for importing external tasks. 28 new AI tools spanning task management, resource allocation, timeline generation, and reporting.

  • โœ… CRM Toolkit โ€” Duplicates, Email Hygiene & Analytics (PRs #5362, #5367, #5368). Duplicate detection engine with safe one-click merge and bulk merge from the new Duplicates tab. Email hygiene module: classify domains by reputation, manage exclusion/priority lists, and auto-prune. Top Customers and Top Clients analytics tools with dedicated Command Center tabs. Merged status filter and column on leads admin list. Inline tag editing and email priority/exclude actions. Repair CRM data tool fixing broken dates, generic titles, and impersonal sender names. Refresh All Sources button on Support tab. LinkedIn & Upwork external sourcing with LinkedIn as a Remote Sites OAuth 2.0 connection type.

  • โœ… DietPi Pro Toolkit Phases 0โ€“3 (PRs #5346, #5348, #5350). Foundations: CPT/CCT scaffolding, admin settings page, 19 core tools for system monitoring, package management, and service control. Phase 2: backup, update, storage, and dashboard tools. Phase 3: provisioning automation, infrastructure blueprints, and SSH proxy. Registered as an MCP server with Feature subtab toggle.

  • โœ… LibreChat Addon (PR #5336). New addons/librechat/ addon with code interpreter, speech-to-text/text-to-speech services, and web search reranker. Added to SPA build workflow and addon ZIP build pipeline.

  • โœ… Layer I Guardrails โ€” Stay-on-Target Jailbreak Prevention (PRs #5340, #5344). Harness Layer I intercepts prompt-injection and role-change attacks. Activated per-assistant via the LLM Harness metabox.

  • โœ… Context Window Management โ€” All 13 Providers (PRs #5335, #5348, #5352). Pre-flight context-window validation added to every AI provider client (OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA, Cloudflare, Hugging Face, LM Studio, Ollama). Shared validate_context_window() helper in the language model router. tiktoken integration for accurate token counting with estimator metabox on the Assistant editor. Token-budget tool capping โ€” tools exceeding remaining budget are auto-excluded. Chat parity drift detection workflow. Model limits synced with June 2026 canonical catalog.

  • โœ… WP 7.0 Connectors API Bridge (PR #5387). Bridge for provider credentials enabling forward-compatibility with the WordPress 7.0 Connectors API. Classes load unconditionally to prevent fatal errors on WP < 7.0.

  • โœ… Chat Transcript & Agent Memory Retention (PRs #5356, #5357). WP_MCP_AI_Transcript_Retention โ€” configurable retention policies and automatic cleanup cron. WP_MCP_AI_Memory_Retention โ€” agent memory lifecycle management with pruning and retention windows.

  • โœ… Pro Toolkit Optimizations Phase 1โ€“3 (PRs #5355, #5356, #5357). Phase 1: Chat Channels and Social Media toolkits. Phase 2: Healthcare, Ecommerce, Calendar, and Orchestration. Phase 3: Document Generation and QMS. All classes wired into their toolkit init files with 767-line PHPUnit test suite.

  • โœ… OAuth & API Connection Management (PR #5351). Disconnect buttons for OAuth and API connections. Auto-clear OAuth tokens when provider credentials change on save.

  • โœ… SPA Reliability Sweep (PRs #5371โ€“#5379). Register thread REST endpoints (fixes createThread crash). Fix SPA router context error. Fix createThread event serialization crash. Register POST /threads/{id}/messages endpoint. Pass model and profile to createThread. Fix SPA bootstrap tools, turn count, and REST route. Fix SPA enqueue paths and PM blueprints. Restore Zed-inspired SPA after accidental revert. Build SPA bundle and fix import paths.

  • โœ… Core & Provider Fixes. 12 test suites fixed and SPL autoloader ordering corrected (#5392). Toolkit MCP tools returning empty inputSchema for image tools (#5391). OOS engine fatal error from undefined sendRequest (#5389). Agentic loop tool result persistence across all providers (#5354). OpenAI real-time SSE streaming (#5327). Bridge credential resolver on WP < 7.0 (#5388). Stale provider validation lists rejecting DeepSeek (#5323). Schedule preset data mismatches (#5329).

  • โœ… CRM & Data Fixes. CRM configured sources count showing 0 for valid Gmail connections (#5386). Slider/range fields not rendering (#5361). 3 CPT slugs exceeding 20-character limit (#5361). Support ticket CPT rename mcp_ai_support_ticket โ†’ mcp_ai_ticket (#5360). Memory tools capability flags (#5364). Extended Cognition review issues (#5363). Playbook orphans and sync timeouts (#5322, #5325).

  • โœ… Addon Fixes. Docs Hub: async rebuild stalls, browse critical error, broken Intuit privacy link (#5359). Cloudways Dashboard: removed Requires Plugins header (#5353); base-active check in _is_ready() (#5385). Pro Integrations subtab overwriting redirect (#5347). Performance monitor: buttons, reports, test execution restored (#5366). DietPi Toolkit PHPCS and PHPCompat fixes (#5346).

  • โœ… Security. guzzlehttp/psr7 pinned to ^2.10.2 for CVE-2026-49214 (#5352). esbuild pinned to ^0.28.1; integrity check vulnerability in Pro addon (#5382). shell-quote bumped to >=1.8.4 for CVE-2026-9277 (#5330). vitest/vite/esbuild alerts in schedule-anything-spa (#5338).

  • โœ… Infrastructure. redirect_canonical no longer breaks well-known endpoints (#5349). tool-status.txt reads guarded against missing files (#5348). WPCS lint in section-tools and tool-registry (#5348). ESLint no-var in performance-admin.js (#5366). PHPCS in CRM analytics (#5320). Chat parity workflow YAML and permissions fix (#5336).

  • โœ… Blueprint & Doc Updates. 46 healthcare-style blueprints converted to CRM-style format (#5373). All legacy flat-format blueprints upgraded to canonical (#5372). v1.1.29 comprehensive documentation refresh across all surfaces (#5365). 66 proposal statuses audited (#5335). README updated with PM toolkit and repository map (#5370). 75 PHPCS violations auto-fixed in Pro bootstrap (#5321).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.31 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), readme.txt, README.md, and CHANGELOG.md. Provider count: 13 first-class language-model providers (unchanged). Tool count: ~195 base + ~795 Pro (~990 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).


๐Ÿ†• Previous Updates (v1.1.32 โ€” June 2026)

June 7โ€“11, 2026 โ€” Bug-Fix & Stabilisation Sweep ๐Ÿชฒ๐Ÿ”งโšก

  • โœ… Chat Bubble Assistant Dropdown (PR #5333). Fixed settings UX: chat_bubble_assistant_id field on the Chat Bubble settings page (wp-admin/admin.php?page=wp-mcp-ai-dashboard&tab=general&subtab=chat_bubble) changed from a plain <input type="number"> to a proper <select> dropdown populated with all published assistants. Added get_assistant_options() helper method to WP_MCP_AI_Section_Chat_Client matching the pattern used by default_assistant in General โ†’ Core Settings. Users can now select assistants by name instead of manually typing numeric IDs.

  • โœ… Context-Window Pre-Flight Validation โ€” All 13 Providers (PR #5328). Added pre-flight context-window validation to all AI provider clients: OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, Cloudflare, Hugging Face, LM Studio, and Ollama. Shared validate_context_window() helper method in WP_MCP_AI_AI_Client_Base. Integrated tiktoken for accurate token counting with estimator metabox on the Assistant editor. Token-budget tool capping prevents exceeding model limits. Context-window management documentation at docs/developer/architecture/context-window-management.md.

  • โœ… OpenAI SSE Streaming Fix (PR #5327). Fixed stream_options payload flag that prevented OpenAI real-time SSE streaming from triggering. The include_usage flag was incorrectly nested, causing the OpenAI API to ignore the streaming request and return a non-streamed response.

  • โœ… Schedule Preset Data Mismatches (PR #5329). Fixed schedule preset data mismatches where presets would lose configuration data after save. Improved error logging for preset operations with structured log contexts.

  • โœ… Playbook Orphan Cleanup & Batching (PRs #5322, #5325). Fixed orphan playbook accumulation where deleted parent records left unreachable children. Added JetEngine validation before deletion to prevent data corruption. Fixed sync timeouts for large playbook sets by implementing batch processing with configurable chunk sizes. playbook_delete_batch_timeout now uses iterative deletion instead of single-query operations.

  • โœ… Stale Provider Validation Lists (PR #5323). Fixed provider validation lists in multiple locations that rejected DeepSeek and newer providers. Updated WP_MCP_AI_Section_General::validate() and WP_MCP_AI_REST_Chat_Controller provider checks to use dynamic provider discovery via WP_MCP_AI_Admin_Settings::get_available_providers() instead of hardcoded arrays. Also fixed default provider validation in CRM settings and Pro REST controllers.

  • โœ… CRM Activity Titles, Due Dates & Block API v3 (PR #5320). Fixed CRM activity post titles not displaying correctly when created via AI tools. Fixed due date calculations for recurring activities. Migrated CRM admin blocks to WordPress Block API v3 (apiVersion: 3) for compatibility with WP 6.9+.

  • โœ… OpenAI-Compatible Client โ€” DeepSeek Parity (PR #5315). Enhanced all OpenAI-compatible chat clients (OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM) to parity with the DeepSeek client: added max_completion_tokens support, temperature normalisation, top_p handling, and proper stop sequence forwarding.

  • โœ… Voice & Embedded LLM Missing Assets (PR #5319). Added missing .min.js asset files for voice recording/transcription scripts and embedded LLM worker scripts. These files were referenced by wp_register_script() but missing from the build output, causing 404 errors on sites using minified assets.

  • โœ… Chat Config messagesEndpoint & Tool Count Guard (PR #5318). Fixed chat config messagesEndpoint pointing to the wrong REST route in certain configurations. Added a tool count guard that returns a clear error message when an assistant has more tools configured than the provider's limit, preventing silent failures.

  • โœ… Chat Debug Console Fixes (PRs #5316, #5317). Fixed chatDebugMode using loose equality (== instead of ===) so PHP's string '1' is accepted alongside JavaScript's boolean true. Fixed legacy chat debug console not displaying when enabled via admin settings โ€” the debug panel container was hidden by a CSS rule that only targeted the new SPA debug view.

  • โœ… OOS Bridge, Embedding Fatal & SSE Headers (PR #5313). Fixed OOS bridge initialization failing when the core framework was loaded before WordPress user context was available. Fixed embedding service fatal error when API key was not configured โ€” now returns a graceful WP_Error. Fixed SSE header warnings in PHP 8.1+ caused by header_remove() being called after output started.

  • โœ… Memory Cookie-Check Nonce Fix (PR #5312). Fixed "Cookie check failed" error on the admin Test Assistant memory drawer. The memory REST controller was generating a nonce on init (before the user session was available), producing an invalid nonce for authenticated users. Nonce generation moved to the wp hook.

  • โœ… Chat Transcript Tests โ€” 4% to 87% Pass Rate (PR #5310). Fixed chat transcript REST controller tests. Root causes: test factories not creating posts with the correct post_type, missing WP_REST_Server initialization, session key normalisation mismatches, and permission callback assertions testing the wrong user role. Pass rate improved from ~4% (3/80) to 87% (70/80).

  • โœ… Graphify Related Content Leak (PR #5291). Fixed graphify related content leaking to wrong page sections โ€” content isolation tightened so graph nodes only render within their designated container element.

  • โœ… Model Limits โ€” June 2026 Canonical Catalog (PR #5331). Synced model limits (max tokens, max output tokens, rate limits) with the June 2026 canonical catalog across all providers.

  • โœ… Security โ€” shell-quote CVE-2026-9277 (PR #5330). Bumped shell-quote to >=1.8.4 via npm overrides to fix CVE-2026-9277 (command injection via insufficient escaping).

  • ๐Ÿ“ฆ Versioning โ€” bumped to 1.1.29 across mcp-ai-wpoos.php, WP_MCP_AI_VERSION constant (includes/bootstrap/constants.php), package.json, readme.txt Stable tag, README.md, and docs/DOCUMENTATION_INDEX.md. Provider count: 14 first-class language-model providers (OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, Cloudflare, Hugging Face, LM Studio, Ollama, Flowhub). Tool count: ~195 base + ~795 Pro (~990 total; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative).


๐Ÿ“‹ Previous Releases

For full details on all releases, see CHANGELOG.md.

Version

Date

Highlights

v1.1.44

Aug 2026

CCT stability (4 fixes: mutex lock, FlowHub duplicate, base-plugin fatal w/out lib/core, Veo async context), API key resolution (Gemini video + Veo fallback), Proposal 016 security & architecture hardening (all waves, 277 autoload optimizations, phpcs sweep), Proposal 017 polling/queue/load-balancing hardening (12 weaknesses), Deferred security items #5755 (post meta, term escaping, REST field filtering), npm security (undici >=8.10.0, fast-uri >=3.1.4, ip-address >=10.4.0 across 11 pkg), Docs: FOR_REVIEWERS v1.1.43 update, 16 broken links fixed, Graphify ecosystem audit

v1.1.43

Aug 2026

MCP 2026-07-28 stateless core upgrade, Security v1.1.43 hardening (SSRF/CSRF/SQL/XSS/info-disclosure across 16 files), OKF v0.2 trust-signal support, ICP System (Pro CRM Phase G, 7-dimension scoring), Pro Module Registry (PSR-4, 625-line monolithic init decomposed), Hexagonal architecture purity (PlatformFlushInterface), 7 playbook/profession sync fixes, Phase 3 operational security hardening, WPCS 3.4.1 (CVE-2026-45293)

v1.1.42

Jul 2026

Security Infrastructure (7 classes, 21 posture signals A-F), Framework-Agnostic Core (lib/core/, 32 contracts, 21 adapters), Status Page & Incident Communication (Pro), 21 Agent Skills + 6 BMAD Agents, Algorave addon (9 tools), Security Hardening (12 fixes, 13 unit tests)

v1.1.38

Jul 2026

Page Agent addon v0.1.0 (AI browser page control copilot), Pro SPA v2 major parity & polish (voice pipeline, tasks drawer, workflow tracker, file attachments, tool shortcuts, slash commands, mobile hamburger, autoscroll/viewport fixes, cache-busting, assistant preloading), Per-user chat memory toggle, create_post/save_post Markdown-to-HTML + taxonomy suggestions, Workflow blueprint existing-content awareness, SPA accessibility: annotation pills, ZAP medium findings triaged

v1.1.37

Jul 2026

JetEngine Meta Helper universal (25 CPTs, REST, ECA fields), Places enrichment tools, RabbitMQ + queue infrastructure (custom DB tables, health endpoint, worker), Multi-tenant DB isolation Phase 0โ€“4, DSpark admin UI + speculative orchestration, Crocoblock Design System addon (5 phases), Test coverage: 329 tools across 28 toolkits, Docs Hub broken link engine, OWASP ZAP DAST, 30+ bug fixes

v1.1.36

Jul 2026

EZuite Inventory Sync Pro Toolkit, Ralph Loop CCT migration + circuit breaker, JetBooking/JetAppointment (8 tools), Moonshot/Z.AI provider parity (15 total), Unified Sync Log Manager, Tool Presets Auto-Select + Chips Bar, HTTrack Cache + Place-to-Service Bridge, Generate Default Mapping + read-only sync, 45+ bug fixes

v1.1.35

Jun 2026

FlowHub Inventory Sync Pro Toolkit (6 tools), Shopify Sync Pro Toolkit (5 tools), Necessity Gate Layer J (irreversibility-weighted safety), Local Voice Embedded STT (3 backends, offline-first), Remote Site Administrator blueprint (22 tools), Places & Calendar bulk import, CLI site-import subcommand, voice realtime auto-detect, 7 bug fixes

v1.1.34

Jun 2026

GPT-Realtime-2 voice models with WebRTC + Translate/Whisper + reasoning, multi-channel result delivery UI (11 channels, up from 4), pro scheduler AI/workflow delivery, Graphify ecosystem: remote drivers, WP 7.0 Connectors, wp.org compliance, 3 reasoning-tool fatal bugs fixed, CRM deal import + multi-source auto-import, Upwork/LinkedIn mode toggle, Docs Hub REST + settings sync fixes, http-proxy-middleware CVE, Gemini cache fix, GPT image routing fix, FastAPI porting plan

v1.1.33

Jun 2026

WP 7.0 Connectors credential integration across all 17 AI clients with source badges, nvoos-graphify v1.0.0 release (Plugin Check compliant), 3 guzzlehttp CVEs + undici override, 29 npm alerts across 14 packages, 2 bug fixes (Pro tool paths, JSON-RPC warning leak), 15 dependabot bumps

v1.1.32

Jun 2026

Content Format Templates + Featured Image Service (3-provider fallback), Result Delivery Pipeline (8 channels), ECA document generation, duplicate posts fix, 6 provider clients timeout fix, schedule trigger stability, Paper Store delete fix, ECA settings/attachment fix, npm CI & Jest resilience, 14 dependabot bumps + 8 npm audit CVEs

v1.1.31

Jun 2026

Media Command Center, Pro SPA v2 (rich rendering, assistant scoping, agent selector, v2.0.1), 34 workflow preset tools, npm audit CVEs (12 resolved), Gemini 3.1 flash image default, Media toolkit blueprints & presets, stream_options, agentic-loop cost tracking, Vite CVEs, 1,658 PHPCS lint fixes, CI disk space, data integrity fixes

v1.1.30

Jun 2026

Chat SPA Phase 8, PM Toolkit Aโ€“D, CRM duplicates/hygiene/analytics, DietPi Pro Toolkit, LibreChat Addon, Layer I Guardrails, Context Window Management, WP 7.0 Bridge, Pro Toolkit Optimizations, OAuth disconnect, 30+ fixes

v1.1.28

Jun 2026

CRM Phase C complete (IMAP, SMS, WhatsApp ingestion), Customer CPT + 360 dashboard, Support Ticket module (10 AI tools + SLA), QKV Attention Routing, Funiq Bridge addon, NVOOS Graphify ecosystem (3 standalone plugins), NV Platform AI addon, automated demo video pipeline, TF-IDF + BM25 relevance search

v1.1.27

Jun 2026

Real-time SSE streaming for all OpenAI-compatible providers, 35 new OOS core tools migrated, JFB submission tools โ€” 8 fixes, Extended Cognition vision recognition, DeepSeek agentic tool handling, 9 HIGH-severity security findings fixed, 95% PHPUnit failures resolved

v1.1.26

Jun 2026

Cross-Platform Extraction Engine Phases 0โ€“2, Site-Builder Node-Graph Pipeline, SPA a11y hardening (WCAG 2.1 AA), 108 admin screenshots, docs reorganized into 12 directories

v1.1.25

May 2026

Unified Blueprint System (55 blueprints across 25 toolkits), Cloudways Pro Toolkit (60 tools), CRM Toolkit Phases Aโ€“E (70+ tools), Chat UI 7-feature enhancement, Unix-theory Phase 4โ€“5

v1.1.24

May 2026

Chat SPA fixes, Unix Theory P0/P1 refinement, CVE patches (tmp, symfony/cache), Paper Store admin CRUD, folder README convention

v1.1.23

May 2026

Zed-inspired SPA architecture, Antigravity Interactions API rewrite, TypeScript upgrade, Comic Reader & Media Studio v0.3.0

v1.1.22

May 2026

Baseten provider (11th), CoSAI secure-by-design agentic system, Continual Harness P5, SaaS Controller P2/P4, npm VAD/Chat-Bubble/Memory-UI packages

v1.1.21

May 2026

WP.org compliance complete (50/50 findings), canonical return envelope enforced, semantic compression, AI prompt caching layer

v1.1.20

May 2026

Memory Layer 2026 Phase 7 โ€” chat memory drawer UI complete

v1.1.19

May 2026

Kimi provider (10th), ACP Server, MCP Bridge, Unix Theory P7, 9 HIGH security findings fixed, chat bubble sweep

v1.1.18

May 2026

Unix Theory P0โ€“P6, DigitalOcean Serverless Inference (9th provider), async chat continuation, jobs/tasks drawer, Toolkit MCP Servers Phase 7

v1.1.17

May 2026

WP.org compliance (42/50), Chat SPA Phases 1โ€“7, Docs Hub v0.3.8, coverage campaign

v1.1.16

May 2026

SaaS Controller Addon v0.1.0, structured logging integration, WP.org compliance hardening (B3, B8, B10, B13)

v1.1.15

May 2026

OpenRouter + DeepSeek providers (7th & 8th), Orchestration Phases 1โ€“7, LLM Harnessing GA, Memory Bridge G-series, Graphify data-source bridge

v1.1.14

May 2026

Agent Skills v2 (45 skills), Markup Subsystem (Base), MemPalace Capture Framework, Graphify CPT/CCT suite

v1.1.13

May 2026

OpenAI Images 2.0 (gpt-image-2), durable agent-memory bridge Phase 4a/4b, AI Harmonization toolkit, production Composer autoloader

v1.1.12

Apr 2026

Architectural Design Toolkit Phases Aโ€“E, Graphify Federation/RAG, Tier 4 Browser-AI Runtime (Transformers.js v3.8.1), security patches

v1.1.11

Apr 2026

WP.org compliance hardening

v1.1.10

Apr 2026

Security audit summary (0 Critical, 5 High), production vendor autoload, Veo 3.1 fix

v1.1.9

Apr 2026

Measurement Subsystem GA, PHPUnit 11 upgrade, Graphify v0.5.0 restored, orchestration reference

v1.1.8

Apr 2026

Erlang C workforce tools, full tool-reference audit, WP.org compliance re-audit, MCP Apps per-assistant remote connections, CRE Debt toolkit (57 tools), 36 Pro professions + 17 teams, A2A protocol, Agent Command Center, floating chat bubble, JetEngine 3.8 MCP Server bridge, Anthropic/Gemini subscription tier support


๐Ÿš€ Features

Note: Some features require third-party plugins (WooCommerce, JetEngine, Elementor, etc.). See ๐Ÿ”Œ What You Lose Without Third-Party Plugins for details.

Assistant & conversation tools

  • ๐Ÿง  Create AI Assistants via a custom post type (mcp_ai_assistant)

  • ๐Ÿ‘” Professional & Team Templates - Deploy assistants from ~311 pre-built profession templates spanning 12 industry categories, or create entire teams of specialists with one click. Includes backend testing for professions, teams, and assistants before public deployment.

  • ๐Ÿš€ Getting Started Wizard - Guided 4-step onboarding (/wp-admin/admin.php?page=wp-mcp-ai-getting-started) that walks new users through provider setup and use-case selection. Selecting a preset (Content Creator, Customer Support, E-commerce, SEO & Research, Developer Copilot, Media & Creative Studio, Site Administrator, or General Purpose) seeds a fully-configured assistant with tools, system prompt, and tuned temperature โ€” ready to use immediately.ใ€F:includes/admin/class-wp-mcp-ai-onboarding-wizard.phpโ€ L1-L53ใ€‘ใ€F:assets/js/onboarding-wizard.jsโ€ L1-L303ใ€‘

  • ๐Ÿ”„ Automatic synchronization to JetEngine Custom Content Types when available (CPT โ†’ CCT)

  • ๐Ÿ’ฌ Chat interface via [mcp_ai_chat assistant="ID"]

  • ๐Ÿงฐ Per-assistant defaults for model, temperature, system prompt, and knowledge attachments with permission-aware download URLs

  • โšก Build reusable prompt shortcuts with optional tool targeting and inline descriptions so operators can trigger common tasks with one click.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L893-L1048ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L430-L693ใ€‘ใ€F:assets/js/chat.jsโ€ L600-L666ใ€‘

  • ๐ŸงŠ Elementor widgets for embedding chat surfaces, onboarding content, and MCP dashboards inside Elementor

Language routing & knowledge management

  • ๐Ÿ” Route conversations through OpenAI or Gemini using a provider-aware language model router

  • ๐ŸŽฏ Enhanced Gemini API integration: list models dynamically, count tokens for budget management, create embeddings for RAG/semantic search, and streaming support for real-time responsesใ€F:docs/reference/api/gemini/gemini-api-enhancements.mdโ€ L1-L100ใ€‘

  • ๐Ÿง  Assistant knowledge base management with Media Library files and optional vector store IDs

  • ๐Ÿ“š OKF (Open Knowledge Format v0.1) engine with 6 MCP tools for curated, deterministic knowledge with cross-link navigation โ€” complementary to vector/RAG stores

  • ๐Ÿ”Ž Perform lightweight web searches (DuckDuckGo or Brave) without leaving the assistant conversation

  • ๐ŸŒ Crawl4AI job runner tool for large-scale content gathering workflows

Media generation & transcription

  • ๐Ÿ”Š Generate speech audio via OpenAI's Text-to-Speech API and save the result to the Media Library

  • ๐ŸŽต Generate instrumental music using Google Gemini Lyria with controls for genre, mood, tempo, and instrumentation

  • ๐ŸŽจ Generate on-brand imagery with OpenAI's Images API, honouring the configured response format (including GPT-Image-1's url responses) and storing the files as WordPress attachments

  • ๐Ÿ–ผ๏ธ Generate images with Cloudflare Workers AI using Stable Diffusion, Flux-2 Dev, Leonardo AI (Lucid Origin, Phoenix 1.0), and other text-to-image models with configurable dimensions and generation parameters

  • ๐Ÿ–ผ๏ธ Vectorize raster images (PNG, JPEG, WebP, GIF) to SVG format using @neplex/vectorizer with configurable quality settings - perfect for logos and icons

  • ๐ŸŽจ Comprehensive graphic editing with Graphic Editor Plus combining local operations (logo overlay, smart resize) and AI-powered features (style transfer, background removal, enhancement)

  • ๐Ÿ—๏ธ Pro: Generate professional architectural drawings (floor plans, elevations, sections) with building codes, dimensions, and material specifications - designed for construction professionals

  • ๐ŸŽง Transcribe or translate uploaded audio with OpenAI's speech-to-text endpoints

Commerce & finance workflows

  • ๐Ÿ› WooCommerce-aware tools (fetch orders or products, requires WooCommerce)

  • ๐Ÿ“Š Finance-ready QuickBooks Online reporting tool for surfacing Profit and Loss, Balance Sheet, and other statements inside assistant conversationsใ€F:includes/tools/class-wp-mcp-ai-tool-get-quickbooks-report.phpโ€ L15-L214ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L906-L955ใ€‘

  • ๐Ÿ–ฅ๏ธ Pro: QuickBooks Desktop sync via QODBC relay API โ€” connect to QuickBooks Desktop through a Windows relay server for data synchronization

  • ๐Ÿ›’ Pro: Shopify integration with auto-resolved connections โ€” connection_id auto-resolved from assistant context, covering products, orders, customers, inventory, and catalog tools

  • ๐Ÿš— Pro: Vehicle estimation tools โ€” VIN decode (NHTSA vPIC), image-to-repair-estimate pipeline, and car wash package pricing engine (always available)

  • ๐Ÿ“ธ Pro: Listing image download tools โ€” bulk-download Google Maps, Facebook, and Instagram business listing images into the Media Library or ZIP

Slash Commands & Workflow Automation โญ NEW

  • โšก 8 Core Commands: /help, /next-task, /ship, /clean-content, /optimize-perf, /sync-docs, /workflow - Command-line style interface for content management

  • ๐Ÿ”„ Workflow Orchestrator: Multi-step workflow execution with state management, conditional logic, and human-in-the-loop checkpoints

  • ๐Ÿ› ๏ธ 21 Pro Toolkit Commands: Specialized commands for E-commerce (6), Social Media (6), and Video Production (6) toolkits

  • ๐ŸŽฏ 7 Automated Workflows: Pre-built workflow templates for abandoned cart recovery, social media campaigns, video marketing, inventory management, and more

  • ๐Ÿ” Security: Capability-based authorization, rate limiting, comprehensive audit logging

  • ๐Ÿ’ก Integration: JavaScript autocomplete, REST API endpoint, WP-CLI support

  • Documentation โ†’ | Pro Commands โ†’

Chat Channels & Messaging Integration โญ NEW

  • ๐Ÿ’ฌ Chat Channels Toolkit (47 Tools): Integrate with 11 platforms - Telegram, WhatsApp, Slack, Discord, Microsoft Teams, Facebook Messenger, Apple Messages for Business, Google Chat/Spaces, Twitter/X, Office 365 (Outlook + OneDrive), iCloud Drive

  • ๐Ÿ“ง Office 365 Integration โญ NEW: Send and retrieve Outlook mail, list/download/upload OneDrive files via Microsoft Graph API (5 tools)

  • โ˜๏ธ iCloud Drive Integration โญ NEW: List, download, and upload iCloud Drive files via a configurable gateway service (3 tools)

  • ๐ŸŒ Unified Broadcasting: Send messages across multiple platforms simultaneously with unified_channel_broadcast tool

  • ๐Ÿ  WebChat Rooms: Custom post type for real-time collaborative chat rooms with AI assistant assignment

  • ๐Ÿ“ Message Persistence: JetEngine CCT integration for permanent message history

  • ๐Ÿ”Š WebRTC Support: Self-hosted WebRTC signaling via WordPress REST API for voice/video

  • ๐Ÿค– AI-Powered Rooms: Assign dedicated assistants to chat rooms for automated support

  • Chat Channels Guide โ†’ | WebChat Setup โ†’

Communications & outreach

  • โœ‰๏ธ Mailjet-powered outbound email automation with granular capability enforcement and sender defaults configurable in the MCP settings.ใ€F:includes/tools/class-wp-mcp-ai-tool-send-mailjet-email.phpโ€ L19-L405ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L1008-L1054ใ€‘

  • ๐Ÿ“… Google Workspace automations for creating calendar events and searching connected Gmail inboxes directly from assistant workflows.ใ€F:includes/tools/class-wp-mcp-ai-tool-create-google-calendar-event.phpโ€ L1-L200ใ€‘ใ€F:includes/tools/class-wp-mcp-ai-tool-search-gmail.phpโ€ L1-L200ใ€‘

  • ๐Ÿงพ JetFormBuilder orchestration for listing forms, reviewing submissions, and proxying REST calls on behalf of assistants (requires JetFormBuilder)

  • ๐Ÿ“š JetEngine REST route reference tool for surfacing endpoint metadata inside AI workflows

  • ๐Ÿงฑ Ready for extension with ChatKit integration

Integrations, security & controls

  • ๐Ÿ”ง Tool Registry for registering PHP functions callable by the AI

  • โš™๏ธ JetEngine integration for dynamic content queries (requires JetEngine)

  • ๐Ÿ”Œ JetEngine 3.8 MCP Server Bridge โญ NEW - JSON-RPC 2.0 client bridges NV oOS into JetEngine's native MCP Server with 7 new Pro tools for CPT/taxonomy/meta field creation, relations management, site context grounding, and prompt template access. MCP-first dispatch with REST v2 fallback.

  • ๐Ÿค Agent-to-Agent (A2A) Protocol โญ NEW - Full A2A protocol making NV oOS assistants discoverable and interoperable with any A2A-compliant agent. /.well-known/agent.json discovery, JSON-RPC 2.0 server with task state machine, A2A client for remote agent delegation, push notification webhooks.

  • ๐Ÿ“Š Agent Command Center โญ NEW - Unified agent management dashboard with 7 tabs: Overview (KPI cards, live status), Activity Log, Active Tasks, Approvals (human-in-the-loop), Analytics (Chart.js with real per-agent metrics), Uptime & Health, and Strategy (efficiency scoring with recommendations).

  • ๐Ÿ’ฌ Floating Chat Bubble โญ NEW - Configurable floating chat bubble widget for Elementor and Gutenberg. 4 position variants, 3 sizes, bounce/pulse animations, dark mode, WCAG focus states, sessionStorage persistence.

  • ๐Ÿงท Granular control over allowed attachment MIME types for chat uploads

  • ๐Ÿ” Secure REST API endpoints

  • ๐Ÿ”‘ Root Security Key - Optional wp-config.php constant that can be enabled during emergency shutdown to require authentication before re-initializing the plugin. Provides an additional layer of protection against unauthorized reactivation after security incidents.ใ€F:docs/features/security/root-security-key.mdโ€ L1-L511ใ€‘ใ€F:includes/class-wp-mcp-ai-root-security-key.phpโ€ L1-L360ใ€‘

  • ๐Ÿ›ฐ Assistant directory endpoint that advertises MCP tool/resource capabilities and negotiates Server-Sent Events handshakes for clients such as LM Studio or Claude Desktop.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L520-L666ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1690-L1772ใ€‘

  • ๐Ÿ“ Full JSON-RPC 2.0 MCP endpoint (/mcp) for standards-compliant remote client communication

  • ๐Ÿ”‘ Configurable API credentials and defaults for OpenAI, Gemini, and Anthropic (with subscription tier support for Team/Enterprise plans and custom base URLs)

  • ๐Ÿค– ChatGPTโ€™s connector beta currently requires an Auth0 tenant; the pluginโ€™s assistant credentials are compatible with LM Studio, Claude, and other MCP clients that support bearer headers directly.ใ€F:docs/reference/api/mcp-server-authentication.mdโ€ L22-L46ใ€‘

  • ๐ŸŒ Mesh networking for distributed compute pooling across multiple WordPress sites. Server-to-server architecture enables anonymous and authenticated users to benefit from shared AI resources, budget pooling, and workload distribution across 100+ trusted peer sites. Backend assistants coordinate mesh operations via secure inter-site keys while maintaining user attribution and audit trails for compliance.ใ€F:docs/features/federation/mesh-compute-pooling.mdโ€ L1-L615ใ€‘ใ€F:includes/tools/class-wp-mcp-ai-tool-query-remote-site.phpโ€ L1-L237ใ€‘

  • ๐Ÿ”— Federation & Discovery - Decentralized AI capability network allowing WordPress sites to publish their capabilities via well-known endpoints (/.well-known/ai-peer) and discover peer sites through directory services. Supports peer registration, health verification, search & ranking by capability/region/policy, and automatic cron-based health monitoring. Enable federation to join the network or run your own directory service for private peer discovery.ใ€F:docs/features/federation/federation-discovery.mdโ€ L1-L511ใ€‘ใ€F:FEDERATION-IMPLEMENTATION-SUMMARY.mdโ€ L1-L381ใ€‘

  • ๐Ÿงพ Optional logging of chat interactions, tool executions, and API errors

  • ๐Ÿงฎ Built-in per-user usage tracking for provider/model billing summaries

  • ๐Ÿงฉ Developer hooks and filters for integrating custom behaviours

  • โฑ Per-site request timeout control with sensible minimum enforcement

  • ๐Ÿ—‘ Toggleable uninstall cleanup to purge stored assistants and settings automatically

Performance & reliability

  • โšก Client-side message bundling (800ms window) to reduce API calls and server loadใ€F:docs/user-guides/chat/message-bundling-feature.mdโ€ L1-L80ใ€‘

  • ๐ŸŽฏ Intelligent token overflow handling with automatic model switching (gpt-4.1-mini โ†’ Gemini 2.0 Flash)ใ€F:docs/features/tools/presets/high-token-tool-handling.mdโ€ L1-L80ใ€‘

  • ๐Ÿ“ก Server-Sent Events (SSE) support for real-time streaming responses and job notificationsใ€F:docs/features/streaming/ENABLE-SSE-STREAMING.mdโ€ L1-L100ใ€‘

  • ๐ŸŒŠ Real-time job status updates via SSE streaming and webhook notifications for async operationsใ€F:docs/features/async-jobs/job-notification-system.mdโ€ L1-L100ใ€‘

  • ๐Ÿ”ง Symfony Process Component - Modern process execution framework replacing direct exec() calls in Pro addon tools for enhanced security, timeout management, and error handlingใ€F:includes/services/class-wp-mcp-ai-process-service.phpโ€ L1-L220ใ€‘ใ€F:docs/history/2025/implementations/symfony-phases/SYMFONY_PHASE2B_PROCESS_INTEGRATION.mdโ€ L1-L100ใ€‘

  • ๐Ÿ”„ Server-side WP-Cron polling for long-running tasks (Crawl4AI, background jobs)

  • ๐Ÿ’พ Chat history persistence with localStorage (24h) and optional JetEngine CCT storageใ€F:docs/user-guides/chat/chat-history-persistence.mdโ€ L1-L50ใ€‘

  • โš™๏ธ Optimized settings page with external CSS stylesheet (240 lines added to admin-settings.css) and request-level caching for improved admin performanceใ€F:assets/css/admin-settings.cssโ€ L1-L984ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L27-L32ใ€‘

Settings Management โญ NEW

  • ๐Ÿ”ง Robust Settings System - 7-step save process with automatic backups, validation, and cache management ensures settings persist correctly across all tabs and subtabsใ€F:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ€ L262-L410ใ€‘

  • ๐Ÿ” Health Check - Run 6 diagnostic checks to verify settings integrity, provider configuration, and system status with GOOD/WARNING/CRITICAL status indicatorsใ€F:includes/admin/sections/class-wp-mcp-ai-section-advanced.phpโ€ L1500-L1650ใ€‘

  • ๐Ÿ’พ Export Settings - Download all plugin settings as timestamped JSON files for backup or migration to other sitesใ€F:docs/admin-guides/settings-management.mdโ€ L40-L80ใ€‘

  • ๐Ÿ“ค Import Settings - Upload and validate settings from previously exported backups with automatic pre-import backup and 5-step validationใ€F:docs/admin-guides/settings-management.mdโ€ L85-L135ใ€‘

  • ๐Ÿ—‘๏ธ Clear Cache - One-click clearing of static cache, object cache, and transients when settings changes don't take effectใ€F:docs/admin-guides/settings-management.mdโ€ L140-L165ใ€‘

  • โ†ฉ๏ธ Reset to Defaults - Safely reset all settings to default values with automatic backup before resetใ€F:docs/admin-guides/settings-management.mdโ€ L170-L200ใ€‘

  • ๐Ÿ”’ Security - File size validation (max 5MB), MIME type checking, JSON validation, and comprehensive input sanitizationใ€F:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ€ L970-L1030ใ€‘

  • ๐Ÿ“Š Automatic Backups - Every save operation creates a timestamped backup (keeps last 5) for emergency recoveryใ€F:includes/admin/class-wp-mcp-ai-settings-dashboard.phpโ€ L285-L295ใ€‘

  • ๐Ÿ›ก๏ธ Data Protection - 3-layer protection (section filtering, merge strategy, sensitive key filtering) prevents accidental data loss when saving from tabs/subtabsใ€F:docs/admin-guides/settings-management.mdโ€ L230-L280ใ€‘

  • ๐Ÿ“– Pro Toolkits - Enable and configure 8 specialized Pro toolkits (650+ tools) including Project Management, Document Generation, Health & Wellness, CRE Debt & Securitization, and moreใ€F:docs/admin-guides/pro-settings-toolkits.mdโ€ L1-L650ใ€‘

โžก๏ธ Complete Documentation: Settings Management Guide | Quick Reference | Visual UI Guide | Pro Toolkits Guide

๐Ÿง  Memory & Tool Stack Overview

Model defaults

Global settings capture the default provider, model, and timeout used when assistants are created, ensuring every conversation inherits stable generation behaviour until explicitly overridden. These defaults ship with sensible values for OpenAI and Gemini out of the box and can be tailored from the NV oOS settings screen.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L36-L77ใ€‘

Base knowledge

Each assistant can preload Media Library files and optionally link to an external vector store, giving the model persistent project context before a chat begins. Editors manage these knowledge sources from the assistant post type via the โ€œBase Knowledgeโ€ meta box, which supports multiple attachments and vector store identifiers.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L892-L1002ใ€‘

Available tools

The tool registry boots with a curated catalogue of content, commerce, automation, and research utilities, then exposes hooks so developers can register their own providers. During initialisation the registry loads each bundled tool classโ€”ranging from JetEngine accessors to Crawl4AI jobs and Mailjet automationsโ€”and makes them callable within conversations.ใ€F:includes/class-wp-mcp-ai-tool-registry.phpโ€ L74-L220ใ€‘

Chat-client Memory Drawer

The chat front-end exposes a persistent Memory Drawer (assets/js/chat-memory-drawer.js) with three tabs:

  • Memories โ€” browse, pin, and delete stored context items; ๐Ÿง  badge auto-appears on any assistant message that used a memory tool.

  • Scope โ€” set the active wing/room scope for subsequent memory operations in the current session.

  • Audit โ€” lazy-loaded audit trail from WP_MCP_AI_REST_Chat_Memory_Controller::audit().

The drawer is wired to the REST proxy at /mcp-ai/v1/chat-memory/ and receives real-time updates via the memory_event SSE frame emitted by the agentic loop. Pagehide auto-capture stores the session state before tab close. Two gates control access: site-wide filter wp_mcp_ai_chat_memory_enabled and per-user meta wp_mcp_ai_chat_memory_enabled. Full reference: docs/features/memory/chat-client-integration.md.

Retroactive Transcript Mining

WP_MCP_AI_Transcript_Mining_Job retrospectively extracts memories from past chat transcripts. Enqueue a job via POST /mcp-ai/v1/transcript-mining/jobs (admin-only), poll progress with GET /jobs/{id}, or cancel with POST /jobs/{id}/cancel. Full reference: docs/features/memory/transcript-mining.md.

LLM Harnessing Subsystem

Seven opt-in per-request layers (includes/harness/) improve response quality without changing existing tool behaviour. Activated per-assistant via the LLM Harness metabox. Layers: A Prompt/Cue โ†’ B Reasoning Trace โ†’ C Tool Routing โ†’ D Retrieval โ†’ E Self-Refine โ†’ F Memory Scoping + PII Filter โ†’ G Eval Scheduler. Pro Layer H exports fine-tune curricula as OpenAI JSONL. Full reference: docs/features/llm-harness.md.

Workflow families & tool combos

The core plugin ships with a centrally registered tool catalogue that lets assistants mix and match capabilities into cohesive workflows without additional coding. Teams can chain authoring, media, research, commerce, marketing, and operational tools to deliver end-to-end outcomes inside a single conversation.

  • Content & knowledge production โ€“ Combine submit_document_prompt, search_content, and search_attachments to gather source material, then follow up with save_post, create_wpcode_snippet, or get_rankmath_seo for structured drafting and optimisation.

  • Media generation & transcription โ€“ Pair generate_openai_image, generate_gemini_image, vectorize_image, or graphic_editor_plus with generate_openai_speech and transcribe_openai_audio to build multimedia assets that flow into editorial or marketing outputs. Use vectorize_image to convert logos to scalable vectors, and graphic_editor_plus for comprehensive image editing with both local and AI-powered operations.

  • Research & situational awareness โ€“ Chain discovery helpers like web_search, run_crawl4ai_job, reliefweb_reports, get_gdacs_events, and get_nhc_active_storms to assemble briefing packs before drafting follow-up actions.

  • Commerce & finance operations โ€“ Use WooCommerce and finance tools such as create_woo_product, get_woo_products, get_woo_recent_orders, crawl4ai_price_lookup, get_import_duty, and quickbooks_report to coordinate merchandising, pricing, and bookkeeping reviews.

  • Marketing & analytics insights โ€“ Combine measurement tools including google_analytics_report, get_google_business_insights, get_facebook_instagram_insights, get_linkedin_insights, and get_tiktok_insights to guide campaigns and reporting.

  • Publishing & outreach automations โ€“ Trigger distribution via post_facebook_instagram, post_google_business_update, post_linkedin_update, post_tiktok_video, send_group_email, send_mailjet_email, send_telegram_message, send_whatsapp_message, and schedule_notify_sms once plans are ready.

  • Integrations & scheduling โ€“ Connect external systems with create_google_calendar_event, search_gmail, list_jetengine_rest_routes, invoke_jetengine_route, and run_openai_external_action as part of larger automations.

  • Operations & diagnostics โ€“ Close the loop with create_cron_job, list_cron_jobs, get_cron_job, delete_cron_job, check_wp_cli, purge_cache, purge_cloudflare_cache, purge_varnish_cache, get_site_summary, get_site_health, get_system_logs, get_update_status, and OpenAI usage/log review helpers for monitoring and maintenance.

  • Automation & scheduling workflows โ€“ Agents can autonomously schedule background tasks with create_cron_job, monitor scheduled operations via list_cron_jobs and get_cron_job, and clean up outdated automations with delete_cron_job. Combine with cache management tools (purge_cache, purge_cloudflare_cache, purge_varnish_cache) to orchestrate content publishing workflows where agents schedule posts, then automatically invalidate caches at publication time.


๐Ÿ›  Built-in tools & automations

The assistant registry ships with a comprehensive catalogue of editorial, marketing, commerce, and operational helpers. The tables below outline every bundled tool and the slug assistants call when orchestrating workflows.

Content & knowledge workflows

Tool

Slug

Summary

Submit Document Prompt

submit_document_prompt

Uploads WordPress attachments or OpenAI file IDs alongside an instruction so multimodal prompts reach the Responses API with the required file context.ใ€F:includes/tools/class-wp-mcp-ai-tool-submit-document-prompt.phpโ€ L20-L214ใ€‘

Search Content

search_content

Queries public post types with optional taxonomy and meta filters to surface structured post metadata for the assistant.ใ€F:includes/tools/class-wp-mcp-ai-tool-search-content.phpโ€ L12-L280ใ€‘

Search Attachments

search_attachments

Scans the Media Library with keyword or MIME filters while honouring attachment capability checks and signed download URLs.ใ€F:includes/tools/class-wp-mcp-ai-tool-search-attachments.phpโ€ L15-L207ใ€‘

Get Recent Posts

get_recent_posts

Returns the latest entries for a given post type with titles, permalinks, excerpts, and timestamps for quick editorial summaries.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-recent-posts.phpโ€ L12-L104ใ€‘

Get Elementor Templates

get_elementor_templates

Lists Elementor library templates with status, type, and edit links when Elementor is available and the caller has access.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-elementor-templates.phpโ€ L12-L239ใ€‘

Get JetEngine Items

get_jetengine_items

Retrieves JetEngine-managed content with capability-aware access checks for each registered custom post type.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-jetengine-items.phpโ€ L12-L118ใ€‘

Get JetFormBuilder Forms

get_jetformbuilder_forms

Proxies JetFormBuilder REST controllers to return paginated form metadata with automatic REST/HTTP fallbacks.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-jetformbuilder-forms.phpโ€ L15-L155ใ€‘

Get JetFormBuilder Submissions

get_jetformbuilder_submissions

Lists recent JetFormBuilder entries with normalised field snapshots and capability enforcement.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-jetformbuilder-submissions.phpโ€ L15-L154ใ€‘

Save Post

save_post

Drafts or updates posts and custom post types with sanitised Gutenberg content, slug/title overrides, and edit links.ใ€F:includes/tools/class-wp-mcp-ai-tool-save-post.phpโ€ L15-L268ใ€‘

Create WPCode Snippet ๐ŸŒŸ

create_wpcode_snippet

Provisions or updates WPCode-managed snippets, validating code types, insert locations, and activation status. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-create-wpcode-snippet.phpโ€ L15-L224ใ€‘

Get Rank Math SEO Overview

get_rankmath_seo

Surfaces Rank Math SEO scores, focus keywords, robots metadata, and schema details for a specific post when the plugin is active.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-rankmath-seo.phpโ€ L15-L220ใ€‘

Get User Information

get_user_info

Inspects the acting user or a supplied account while respecting multisite membership and capability requirements.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-user-info.phpโ€ L12-L89ใ€‘

Media generation & transcription

Tool

Slug

Summary

Generate OpenAI Image

generate_openai_image

Calls the OpenAI Images API with configurable defaults, saving the rendered asset to the Media Library with optional overrides.ใ€F:includes/tools/class-wp-mcp-ai-tool-generate-openai-image.phpโ€ L17-L218ใ€‘

Generate Gemini Image

generate_gemini_image

Uses Geminiโ€™s multimodal image endpoint to render creative, aspect-ratio-aware visuals that are persisted as WordPress attachments.ใ€F:includes/tools/class-wp-mcp-ai-tool-generate-gemini-image.phpโ€ L17-L200ใ€‘

Generate Cloudflare AI Image

cloudflareai_text_to_image

Creates images using Cloudflare Workers AI text-to-image models including Stable Diffusion XL, Flux-2 Dev, Leonardo AI (Lucid Origin, Phoenix 1.0), and Dreamshaper with configurable dimensions, steps, and guidance parameters.

Vectorize Image

vectorize_image

Converts raster images (PNG, JPEG, WebP, GIF) to SVG vector format with configurable quality settings using @neplex/vectorizer. Perfect for logos, icons, and graphics. Requires Node.js 14+.ใ€F:includes/tools/class-wp-mcp-ai-tool-vectorize-image.phpโ€ L1-L430ใ€‘

Graphic Editor Plus

graphic_editor_plus

Comprehensive image editing with local operations (logo overlay, resize) and AI-powered features (style transfer, background removal, enhancement). Combines speed with intelligent transformations.ใ€F:includes/tools/class-wp-mcp-ai-tool-graphic-editor-plus.phpโ€ L1-L784ใ€‘

Generate Architectural Drawing ๐ŸŒŸ

generate_architectural_drawing

[PRO] Creates professional architectural drawings (floor plans, elevations, sections, details) for construction projects. Supports 10 drawing types, 6 presentation styles (technical, sketched, rendered), dimensional specifications, building codes (IBC, IRC, NBC, Eurocode), and material lists. Outputs PNG or SVG with automatic vectorization. Perfect for architects, engineers, and construction professionals.ใ€F:addons/pro/includes/tools/class-wp-mcp-ai-tool-generate-architectural-drawing.phpโ€ L1-L1136ใ€‘

Generate OpenAI Speech

generate_openai_speech

Converts text to audio via OpenAIโ€™s text-to-speech models, honouring default voice/format selections and storing results in the Media Library.ใ€F:includes/tools/class-wp-mcp-ai-tool-generate-openai-speech.phpโ€ L17-L199ใ€‘

Generate Music

generate_music

Creates instrumental music from text descriptions using Google Gemini Lyria model with controls for genre, mood, duration, and tempo.

Transcribe OpenAI Audio

transcribe_openai_audio

Sends uploaded audio to OpenAIโ€™s transcription/translation endpoints and returns structured transcripts with language and duration metadata.ใ€F:includes/tools/class-wp-mcp-ai-tool-transcribe-openai-audio.phpโ€ L17-L195ใ€‘

Research & situational awareness

Tool

Slug

Summary

Web Search

web_search

Performs lightweight lookups against DuckDuckGo or Brave, normalising related topics and enforcing per-user result caps.ใ€F:includes/tools/class-wp-mcp-ai-tool-web-search.phpโ€ L12-L320ใ€‘

Run Crawl4AI Job

run_crawl4ai_job

Executes Crawl4AI harvests locally or remotely, collecting Markdown, HTML, and error payloads for long-form content ingestion workflows.ใ€F:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ€ L32-L745ใ€‘

ReliefWeb Reports

reliefweb_reports

Queries ReliefWebโ€™s humanitarian dataset by country or disaster type and returns structured report metadata for situational updates.ใ€F:includes/tools/class-wp-mcp-ai-tool-reliefweb-reports.phpโ€ L15-L234ใ€‘

Get GDACS Events

get_gdacs_events

Fetches Global Disaster Alert and Coordination System events with optional date filters and capability checks for emergency planning.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-gdacs-events.phpโ€ L12-L200ใ€‘

Get NHC Active Storms

get_nhc_active_storms

Retrieves the National Hurricane Centerโ€™s active storm feed, sanitising advisory data for assistant consumption.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-nhc-active-storms.phpโ€ L15-L146ใ€‘

Get Open-Meteo Forecast

get_open_meteo_forecast

Pulls hourly weather data from Open-Meteo with coordinate, timezone, and variable controls for itinerary-aware responses.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-open-meteo-forecast.phpโ€ L15-L309ใ€‘

Vision Product Search

vision_product_search

Searches for similar products using Google Cloud Vision API Product Search feature. Note: Requires proper Google Cloud authentication credentials to succeed.ใ€F:includes/tools/class-wp-mcp-ai-tool-vision-product-search.phpโ€ L1-L200ใ€‘

Vision Object Localization

vision_object_localization

Detects and localizes multiple objects in images using Google Cloud Vision API. Note: Requires proper Google Cloud authentication credentials to succeed.ใ€F:includes/tools/class-wp-mcp-ai-tool-vision-object-localization.phpโ€ L1-L200ใ€‘

Commerce & finance operations

Tool

Slug

Summary

Create WooCommerce Product Draft

create_woo_product

Builds draft WooCommerce products with merchandising copy, pricing, images, and brand metadata when WooCommerce is active.ใ€F:includes/tools/class-wp-mcp-ai-tool-create-woo-product.phpโ€ L15-L258ใ€‘

Get WooCommerce Products

get_woo_products

Surfaces catalogue listings with pricing, stock status, and optional SKU/status filters for merchandiser reviews.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-woo-products.phpโ€ L12-L140ใ€‘

Get Woo Recent Orders

get_woo_recent_orders

Summarises recent WooCommerce orders with totals, billing details, and ISO timestamps for fulfilment teams.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-woo-recent-orders.phpโ€ L12-L117ใ€‘

Wholesale Club Price Lookup

crawl4ai_price_lookup

Uses Crawl4AIโ€™s web search endpoint to compare BJโ€™s, Samโ€™s Club, and Costco pricing for a given product query.ใ€F:includes/tools/class-wp-mcp-ai-tool-crawl4ai-price-lookup.phpโ€ L17-L189ใ€‘

Lookup Import Duty ๐ŸŒŸ

get_import_duty

Queries the ITA Tariff Rates API for HS codes or descriptions to surface import duty rates for supported countries. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-import-duty.phpโ€ L15-L152ใ€‘

QuickBooks Online Report ๐ŸŒŸ

quickbooks_report

Requests Profit & Loss, Balance Sheet, or custom QuickBooks Online reports with optional date ranges and accounting methods. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-quickbooks-report.phpโ€ L15-L214ใ€‘

Marketing & analytics insights

Tool

Slug

Summary

Google Analytics Report ๐ŸŒŸ

google_analytics_report

Runs GA4 Analytics Data API queries with metrics, dimensions, date ranges, and aggregation controls to monitor site performance. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-google-analytics-report.phpโ€ L15-L158ใ€‘

Google Business Insights

get_google_business_insights

Fetches Google Business Profile metrics for a location using OAuth tokens, time ranges, and timezone hints. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-google-business-insights.phpโ€ L15-L149ใ€‘

Meta Social Insights

get_facebook_instagram_insights

Pulls Facebook Page or Instagram business metrics via the Graph API with selectable periods and metric sets. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-facebook-instagram-insights.phpโ€ L15-L146ใ€‘

LinkedIn Insights

get_linkedin_insights

Queries LinkedIn organizational share statistics with optional timeframe and granularity filters. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-linkedin-insights.phpโ€ L15-L138ใ€‘

TikTok Insights

get_tiktok_insights

Calls the TikTok Open API to return account performance metrics across configurable windows and granularities. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-get-tiktok-insights.phpโ€ L15-L136ใ€‘

Get Cross-Platform Analytics ๐ŸŒŸ

get_cross_platform_analytics

[NEW Jan 2026] Unified social media metrics dashboard aggregating data from Facebook, Instagram, Twitter, LinkedIn, and YouTube. Provides engagement rates, follower growth, post performance, and comparative analytics across all platforms. Built-in 12-hour caching. Pro addon tool (623 lines).

Track Hashtag Performance ๐ŸŒŸ

track_hashtag_performance

[NEW Jan 2026] Comprehensive hashtag analysis tracking reach, engagement, impressions, and trend data across Facebook, Instagram, Twitter, LinkedIn, and YouTube. Identifies top-performing hashtags and provides optimization recommendations. Pro addon tool (586 lines).

Competitor Analysis ๐ŸŒŸ

analyze_competitor_social

[NEW Jan 2026] Track competitor social media metrics and benchmark performance against your profiles. Monitors follower growth, engagement rates, posting frequency, and content strategies across all major platforms. Pro addon tool (711 lines).

Influencer Identification ๐ŸŒŸ

identify_influencers

[NEW Jan 2026] Discover brand influencers and potential collaboration partners based on reach, engagement criteria, audience demographics, and content relevance. Searches across Facebook, Instagram, Twitter, LinkedIn, and YouTube. Pro addon tool (759 lines).

Publishing & outreach

Tool

Slug

Summary

Publish Meta Social Post ๐ŸŒŸ

post_facebook_instagram

Publishes Facebook Page or Instagram business posts through the Meta Graph API with message, caption, and media controls. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-facebook-instagram.phpโ€ L15-L170ใ€‘

Publish Google Business Update ๐ŸŒŸ

post_google_business_update

Creates Google Business Profile local posts with summaries, language codes, and optional call-to-action links. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-google-business-update.phpโ€ L15-L168ใ€‘

Publish LinkedIn Update ๐ŸŒŸ

post_linkedin_update

Sends LinkedIn UGC posts for members or organisations with optional share URLs via the LinkedIn Marketing API. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-linkedin-update.phpโ€ L15-L160ใ€‘

Publish TikTok Video ๐ŸŒŸ

post_tiktok_video

Submits hosted video assets to TikTokโ€™s Open API share endpoint with optional captions. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-post-tiktok-video.phpโ€ L15-L152ใ€‘

Send Group Email

send_group_email

Orchestrates structured or free-form email campaigns with capability-based audience limits and logging hooks. Full documentation.ใ€F:includes/tools/class-wp-mcp-ai-tool-send-group-email.phpโ€ L16-L650ใ€‘

Send Mailjet Email ๐ŸŒŸ

send_mailjet_email

Delivers transactional and marketing emails through Mailjet with sender defaults, CC/BCC routing, and response metadata. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-mailjet-email.phpโ€ L19-L405ใ€‘

Send Telegram Message ๐ŸŒŸ

send_telegram_message

Posts formatted updates to Telegram chats or channels with capability filters and audit logging. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-telegram-message.phpโ€ L16-L232ใ€‘

Send WhatsApp Message ๐ŸŒŸ

send_whatsapp_message

Sends WhatsApp Cloud API text messages with preview controls using phone-number specific access tokens. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-send-whatsapp-message.phpโ€ L15-L178ใ€‘

Schedule Notify.lk SMS ๐ŸŒŸ

schedule_notify_sms

Queues Notify.lk SMS messages for future delivery using the official SDK and site cron orchestration. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-schedule-notify-sms.phpโ€ L15-L180ใ€‘

Integrations & scheduling

Tool

Slug

Summary

Create Google Calendar Event

create_google_calendar_event

Builds calendar events with attendees, reminders, and timeout overrides using OAuth tokens or service accounts.ใ€F:includes/tools/class-wp-mcp-ai-tool-create-google-calendar-event.phpโ€ L17-L378ใ€‘

Search Gmail Messages

search_gmail

Performs delegated Gmail queries with optional label filters and pagination, returning normalised message metadata. Pro addon tool.ใ€F:addons/pro/includes/src/Tools/class-wp-mcp-ai-pro-tool-search-gmail.phpโ€ L1-L200ใ€‘

List JetEngine REST Routes

list_jetengine_rest_routes

Enumerates JetEngine REST endpoints with method, callback, and capability metadata for developers.ใ€F:includes/tools/class-wp-mcp-ai-tool-list-jetengine-routes.phpโ€ L12-L151ใ€‘

Invoke JetEngine REST Route

invoke_jetengine_route

Proxies JetEngine CRUD operations using the authenticated user context with REST/HTTP fallbacks.ใ€F:includes/tools/class-wp-mcp-ai-tool-invoke-jetengine-route.phpโ€ L12-L133ใ€‘

Run OpenAI External Action

run_openai_external_action

Triggers OpenAI Responses API workflows or assistants with payload sanitisation, timeout overrides, and structured errors.ใ€F:includes/tools/class-wp-mcp-ai-tool-run-openai-external-action.phpโ€ L17-L211ใ€‘

Operations & diagnostics

Tool

Slug

Summary

Cron Management Suite

AI agents can autonomously schedule, monitor, and manage WordPress background tasks

Create Cron Job

create_cron_job

Schedules one-off or recurring WP-Cron events with duplicate detection and sanitised hooks/arguments. Agents can automate periodic maintenance, content publishing, or custom workflows by scheduling actions to run at specific times or intervals.ใ€F:includes/tools/class-wp-mcp-ai-tool-create-cron-job.phpโ€ L16-L168ใ€‘

List Cron Jobs

list_cron_jobs

Lists all scheduled WordPress cron jobs with details about schedule, next run time, and creator. Enables agents to provide visibility into scheduled automation tasks and audit what background processes are running.ใ€F:includes/tools/class-wp-mcp-ai-tool-list-cron-jobs.phpโ€ L17-L141ใ€‘

Get Cron Job

get_cron_job

Retrieves detailed information about a specific WordPress cron job by its job ID, including schedule interval details and execution metadata. Allows agents to inspect individual scheduled tasks for troubleshooting or reporting.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-cron-job.phpโ€ L17-L145ใ€‘

Delete Cron Job

delete_cron_job

Deletes a scheduled WordPress cron job and removes it from both the plugin tracking and WP-Cron. Enables agents to cancel outdated or unnecessary automation tasks on behalf of operators.ใ€F:includes/tools/class-wp-mcp-ai-tool-delete-cron-job.phpโ€ L17-L90ใ€‘

Cache Management

AI agents can coordinate multi-layer cache invalidation

Purge Cache

purge_cache

Master cache purge tool that coordinates multi-layer cache clearing (Cloudflare, Varnish, etc.) in the correct order. Agents can ensure content updates are properly reflected across all caching layers.ใ€F:includes/tools/class-wp-mcp-ai-tool-purge-cache.phpโ€ L17-L150ใ€‘

Purge Cloudflare Cache

purge_cloudflare_cache

Sends targeted or full-zone invalidations to Cloudflare with configurable timeouts and admin-only access controls.ใ€F:includes/tools/class-wp-mcp-ai-tool-purge-cloudflare-cache.phpโ€ L17-L292ใ€‘

Purge Varnish Cache

purge_varnish_cache

Purges the local Varnish cache with support for full-cache bans and specific URL purges. Agents can clear server-side caching to ensure immediate content updates.ใ€F:includes/tools/class-wp-mcp-ai-tool-purge-varnish-cache.phpโ€ L17-L150ใ€‘

System Monitoring & Diagnostics

Check Site Security

check_site_security

Checks if the WordPress site has security vulnerabilities that make it unsafe to use this AI plugin. Scans for common security issues and provides remediation guidance for administrators.ใ€F:includes/tools/class-wp-mcp-ai-tool-check-site-security.phpโ€ L1-L200ใ€‘

Check WP-CLI Status

check_wp_cli

Scans for the WordPress CLI binary, returning detected paths, version output, and environment warnings.ใ€F:includes/tools/class-wp-mcp-ai-tool-check-wp-cli.phpโ€ L17-L309ใ€‘

Count Tokens

count_tokens

Estimates token counts for text and messages using heuristic estimation (approximately 4 characters per token) for planning and budgeting purposes. Helps with capacity planning before sending requests to AI providers.ใ€F:includes/tools/class-wp-mcp-ai-tool-count-tokens.phpโ€ L1-L200ใ€‘

Get Site Summary

get_site_summary

Provides high-level site metadata, content counts, and admin contact details for context-aware assistants.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-site-summary.phpโ€ L12-L66ใ€‘

Get MCP Environment Status

get_environment_status

Summarises WordPress versions, MCP defaults, assistant counts, and dependency warnings for incident response.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-environment-status.phpโ€ L12-L178ใ€‘

Get Site Health Status

get_site_health

Runs WordPress Site Health diagnostics and returns grouped pass/warn/fail tests with remediation guidance.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-site-health.phpโ€ L12-L255ใ€‘

Get System Logs

get_system_logs

Aggregates NV oOS logs, WordPress/PHP error logs, and plugin log files to aid in debugging workflows.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-system-logs.phpโ€ L12-L352ใ€‘

Get Update Status

get_update_status

Reports pending core, plugin, and theme updates with version and download metadata for maintenance planning.ใ€F:includes/tools/class-wp-mcp-ai-tool-get-update-status.phpโ€ L12-L182ใ€‘

Testing & Validation

Probe Assistant Chat

probe_chat

Issues a chat probe against a published assistant to confirm sanitisation, configuration, and REST handling without consuming model tokens.ใ€F:includes/tools/class-wp-mcp-ai-tool-probe-chat.phpโ€ L12-L178ใ€‘

Probe Remote MCP REST

probe_remote_mcp

Reuses the remote connectivity tester to exercise /assistants and /chat on another site with optional bearer, guest, or nonce credentials.ใ€F:includes/tools/class-wp-mcp-ai-tool-probe-remote-mcp.phpโ€ L12-L164ใ€‘

Mesh Networking

Distributed compute pooling across WordPress sites

Query Remote Site

query_remote_site

Executes chat requests on peer WordPress sites in a mesh network. Requires manage_options capability and mesh networking to be enabled. Coordinates server-to-server compute pooling with secure inter-site key authentication, enabling distributed AI workloads across trusted peers while maintaining user attribution and audit trails. Backend assistants use this tool to fan out work across the mesh on behalf of anonymous or authenticated users.ใ€F:includes/tools/class-wp-mcp-ai-tool-query-remote-site.phpโ€ L1-L237ใ€‘ใ€F:docs/features/federation/mesh-compute-pooling.mdโ€ L1-L615ใ€‘

Query Mesh (Intelligent Routing)

query_mesh_intelligent

Send a prompt to the mesh network with AI-powered peer selection and automatic failover. The system intelligently routes requests to the optimal peer site based on current load, response times, and task complexity. Provides resilient distributed compute with automatic retry logic.ใ€F:includes/tools/class-wp-mcp-ai-tool-query-mesh-intelligent.phpโ€ L1-L300ใ€‘

Provider Dashboards

Open OpenAI Logs

open_openai_logs

Returns dashboard shortcuts for reviewing OpenAI request logs in the provider console.ใ€F:includes/tools/class-wp-mcp-ai-tool-open-openai-logs.phpโ€ L12-L66ใ€‘

Open OpenAI Usage

open_openai_usage

Provides direct links to OpenAI usage dashboards so admins can audit consumption quickly.ใ€F:includes/tools/class-wp-mcp-ai-tool-open-openai-usage.phpโ€ L12-L66ใ€‘

Authentication

Generate Simple JWT Token

generate_simple_jwt_token

Generates a Simple JWT Login bearer token for the current user, enabling authenticated API access across sessions. Agents can help users obtain authentication tokens for headless WordPress integrations.ใ€F:includes/tools/class-wp-mcp-ai-tool-generate-simple-jwt-token.phpโ€ L15-L120ใ€‘

What the Cron Manager means to AI agents

The Cron Management Suite transforms AI assistants from reactive responders into proactive automation orchestrators. By providing full control over WordPress's background task scheduler, agents can:

Autonomous Task Scheduling

  • Schedule content publishing workflows to go live at optimal times without human intervention

  • Automate recurring maintenance tasks like cache clearing, database optimization, or backup operations

  • Coordinate multi-step operations that span hours or days by chaining scheduled hooks

Intelligent Monitoring & Self-Management

  • List and inspect all scheduled tasks to understand what automation is currently active

  • Audit who created each task and when it's scheduled to run next

  • Identify and remove outdated or redundant scheduled tasks to maintain system health

Real-World Agent Workflows

  1. Content Calendar Automation - An agent helping with content strategy can schedule posts to publish at researched optimal engagement times, set up recurring social media cross-posts, and schedule follow-up email campaigns.

  2. Site Maintenance Orchestration - When troubleshooting performance issues, agents can schedule off-peak cache purges, coordinate database cleanup tasks, and set up recurring health check notifications.

  3. Business Process Automation - Agents can schedule recurring report generation, periodic data syncs with external systems, and automated backup verification checks.

Technical Implementation The cron manager tracks all scheduled tasks in wp_mcp_ai_cron_jobs option with full audit trails including:

  • Job ID for unique identification

  • Hook name and sanitized arguments

  • Schedule type (single-run or recurring interval)

  • Creation timestamp and user attribution

  • Next execution time for monitoring

Jobs are automatically pruned when they complete (single-run) or are manually removed (recurring), keeping the tracking database clean. All cron operations require manage_options capability, ensuring only authorized users can delegate automation authority to agents.ใ€F:includes/class-wp-mcp-ai-cron-manager.phpโ€ L12-L280ใ€‘

Each tool inherits the assistant context and authenticated user from the REST layer, making it easy to layer custom permissions or extend behaviour via the documented filters and actions.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L236-L360ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1124-L1198ใ€‘

Need per-tool prerequisites or capability callouts? Consult docs/reference/tools/tool-reference.md for a detailed matrix of every bundled integration.

Tool Status Labels

The Tools Manager page displays status labels beside tool names to indicate their development stage and stability:

Status

Display Label

Description

Auto-Disable

stable

STA

Production-ready, fully tested tools safe for all environments

No

beta

BET

Testing phase, mostly stable but may have minor issues

No

dev

DEV

In active development, may have bugs or incomplete features

No

experimental

EXP

New features that may change significantly

No

bug

BUG

Known issues exist, use with caution

Yes

deprecated

DEP

Will be removed in future versions

No

Status labels are displayed as 3-letter abbreviations (e.g., "STA" for stable, "BET" for beta) to keep the UI compact.

Important: Tools marked with the bug status are automatically disabled when the plugin loads. This prevents problematic tools from being used until issues are resolved. Administrators can manually re-enable them from the Tools Manager if needed for testing.

Status labels are managed via the tool-status.txt file in the repository. To assign a status label to a tool:

  1. Open docs/tool-status.txt in a text editor

  2. Add a line in the format: tool_slug = status_label

  3. Save the file - changes appear immediately in the Tools Manager

Example:

create_post = stable
web_search = beta
generate_openai_image_validated = experimental
problematic_tool = bug

This file-based approach allows quick status updates without code changes, making it easy for maintainers to reflect tool maturity as development progresses. The automatic disabling of buggy tools provides an additional safety layer to prevent issues in production environments.


๐Ÿ—จ๏ธ Front-end chat surfaces

NV oOS ships multiple ways to embed assistants on the front end:

  • Classic chat shortcode โ€“ [mcp_ai_chat] renders the bundled interface with attachment uploads, tool invocation feedback, and optional guest access via allow_guests="true". When guest mode is enabled, the shortcode provisions a temporary token and injects it into the JavaScript bootstrap so visitors without WordPress accounts can continue chatting while still respecting capability checks and attachment safety limits.ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L132-L258ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L188-L226ใ€‘

  • Floating chat bubble โญ NEW โ€“ A configurable floating button that sits at a screen corner and opens a chat panel powered by the [mcp_ai_chat] shortcode. Available as both an Elementor widget and a Gutenberg block. Supports 4 position variants, 3 sizes, auto-open delay, session persistence, dark mode, and WCAG keyboard navigation.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-bubble-widget.phpโ€ L1-L200ใ€‘ใ€F:includes/blocks/chat-bubble/block.jsonโ€ L1-L50ใ€‘

  • Elementor widgets โ€“ Drop the chat UI anywhere Elementor is active, pair it with intro/FAQ blocks, and surface dashboard telemetry without custom code. The chat widget mirrors the shortcode controls (including allow_guests), and companion widgets expose onboarding content, usage timers, provider quick links, and activity feeds for operational views.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ€ L79-L138ใ€‘ใ€F:includes/class-wp-mcp-ai-elementor-integration.phpโ€ L48-L98ใ€‘ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-intro-widget.phpโ€ L47-L140ใ€‘ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-usage-timer-widget.phpโ€ L48-L226ใ€‘ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-activity-feed-widget.phpโ€ L48-L167ใ€‘

Guest tokens are honoured by the REST endpoints through the X-WP-MCP-AI-Guest header or guest_token parameter, allowing the chat shortcode and Elementor widget to make authenticated requests on behalf of public visitors without exposing persistent credentials.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L289-L307ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L2088-L2104ใ€‘

Chat History Persistence

The chat interface automatically persists conversation history to the browser's localStorage, preventing data loss when users navigate away or refresh the page. Conversations are:

  • Automatically saved after each user message and assistant response

  • Automatically restored when returning to the chat page (within 24 hours)

  • Stored per assistant so different assistant conversations remain separate

  • Server-side storage available with JetEngine - See note below about optional JetEngine integration

Server-Side Chat Transcript Storage (Requires JetEngine)

โš ๏ธ Third-Party Plugin Required: JetEngine (not included with NV oOS)

Without JetEngine, chat conversations are only stored in browser localStorage (client-side, 24-hour retention). To enable permanent server-side chat transcript archiving:

  1. Install and activate the JetEngine plugin (third-party, paid plugin from Crocoblock)

  2. Enable the Custom Content Types module in JetEngine settings

  3. NV oOS will automatically provision the ai_chat_transcripts CCT for permanent storage

What you get with JetEngine:

  • โœ… Permanent server-side chat transcript storage

  • โœ… Cross-device conversation access

  • โœ… Admin visibility into chat history

  • โœ… Database-backed chat logs for compliance/auditing

Without JetEngine:

  • โš ๏ธ Chat history only stored in browser localStorage

  • โš ๏ธ Limited to 24-hour retention

  • โš ๏ธ No cross-device synchronization

  • โš ๏ธ Lost if browser data is cleared

See docs/user-guides/chat/chat-history-persistence.md for complete details on the persistence mechanism, data structure, and troubleshooting.


๐Ÿ“ฆ Installation

โ„น๏ธ Plugin Directory Status
This plugin is currently pending approval in the WordPress Plugin Directory. We are committed to maintaining high quality and security standards throughout the review process. You can install the plugin manually from our GitHub repository or wait for the official WordPress Plugin Directory listing.

๐Ÿš€ Getting Started Wizard
After activating the plugin, you'll be redirected to a 4-step setup wizard that walks you through connecting an AI provider, choosing a use case, and creating your first assistant โ€” all in under 2 minutes. The wizard creates fully-configured assistants with tools, system prompts, and tuned temperatures so your site is working out of the box. You can access the wizard any time at NV oOS โ†’ Getting Started or directly at /wp-admin/admin.php?page=wp-mcp-ai-getting-started.

๐ŸŒฑ Beginner 3-Step Install (Try it on Your PC)

No live site. No API costs. No risk. The fastest way to try NV oOS is on your own computer using a free local WordPress environment. Follow the full walkthrough on the NV Digital Solutions blog: How to Test NV oOS on Your Own PC Using Local + Downloading the Plugin โ†’

  1. Install a local WordPress environment โ€” Local by WP Engine or WordPress Studio is the easiest option (one-click install, no server config). Alternatives: XAMPP, MAMP, or DevKinsta.

  2. Download the NV oOS plugin zip โ€” grab the latest release from GitHub Releases (look for mcp-ai-wpoos-x.x.x.zip), or use the Code โ†’ Download ZIP button for the current development snapshot.

  3. Upload, activate, and run the wizard โ€” in your local WordPress dashboard go to Plugins โ†’ Add New โ†’ Upload Plugin, select the zip, activate it, and follow the ๐Ÿš€ Getting Started Wizard. For a free local AI model (no API key needed), install LM Studio and point the wizard at http://localhost:1234.

๐Ÿ—บ Single-file auto-installer (roadmap) โ€” A single cross-platform installer that bootstraps the entire stack automatically is on the roadmap. See the App / Plugin Distribution Proposal for current status and the plan.

Requirements

Minimum Requirements:

  • WordPress 6.0+

  • PHP 7.4+ (PHP 8.0+ recommended)

  • MySQL 5.7+ or MariaDB 10.3+

Optional Requirements for Enhanced Features:

  • Node.js 14+: Required for image vectorization tools (vectorize_image tool)

  • PHP Functions: proc_open, proc_close, proc_terminate (for Node.js integration and Process Service)

    • These functions are often disabled on shared hosting for security

    • Can be enabled on Cloudways via Application Settings (see troubleshooting guide)

  • JetEngine Plugin: For CCT storage and advanced content management tools

  • WooCommerce: For e-commerce integration tools

  • Elementor: For visual page builder widgets

Note: The plugin works without optional requirements, but some features will be disabled. See deployment troubleshooting for enabling disabled PHP functions.

For Developers (GitHub Clone)

โœ… Production-Ready Repository
This repository includes production-optimized vendor dependencies with classmap-authoritative autoloading configured by default in composer.json. You can clone and activate immediately without running composer. The composer install command is only needed if you want to update dependencies or add development tools.

โšก Use a shallow clone
A full clone of this repository is ~10 GB due to its long history. Use --depth 1 to download only the latest snapshot (~500 MB) โ€” much faster and smaller. If you later need the full history, run git fetch --unshallow.

git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git

If you're cloning from GitHub:

For Cloudways and similar managed hosting platforms, clone directly into the WordPress plugins directory:

# SSH into your server
# Navigate to WordPress plugins directory
cd /home/master/applications/YOURAPP/public_html/wp-content/plugins/

# Clone the repository (production-ready, no composer needed!)
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos

# Verify you're in the correct directory
pwd  # Should show the plugins path

# Optional: Only needed for frontend asset rebuilding or development
# npm install && npm run build

# Optional: Only run if you need to update dependencies or add dev tools
# Note: Autoloader optimization is now configured by default in composer.json
# composer install --no-dev

โš ๏ธ Cloudways Important Notes:

  • Always clone directly into /home/master/applications/YOURAPP/public_html/wp-content/plugins/

  • Do NOT clone elsewhere and then move/copy - this causes getcwd() failed errors

  • Replace YOURAPP with your actual Cloudways application name

Option 2: Local Development or VPS

For local development or standard VPS hosting:

# Option A: Clone directly into WordPress plugins directory (recommended, production-ready!)
cd /path/to/wordpress/wp-content/plugins/
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
# Ready to activate! No composer or npm needed for production use.

# Option B: Clone and copy (also production-ready!)
# Use --depth 1 for a fast shallow clone (recommended for production)
git clone --depth 1 https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos
cp -r . /path/to/wordpress/wp-content/plugins/mcp-ai-wpoos/

For Development Only:

# Only if you need to rebuild assets or modify dependencies:
npm install && npm run build
# Note: Autoloader optimization is now configured by default in composer.json
composer install --no-dev

Optional: Strip Dev Files for Production

If you are deploying via git clone to a production server with anti-malware / EDR scanning, the working tree will contain test fixtures that embed verbatim attack-payload literals (XSS canaries, SQL-injection samples, prompt-injection strings) used by the security test suite. These can occasionally trip signature-based scanners.

For a clean production tree, run the bundled strip script after cloning:

# Preview what would be removed
bin/strip-dev-files.sh --dry-run

# Remove tests/, docs/, bin/, .github/, .bmad/, .context/, examples/,
# phpunit.xml.dist, phpcs.xml.dist, dev configs, etc.
bin/strip-dev-files.sh

The script mirrors the exclusion list in .distignore (used for the WordPress.org SVN deploy) and the export-ignore rules in .gitattributes (used for GitHub-distributed ZIPs). It is idempotent and refuses to run on a working tree with uncommitted changes (override with --force).

Note: Do not run this on a development checkout โ€” it removes the test suite, docs, and build tooling. It is intended for deploy targets that only run the plugin.

Final Steps

  1. Activate Open Operator System Complete (NV oOS) from WordPress admin

  2. You now have the complete version with all ~1,566 tools (~303 base + ~1,263 Pro; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative)

What you get from the repository clone:

  • โœ… The full codebase โ€” all ~1,566 built-in tools ready to use (~303 base + ~1,263 Pro; live count via WP_MCP_AI_Tool_Registry::get_tools() is authoritative)

  • โœ… Single plugin activation (not separate base + pro)

  • โœ… Pro features automatically available (no separate Pro plugin to install)

Notes:

  • The repository includes mcp-ai-wpoos-base.php and addons/pro/mcp-ai-wpoos-pro.php which are used for building separate distributions but do NOT appear as separate plugins when cloning

  • Only the main plugin file (mcp-ai-wpoos.php) has a plugin header in the repository

  • The build script adds headers to the other files when creating standalone distributions

Standard Installation

  1. Upload mcp-ai-wpoos.zip to /wp-content/plugins/

  2. Activate NV oOS from the WordPress admin

  3. Go to Settings โ†’ NV oOS

  4. Enter your OpenAI API key

  5. Create a new โ€œAI Assistantโ€ in AI Assistants

  6. Add [mcp_ai_chat assistant="123"] to a page or post

Optional: JetEngine Integration

โš ๏ธ Third-Party Plugin (Not Included): JetEngine is a paid plugin from Crocoblock

JetEngine is completely optional - NV oOS works perfectly without it. However, if you want server-side chat transcript storage:

  1. Purchase and install JetEngine separately

  2. Enable the Custom Content Types module in JetEngine settings

  3. NV oOS will automatically provision the ai_chat_transcripts CCT for permanent chat storage

What works WITHOUT JetEngine:

  • โœ… All core AI assistant features

  • โœ… Chat interface and conversations

  • โœ… ~300 base tools (more with optional third-party plugins)

  • โœ… MCP server functionality (/wp-json/mcp-ai/v1/)

  • โœ… Browser-based chat history (localStorage, 24 hours)

  • โœ… OpenAI/Gemini/Anthropic/Ollama/Hugging Face/Cloudflare integrations

What requires JetEngine:


๐Ÿ”Œ What You Lose Without Third-Party Plugins

NV oOS works perfectly with vanilla WordPress, but certain features require third-party plugins (sold separately). Here's exactly what you lose without each plugin:

Without JetEngine (Crocoblock - Paid Plugin)

Lost Features:

  • โŒ AI metaboxes for JetEngine CPTs/Taxonomies - No AI assistant integration on JetEngine edit screens

  • โŒ Research & Add pages - No AI-powered content creation with automatic field mapping

  • โŒ Server-side chat transcript storage - Chat history only stored in browser localStorage (24 hours)

  • โŒ Cross-device chat synchronization - No database-backed conversation history

  • โŒ Admin chat history access - Cannot view/audit conversations from admin panel

  • โŒ Assistant CCT synchronization - Assistants only in WordPress CPT (MCP server still works perfectly)

Lost Tools (5 tools):

  • get_jetengine_items - Query JetEngine custom post types

  • list_jetengine_rest_routes - List JetEngine REST API routes

  • invoke_jetengine_route - Execute JetEngine REST operations

  • get_jetformbuilder_forms - List JetFormBuilder forms (also requires JetFormBuilder)

  • get_jetformbuilder_submissions - Get form submissions (also requires JetFormBuilder)

โœ… Still Works: All core features, MCP server, ~300 base tools, AI conversations

Get JetEngine โ†’


Without WooCommerce (Free Plugin)

Lost Features:

  • โŒ E-commerce automation - Cannot create or manage products via AI

  • โŒ Order management - Cannot query or analyze orders

  • โŒ Product catalog access - Cannot search or update product data

Lost Tools (3 tools):

  • create_woo_product - Build draft WooCommerce products with AI-generated descriptions, pricing, and images

  • get_woo_products - Search and retrieve product catalog with pricing and stock status

  • get_woo_recent_orders - Summarize recent orders with billing details and totals

Use Cases Lost: E-commerce content generation, order fulfillment assistance, product merchandising

Get WooCommerce โ†’


Without Elementor (Freemium Plugin)

Lost Features:

  • โŒ Template management - Cannot list or reference Elementor templates via AI

  • โŒ Elementor widgets - Cannot use pre-built chat/dashboard widgets (shortcodes still work)

Lost Tools (2 tools):

  • get_elementor_templates - List Elementor library templates with status, type, and edit links

  • import_elementor_template_kit - Import Elementor template kits

Lost UI Components:

  • Elementor Chat Widget

  • Elementor Chat Intro Widget

  • Elementor Dashboard Widgets (Tool Matrix, User Capabilities, Activity Feed, etc.)

โœ… Still Works: Standard [mcp_ai_chat] shortcode, all AI features

Get Elementor โ†’


Without Rank Math SEO (Freemium Plugin)

Lost Features:

  • โŒ SEO analysis - Cannot query SEO scores or optimization recommendations

  • โŒ Schema data access - Cannot retrieve structured data for posts

Lost Tools (1 tool):

  • get_rankmath_seo - Get SEO scores, focus keywords, robots metadata, and schema details for posts

Use Cases Lost: AI-powered SEO content optimization, SEO audit assistance

Get Rank Math โ†’


Without WPCode (Freemium Plugin)

Lost Features:

  • โŒ Code snippet management - Cannot create or update code snippets via AI

  • โŒ Custom functionality automation - Cannot automate adding hooks, filters, or custom code

Lost Tools (1 tool):

  • create_wpcode_snippet - Create or update code snippets with validation and activation control

Use Cases Lost: AI-assisted custom development, automated code snippet generation

Get WPCode โ†’


Without Simple JWT Login (Free Plugin)

Lost Features:

  • โŒ JWT token generation - Cannot generate JWT bearer tokens for headless WordPress integrations

Lost Tools (1 tool):

  • generate_simple_jwt_token - Generate JWT bearer tokens for authenticated API access

Use Cases Lost: Headless WordPress authentication, mobile app integration, SPA authentication

Get Simple JWT Login โ†’


Summary: Third-Party Plugin Dependencies

Plugin

Type

Tools Lost

Key Feature Lost

JetEngine

Paid (Crocoblock)

5

Server-side chat transcript storage

WooCommerce

Free

3

E-commerce automation

Elementor

Freemium

2 + Widgets

Elementor template integration

Rank Math

Freemium

1

SEO analysis

WPCode

Freemium

1

Code snippet management

Simple JWT Login

Free

1

JWT token generation

Total Impact: Without these plugins, you lose 13 tools but retain ~300 base tools and all essential AI assistant functionality.


Base Version (Default)

NV oOS runs in Base Version mode by default, providing ~300 essential tools that work with vanilla WordPress without requiring any third-party plugins:

Base Version includes ~300 essential tools that work with vanilla WordPress:

  • Content management (search, save posts, attachments)

  • AI media generation (images via OpenAI/Gemini, speech, transcription, video)

  • Research tools (web search, weather, disaster alerts)

  • Site operations (health checks, logs, cron jobs, cache management)

  • WordPress-native email (via wp_mail)

  • Image manipulation (resize, crop, rotate, convert, vectorize to SVG)

  • Graphic editing (local operations and AI-powered transformations)

  • Profession and assistant management

  • GitHub integration tools

  • Google Maps Platform tools

Base Version excludes 31 tools requiring third-party plugins or external APIs:

  • Third-party WordPress plugins (13 tools) - See ๐Ÿ”Œ What You Lose Without Third-Party Plugins for details

    • WooCommerce tools (3)

    • JetEngine/JetFormBuilder tools (5)

    • Elementor tools (2)

    • RankMath/WPCode/Simple JWT Login tools (3)

  • External API services (18 tools) - Require API credentials

    • Google services (5)

    • Social media integrations (8)

    • External messaging services (4)

    • QuickBooks (1)

Full Version Installation (Opt-in)

To enable the Full Version with all third-party integrations and external API tools, add this constant to your wp-config.php file:

define( 'WP_MCP_AI_BASE_VERSION', false );

๐Ÿ“– See BASE-VERSION.md for the complete tool list and customization options.

When to use Base Version:

  • Starting fresh with WordPress

  • Testing or development environments

  • Simpler installations without external dependencies

  • Sites that don't need e-commerce or advanced integrations

  • Don't want to purchase/install third-party plugins

When to use Full Version:

  • Production sites with WooCommerce, JetEngine, or Elementor already installed

  • Sites needing social media automation (requires API credentials)

  • Advanced workflows requiring external APIs

  • Need server-side chat transcript storage (requires JetEngine)

๐Ÿ“– See detailed breakdown: ๐Ÿ”Œ What You Lose Without Third-Party Plugins


๐Ÿ“š Documentation

NV oOS includes comprehensive documentation covering all aspects of the plugin. Documentation reorganized June 2026 โ€” Unix-theory separation of concerns. All docs sorted into 12 purpose-driven directories with zero content loss.

๐Ÿ“– Documentation Hub

Essential References

๐Ÿ“ฆ Archive

For New Users

  • ๐Ÿš€ Getting Started Wizard โญ NEW โ€” 4-step guided setup that connects your AI provider, selects a use case, and creates a ready-to-use assistant in under 2 minutes. 8 presets available: Content Creator, Customer Support, E-commerce, SEO & Research, Developer Copilot, Media & Creative Studio, Site Administrator, General Purpose.

  • Use Cases & Quickstart Guides โญ NEW - Comprehensive guide covering 7 major use cases with step-by-step quickstarts

  • 5-Minute Quick Start - Get started immediately: from zero to first chat

  • Setup Checklist - Step-by-step installation and configuration

  • Remote Client Quickstart - Connect Claude Desktop, LM Studio, or other MCP clients

  • Best Practices - Recommended usage patterns and optimization tips

For Developers

For Administrators

Performance & Optimization

Historical Documentation

  • Archive Directory - 95+ historical documents organized by category:

    • implementations/ - Implementation summaries and technical details

    • phases/ - Development phase documents

    • fixes/ - Bug fix summaries and issue resolutions

    • features/ - Feature documentation

    • code-reviews/ - Code review reports

    • testing/ - Test infrastructure documentation


โš™๏ธ Configuration Checklist (Action Items)

Complete these after installation to unlock every integration point:

  • Add your OpenAI API key in Settings โ†’ NV oOS โ†’ OpenAI API Key so API calls are authorised.

  • Add your Gemini API key in Settings โ†’ NV oOS โ†’ Gemini API Key if you plan to route assistants through Gemini.

  • Confirm or override the default model via Settings โ†’ NV oOS โ†’ Default Model (gpt-4.1 ships as the default).

  • Set a default Gemini model under Settings โ†’ NV oOS โ†’ Default Gemini Model when Gemini is enabled.

  • Choose the default provider from Settings โ†’ NV oOS โ†’ Default Provider so new assistants know whether to use OpenAI or Gemini by default.

  • Adjust the request timeout under Settings โ†’ NV oOS โ†’ Request Timeout (minimum 5โ€ฏs, default 30โ€ฏs) to match your hosting environment.

  • Select a default assistant with Settings โ†’ NV oOS โ†’ Default Assistant so REST and shortcode requests have a fallback.

  • Decide on logging with Settings โ†’ NV oOS โ†’ Enable Logging when you need verbose diagnostics.

  • Monitor token usage in Settings โ†’ NV oOS โ†’ Token Usage Statistics to track API consumption across users, providers, and models for billing and budget management.

  • Choose your uninstall behaviour via Settings โ†’ NV oOS โ†’ Remove Data on Uninstall if this site should purge assistants and settings during cleanup.

  • Configure Crawl4AI access in Settings โ†’ NV oOS โ†’ Tools when you want the Crawl4AI tool to be available to assistants.

  • Review attachment MIME overrides in Settings โ†’ NV oOS โ†’ Attachments before enabling file uploads for end users.

  • Review Send Group Email permissions in Settings โ†’ NV oOS โ†’ Tools to choose the capability and recipient cap for the group email automation.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L348-L359ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L938-L953ใ€‘

  • Connect Gmail under Settings โ†’ NV oOS โ†’ Tools โ†’ Connections โ†’ Gmail to enable Gmail search tools with OAuth 2.0. See Google OAuth Setup Guide for complete configuration steps.

  • Connect QuickBooks Online under Settings โ†’ NV oOS โ†’ QuickBooks Company ID / API Key so the bundled reporting tool can fetch finance statements for authorised operators.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L906-L955ใ€‘

  • Configure Mailjet credentials in Settings โ†’ NV oOS โ†’ Mailjet API Key / Secret / From Email / From Name before enabling Mailjet-powered tools or Elementor widgets that send email on behalf of assistants.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L1008-L1054ใ€‘

  • Enable Federation & Discovery (Optional) in Settings โ†’ NV oOS โ†’ Federation & Discovery to publish your site's AI capabilities via /.well-known/ai-peer and optionally run a directory service for peer discovery. Configure regions, data tags, and rate limits to control how your site participates in the decentralized AI network.ใ€F:docs/features/federation/federation-discovery.mdโ€ L1-L511ใ€‘ใ€F:FEDERATION-IMPLEMENTATION-SUMMARY.mdโ€ L1-L381ใ€‘

  • Configure Root Security Key (Optional) by adding define( 'WP_MCP_AI_ROOT_SECURITY_KEY', 'your-secure-key' ); to wp-config.php. This provides an additional security layer that can be enabled during emergency shutdown to require authentication before re-initializing the plugin.ใ€F:docs/features/security/root-security-key.mdโ€ L1-L511ใ€‘

  • Enable Pro Dashboard (Optional) by adding define( 'WP_MCP_AI_PRO_DASHBOARD_ENABLED', true ); to wp-config.php. This activates the dedicated Pro Dashboard with ISO/IEC 27001 compliance monitoring, reporting, and management tools. See Pro Dashboard Documentation for details.

๐Ÿง  Language Model Providers (OpenAI, Gemini, Anthropic, Baseten, DeepSeek, OpenRouter, Kimi, DigitalOcean, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare)

A dedicated router transparently forwards chat completions to the active provider, allowing each request to target OpenAI, Gemini, Anthropic, DeepSeek, OpenRouter, Baseten, Kimi, DigitalOcean, NVIDIA NIM, a local Ollama instance, LM Studio, Hugging Face, or Cloudflare Worker AI while sharing the same assistant UX.ใ€F:includes/class-wp-mcp-ai-language-model-router.phpโ€ L12-L86ใ€‘ Configure the required API keys, default models, and the global default provider in Settings โ†’ NV oOS so new assistants inherit sensible defaults and administrators can switch providers without code changes.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L124-L333ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L505-L530ใ€‘ Assistants can still override provider, model, and generation parameters on a per-post basis.

Privacy & Terms: All AI providers have specific terms and privacy policies:

LM Studio Support

LM Studio with Function Calling - Full support for OpenAI-compatible function calling with local LM Studio instances:

  • OpenAI-compatible message structure preserved for tool calls

  • Tools/functions can be invoked by LM Studio models (e.g., qwen/qwen3-coder-30b)

  • Streaming automatically disabled when tools are present for reliable execution

  • Full backward compatibility with non-tool scenarios

  • Connect via JSON-RPC endpoint (recommended) or SSE streaming

  • See LM Studio setup guide for configuration details

Provider Priority List & Automatic Fallback

The plugin includes an intelligent provider priority system that automatically tries alternative providers when the primary one fails or is unavailable. In Settings โ†’ NV oOS, you can:

  • Drag and drop providers to set your preferred order

  • Automatic fallback - if the first provider fails, the system tries the next one

  • Visual management - see all available providers (OpenAI, Gemini, Anthropic, Baseten, DeepSeek, OpenRouter, Kimi, DigitalOcean, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare) in one sortable list

  • Flexible prioritization - adjust based on cost, performance, or availability needs

The first provider in the list serves as the default. If any provider returns an error, the router automatically attempts the next provider in the list until one succeeds. This ensures maximum uptime and resilience without manual intervention. All fallback attempts are logged for debugging and monitoring.

Local AI with Ollama

The Ollama provider enables privacy-focused, cost-free AI processing by connecting to a local Ollama or LM Studio instance running on your server or development machine. This is ideal for:

  • Privacy-sensitive deployments where data must stay on-premises

  • Development and testing without incurring API costs

  • Custom or fine-tuned models not available through cloud providers

  • Air-gapped environments without internet access

To configure Ollama:

  1. Install Ollama on your server or local machine

  2. Pull a model (e.g., ollama pull llama2)

  3. Navigate to Settings โ†’ NV oOS โ†’ Ollama Configuration

  4. Enter your Ollama endpoint URL (default: http://localhost:11434)

  5. Click "Test Connection" to verify connectivity

  6. Click "Fetch Models" to see available models

  7. Select a model from the list or manually enter a model name

  8. Set "Default Provider" to "Ollama (Local AI)" if you want it as the system default

The Ollama client supports the standard chat completion flow and automatically normalizes responses to match the OpenAI format for downstream compatibility. Note that some advanced features like tool calling may vary depending on the specific Ollama model you're using.

OpenAI model coverage

The plugin ships with presets for OpenAIโ€™s current Responses, Reasoning, Audio, and Image APIs so site owners can choose the right model for each workflow. Token windows describe the maximum request size (messages, attachments, and tool payloads) the OpenAI API will accept for that model, while output limits reflect the largest single response the service will stream back. Leave a safety margin below each ceiling so assistants can add system instructions, tool calls, and knowledge snippets without hitting provider limits.

Capability

Model

Max context tokens

Max output tokens

Notes

Responses (flagship)

gpt-5.2

400,000

128,000

Latest flagship multimodal model with 400K context window (Dec 2025). Ideal for large documents and complex workflows.

Responses (pro reasoning)

gpt-5.2-pro

400,000

128,000

Advanced reasoning variant with enhanced capabilities for mission-critical tasks requiring maximum accuracy.

Responses (high throughput)

gpt-5.2-instant

400,000

128,000

High-volume optimized variant for customer support and content generation at scale.

Responses (deep analysis)

gpt-5.2-thinking

400,000

128,000

Deeper analysis variant with reasoning time dial for multi-step analysis and research tasks.

Responses (general)

gpt-4.1

128,000

16,384

Flagship multimodal model that balances quality and latency for production chat, tool, and multimodal calls.

Responses (cost optimised)

gpt-4.1-mini

128,000

16,384

Budget-friendly 4.1 variant recommended for day-to-day assistants and background automations.

Responses (advanced)

gpt-4o

128,000

16,384

Previous generation multimodal model with strong reasoning capabilities.

Responses (legacy)

gpt-4o-mini

128,000

16,384

Lower-latency 4o tier that keeps the larger context window while reducing cost for iterative workflows.

Reasoning

o1-preview

128,000

32,768

Deliberate reasoning model suited to multi-step planning and analysis; expect slower responses while it โ€œthinksโ€.

Reasoning (fast)

o1-mini

128,000

32,768

Lighter o1 variant that trades some reasoning depth for responsiveness in operational assistants.

Media and multimodal defaults

Capability

Model

Size or duration limits

Notes

Image generation

gpt-image-2 (default) / gpt-image-1.5 / gpt-image-1 / dall-e-3

Up to 2048ร—2048 output (square) or 2048ร—1152 / 1152ร—2048 (16:9 / 9:16) for gpt-image-2; proportional 1024 / 512 variants for older models

gpt-image-2 ("Images 2.0") is the default as of v1.1.13 โ€” native 2K resolution, multi-image coherency, and accurate multilingual text rendering. Older models remain selectable. Respect OpenAI's safety filters when prompting.

Text-to-speech

gpt-4o-mini-tts

Up to ~4,096 input tokens per request

Generates natural-sounding speech in multiple voices; longer scripts should be chunked into multiple calls.

Speech-to-text

gpt-4o-mini-transcribe

Optimised for recordings โ‰ค 90 minutes

Handles multilingual transcription and translation; large files are automatically chunked client-side before upload.

OpenAI regularly revises token policies and media limits, so review the model specification dashboard before rolling out new assistants or increasing attachment budgets. Updating your defaults in Settings โ†’ NV oOS keeps every assistant aligned with the latest provider guidance.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L36-L105ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L2298-L2398ใ€‘

๐Ÿงฑ ChatKit Integration

The ChatKit module now ships with the core NV oOS plugin, so no separate add-on installation is required. Once enabled it self-registers through ChatKitโ€™s filter and action APIs as soon as both plugins load, exposing the mcp-ai/v1 REST namespace while advertising chat, tool invocation, attachment download, and guest token support without any manual bootstrapping. Return false from the wp_mcp_ai_chatkit_is_available filter if you need to disable the automatic registration for bespoke environments.ใ€F:includes/class-wp-mcp-ai-chatkit-integration.phpโ€ L30-L204ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L16-L2104ใ€‘

From the ChatKit dashboard configure the NV oOS integration and supply at least one assistant ID so ChatKit knows which conversation to join. Optional fields let you override the system prompt or preload tool shortcut payloads for operators; capability checks inherit the wp_mcp_ai_chat_capability filter, so you can align ChatKit access with the same policies used for shortcodes or REST calls.ใ€F:includes/class-wp-mcp-ai-chatkit-integration.phpโ€ L182-L210ใ€‘ใ€F:mcp-ai-wpoos.phpโ€ L25-L72ใ€‘

Consult docs/developer/integration/chatkit-integration.md for a full configuration walkthrough, JSON examples for shortcut presets, and notes on extending the definition via filters.

๐ŸŒ Crawl4AI Integration

Administrators with manage_options capabilities can run the Run Crawl4AI Job tool without any external service: when no Crawl4AI endpoint is configured the plugin performs the crawl directly on the WordPress server using the built-in HTTP client, extracts headings and text as Markdown, and records the raw HTML and response metadata for the assistant.ใ€F:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ€ L32-L745ใ€‘ Errors for individual URLs are captured in the response metadata so partial crawls still return useful context. When a remote Crawl4AI endpoint is configured the request now returns immediately with a task token while WP-Cron powered background polling captures the final payload and makes it available to the assistant UI once the crawl finishes.ใ€F:includes/crawler/class-wp-mcp-ai-crawler.phpโ€ L1-L214ใ€‘ใ€F:assets/js/chat.jsโ€ L1-L2200ใ€‘

Configure remote endpoints or API keys under Settings โ†’ NV oOS โ†’ Tools to tailor how the Crawl4AI integration runs across environments.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L248-L521ใ€‘

Supplying a Crawl4AI base URL (and optional API key) switches the tool back to proxying crawl jobs to the remote Crawl4AI REST API, preserving backwards compatibility with existing deployments.ใ€F:includes/tools/class-wp-mcp-ai-tool-run-crawl4ai-job.phpโ€ L206-L339ใ€‘ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L248-L521ใ€‘ Local environments can still feed a custom endpoint to the integration through the WP_MCP_AI_CRAWL4AI_BASE_URL or CRAWL4AI_BASE_URL environment variable when you want to test against a dedicated Crawl4AI service.ใ€F:mcp-ai-wpoos.phpโ€ L54-L96ใ€‘

๐Ÿ“ก Job Notification System

NV oOS includes a general-purpose infrastructure for real-time notifications on async WordPress jobs, providing SSE streaming and webhook support for external integrations.ใ€F:docs/features/async-jobs/job-notification-system.mdโ€ L1-L100ใ€‘

Architecture

Async Job โ†’ WordPress Action โ†’ Job Notifier โ†’ [SSE | Webhooks]
                                                 โ†“       โ†“
                                            Frontend  External

Automatic Crawl4AI Integration

The system automatically hooks into Crawl4AI jobs via the wp_mcp_ai_crawl4ai_job_completed action, providing real-time status updates as crawls progress. No additional code is neededโ€”Crawl4AI jobs automatically trigger notifications.ใ€F:includes/crawler/class-wp-mcp-ai-crawler.phpโ€ L1-L214ใ€‘

Frontend SSE Subscription

JavaScript clients can subscribe to job status updates using Server-Sent Events:

const jobId = 'crawl_abc123';
const eventSource = new EventSource(
    `/wp-json/mcp-ai/v1/jobs/${jobId}/stream?max_duration=300&poll_interval=2`
);

eventSource.addEventListener('status', (e) => {
    const status = JSON.parse(e.data);
    console.log('Job status:', status.status, status.progress);
    updateProgressBar(status.progress);
});

eventSource.addEventListener('complete', (e) => {
    const data = JSON.parse(e.data);
    console.log('Job completed:', data.final_status);
    eventSource.close();
});

Webhook Registration

External systems can receive HTTP callbacks when jobs complete:

WP_MCP_AI_Job_Notifier::register_webhook(
    'crawl_abc123',
    'https://example.com/webhook',
    array( 'completed', 'failed' )
);

โžก๏ธ See docs/features/async-jobs/job-notification-system.md for complete implementation details.

๐ŸงŠ Elementor Widgets

Sites running Elementor automatically register a suite of MCP blocks so you can assemble onboarding pages, operational dashboards, and standalone chat layouts without writing markup.ใ€F:includes/class-wp-mcp-ai-elementor-integration.phpโ€ L12-L98ใ€‘ The integration only boots when Elementor is present, so non-Elementor installs avoid any overhead.ใ€F:includes/class-wp-mcp-ai-elementor-integration.phpโ€ L29-L46ใ€‘

Chat surfaces and companion blocks

  • NV oOS Chat โ€“ Renders the assistant interface with the same controls exposed by the [mcp_ai_chat] shortcode, including the allow_guests toggle for minting temporary visitor tokens.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ€ L17-L138ใ€‘

  • NV oOS Chat Bubble โญ NEW โ€“ Floating chat bubble that sits at a configurable screen corner and opens a chat panel powered by the existing [mcp_ai_chat] shortcode. Also available as a Gutenberg block (wp:mcp-ai-wpoos/chat-bubble). 5 control sections: Chat Settings, Bubble Settings (position/size/animation/tooltip/badge/auto-open), Panel Settings, Bubble Style, Panel Style. BEM CSS with 4 positions, 3 sizes, bounce/pulse animations, dark mode, full-screen mobile (<480px), prefers-reduced-motion, WCAG focus states. Public API at window.wpMcpAiChatBubble.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-bubble-widget.phpโ€ L1-L200ใ€‘ใ€F:includes/blocks/chat-bubble/block.jsonโ€ L1-L50ใ€‘

  • NV oOS Chat Intro โ€“ Adds a configurable hero block above the conversation with headings, talking points, and an optional call-to-action button to guide visitors before they engage the model.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-intro-widget.phpโ€ L47-L190ใ€‘

  • NV oOS Chat FAQ โ€“ Surfaces a repeater-driven FAQ list alongside the chat so product teams can document policies and best practices in context.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-faq-widget.phpโ€ L47-L150ใ€‘

  • NV oOS Usage & Timer โ€“ Combines a focus timer with per-user token totals, gracefully handling logged-out visitors, disabled tracking, and empty usage histories.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-chat-usage-timer-widget.phpโ€ L48-L340ใ€‘

Operations dashboards

  • NV oOS Tool Matrix โ€“ Pulls the tool registry, groups integrations by focus area, and highlights the required capability for each assistant tool so administrators can plan enablement safely. The Send Group Email row now mirrors the capability and recipient limit configured in the MCP settings so editorial policies stay front-of-mind.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-tool-matrix-widget.phpโ€ L48-L440ใ€‘

  • NV oOS User Capability Snapshot โ€“ Summarises the signed-in operatorโ€™s profile, common capabilities, JetEngine access, and multisite memberships to support governance reviews. It also surfaces the configured Send Group Email capability and limit so administrators immediately know whether the current user can trigger bulk mail jobs.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-user-capability-widget.phpโ€ L48-L392ใ€‘

  • NV oOS Theme Preview โ€“ Renders a mock conversation using the saved chat color tokens and optionally displays a legend of every branding token for quick QA during rollouts.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-theme-preview-widget.phpโ€ L48-L198ใ€‘

  • NV oOS Provider Quick Links โ€“ Reuses the OpenAI usage/log tools to populate external billing and telemetry shortcuts that open in new tabs for rapid debugging.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-provider-links-widget.phpโ€ L48-L166ใ€‘

  • NV oOS Activity Feed โ€“ Streams the latest MCP log entries (tool runs, chat interactions, and optional provider requests), collapsing raw context into expandable JSON blocks for deeper analysis.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-dashboard-activity-feed-widget.phpโ€ L48-L210ใ€‘

๐Ÿงฎ Usage Tracking

Privacy-First Analytics (v1.2.0+)

The plugin includes optional, privacy-first activation tracking to help us understand plugin usage and improve development priorities. This feature is:

Privacy Features:

  • โœ… No PII collected - No personal information or identifiable data

  • โœ… Site URLs hashed - Non-reversible SHA-256 hash with WordPress salts

  • โœ… No IP storage - IP addresses are not logged or stored

  • โœ… Local dev excluded - Automatically disabled for localhost and common dev domains

  • โœ… Opt-out available - Easy to disable via settings or filter hook

  • โœ… GDPR compliant - Meets all privacy regulations

  • โœ… Fully transparent - All code is open source and documented

Data Collected:

  • Plugin variant (complete, base, pro, or core)

  • Plugin version number

  • WordPress version

  • PHP version

  • Site locale (language)

  • Multisite status

  • Hashed site identifier (non-reversible)

  • Timestamp

How to Opt Out:

  1. Via Settings: Settings โ†’ NV oOS โ†’ General โ†’ Log Management โ†’ Disable Activation Tracking

  2. Via Filter Hook:

    add_filter( 'wp_mcp_ai_enable_usage_tracking', '__return_false' );

Full Privacy Details: See EXTERNAL_SERVICES.md for complete documentation.


The plugin records aggregate token usage per user, provider, and model whenever responses include usage metadata, simplifying internal reconciliation or billing workflows. Usage data is stored as user meta and automatically purged when accounts are deleted, and hooks are exposed for custom reporting pipelines.ใ€F:includes/class-wp-mcp-ai-usage-tracker.phpโ€ L12-L119ใ€‘

Token Usage Management Dashboard

Administrators with manage_options capability can view comprehensive token usage statistics in Settings โ†’ NV oOS:

Global Statistics (All Users):

  • Total requests across all users

  • Total tokens consumed (prompt + completion)

  • Prompt tokens used

  • Completion tokens generated

  • Cached tokens (for providers supporting prompt caching)

  • Reset all usage data button (with confirmation)

Individual User Statistics:

  • Your personal token consumption

  • Per-user breakdown of requests and tokens

  • Reset personal usage data button

Detailed Breakdown:

  • Usage by provider (OpenAI, Gemini, Anthropic, NVIDIA NIM, Ollama, LM Studio, Hugging Face, Cloudflare)

  • Usage by specific model (e.g., gpt-4.1-mini, gemini-2.0-flash)

  • Request counts per provider/model combination

  • Last used timestamp for each model

  • Comprehensive table view with all metrics

The usage tracking system automatically:

  • Records usage from all API responses that include usage metadata

  • Aggregates data by user, provider, and model

  • Updates in real-time as conversations occur

  • Supports the Open OpenAI Usage tool for quick access to provider dashboards

  • Provides AJAX-powered reset functionality for administrators

๐Ÿงท Attachment MIME Controls

Administrators can override the default image and file MIME allowlists used by the chat uploader. The settings screen accepts one MIME type per line, and the attachment helper merges the overrides with its defaults before enforcing them on upload and shortcode configuration.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L225-L669ใ€‘ใ€F:includes/class-wp-mcp-ai-message-attachments.phpโ€ L503-L559ใ€‘ Leave the fields empty to fall back to the bundled safe defaults.

โšก Message Bundling

NV oOS implements client-side message bundling to optimize API usage and reduce server load. When enabled, messages sent within an 800ms window are automatically grouped into a single API request, reducing costs and improving performance for users who send multiple messages in quick succession.ใ€F:docs/user-guides/chat/message-bundling-feature.mdโ€ L1-L80ใ€‘

How It Works

  1. User sends a message โ†’ Displayed immediately in the chat UI

  2. 800ms timer starts โ†’ System waits for additional messages

  3. More messages arrive โ†’ Timer resets with each new message

  4. Timer expires โ†’ All queued messages sent together in one request

Visual Feedback

  • "Preparing to sendโ€ฆ" - Messages are being queued during the bundling window

  • "Sendingโ€ฆ" - Bundled messages are being transmitted to the server

Benefits

  • Reduced API costs - Fewer requests mean lower costs for pay-per-request APIs

  • Lower server load - Fewer requests to process and respond to

  • Better mobile experience - Ideal for users who type in short bursts

  • Backward compatible - Server code unchanged, same payload format

Configuration

Message bundling is enabled by default and requires no configuration. To disable for debugging:

window.wpMcpAiChatDebugMode = true;

โžก๏ธ See docs/user-guides/chat/message-bundling-feature.md for configuration options and implementation details.

๐ŸŽฏ Agentic Loop Token Management

NV oOS includes intelligent handling for tools that return large responses, preventing token overflow errors during agentic loops (where the AI automatically calls multiple tools).ใ€F:docs/features/tools/presets/high-token-tool-handling.mdโ€ L1-L80ใ€‘

The Problem

Tools like run_crawl4ai_job can return 100,000+ tokens of content. In agentic loops, each API call includes all previous messages, causing token counts to grow rapidly and exceed model limits (e.g., gpt-4.1-mini's 200k TPM limit).

The Solution: Three-Tier Strategy

Tier 1: Token Limit Detection

  • Estimates total tokens before each API call

  • Checks against model's TPM (Tokens Per Minute) limit

  • Prevents requests that would exceed limits

Tier 2: Automatic Model Switching

  • When limits exceeded, auto-switches to fallback model

  • Default fallback: Gemini 2.0 Flash (1-2 million token capacity)

  • Preserves full context without data loss

  • Transparent to the user

Tier 3: Message Truncation

  • If even fallback model can't handle tokens

  • Truncates older messages from conversation

  • Always preserves system prompts and recent context

  • Logs what was truncated for debugging

Configuration

Automatic model switching is enabled by default. Configure fallback model under Settings โ†’ NV oOS:

// Default fallback model
'fallback_model' => 'gemini-2.0-flash-exp'

โžก๏ธ See docs/features/tools/presets/high-token-tool-handling.md for complete technical details and examples.

๐Ÿ”„ Chat Performance Optimizations

NV oOS includes several performance optimizations to enhance the chat experience:

  • Message bundling - Reduces API calls by grouping rapid user inputs

  • Token budget management - Prevents API limit overruns with safety marginsใ€F:docs/features/performance/tpm-limit-validation.mdโ€ L1-L50ใ€‘

  • Chat history persistence - LocalStorage (24h) + optional JetEngine CCT storageใ€F:docs/user-guides/chat/chat-history-persistence.mdโ€ L1-L50ใ€‘

  • Automatic model switching - Seamlessly handles token overflow scenarios

  • Rate limit protection - Intelligent retry with exponential backoffใ€F:docs/features/performance/rate-limit-protection.mdโ€ L1-L50ใ€‘

โžก๏ธ See docs/features/chat/chat-performance-optimizations.md for detailed performance tuning guide.

๐ŸŒ Mesh Compute Routing

NV oOS includes intelligent mesh compute routing that automatically distributes AI workload across multiple sites OR multiple providers using AI-powered decision-making. This feature works in two modes:

  1. Multi-Site Mesh: Distribute load across multiple WordPress installations

  2. Single-Site Multi-Provider: Balance load across OpenAI, Gemini, Anthropic, NVIDIA NIM, Hugging Face, Cloudflare, and Ollama on one site

Both modes use the same AI-powered routing engine to optimize for cost, performance, and reliability.

Key Capabilities

  • AI-Optimized Routing - Analyzes prompt complexity and routes to optimal provider/site

  • Cost Optimization - Use GPT-4o-mini for simple queries, GPT-4o for complex tasks

  • Automatic Failover - Switch providers on rate limits or outages

  • Compute Hubs - Designate powerful servers for heavy workloads

  • Rate Limit Management - Auto-switch to alternative providers when limits hit

  • Privacy Control - Route sensitive data to local Ollama instances

Quick Start Examples

Single-Site Setup (No mesh required):

  • Configure multiple AI providers (OpenAI + Gemini + Anthropic + Hugging Face + Cloudflare + Ollama)

  • Set assistant routing strategy to "AI Optimized"

  • Save 90% on costs by routing simple queries to cheaper models

Multi-Site Setup (Distributed compute):

  • Enable mesh networking on all sites

  • Designate compute hubs with larger models

  • Automatic load balancing across peer sites

  • Cross-server compute pooling for Cloudways, SiteGround, etc.

โžก๏ธ See docs/features/federation/mesh-routing-guide.md for complete setup guide, routing strategies, and use cases. โžก๏ธ See docs/features/federation/mesh-compute-pooling.md for architecture and authentication details.

๐Ÿ”— Federation & Discovery System

NV oOS includes a decentralized AI capability network that allows WordPress sites to publish their capabilities and discover peer sites. Think of it as "npm for AI tools" โ€” sites can advertise what they offer and find complementary capabilities from trusted peers.

Overview

The Federation & Discovery system provides three deployment modes:

  1. Publisher Mode: Publish your site's capabilities via /.well-known/ai-peer

  2. Directory Mode: Run a discovery service for peer registration and search

  3. Consumer Mode: Query directories to find and use peer capabilities

Quick Start

Enable Federation (Publisher Mode):

  1. Navigate to Settings โ†’ NV oOS โ†’ Federation & Discovery

  2. Check Enable federation

  3. Configure regions (e.g., us, eu, ap) and data tags (e.g., no_pii, gdpr_ok)

  4. Your capabilities are now published at https://yoursite.com/.well-known/ai-peer

Enable Directory Service (Optional):

  1. In the same settings section, check Enable directory service

  2. Your directory API is now available at https://yoursite.com/wp-json/ai-dir/v1

  3. Automatic hourly health checks verify registered peers

Key Features

  • ๐Ÿ“ก Well-Known Endpoints - Standards-based capability publishing

  • ๐Ÿ” Peer Discovery - Search by capability, region, and data policy

  • โœ… Health Monitoring - Automatic cron-based peer verification

  • ๐Ÿ† Smart Ranking - Scores peers by region, latency, and policy match

  • ๐Ÿ” JWKS Verification - Built-in security with public key discovery

  • โš™๏ธ Conditional Loading - Zero overhead when disabled

API Endpoints

Directory REST API (/wp-json/ai-dir/v1):

  • POST /peers/register - Register a new peer

  • GET /peers - List all peers with health status

  • GET /peers/{id} - Get peer details

  • GET /search - Search peers by capability/region/policy

  • POST /reverify/{id} - Manually trigger health check

  • POST /report/{id} - Report peer issues

Well-Known Endpoints:

  • GET /.well-known/ai-peer - Your site's capability manifest

  • GET /.well-known/jwks.json - Public keys for verification

Use Cases

Private Organization Network:

  • Multiple WordPress sites within one organization

  • Share AI capabilities across internal sites

  • Central directory for discovery

  • Private peer network with secure authentication

Public Directory Service:

  • Community-run capability discovery

  • Accept registrations from external sites

  • Provide search API for consumers

  • Build an ecosystem marketplace

Capability Consumer:

  • Query public directories for needed capabilities

  • Integrate with mesh router for automatic peer selection

  • No need to publish your own capabilities

  • Access specialized tools from the network

Configuration Options

  • Regions: Geographic locations (e.g., us, eu, ap, global)

  • Data Tags: Compliance policies (e.g., no_pii, gdpr_ok, hipaa_like)

  • QPS Limit: Queries per second (default: 5)

  • Burst Capacity: Simultaneous requests (default: 10)

โžก๏ธ Complete Documentation: docs/features/federation/federation-discovery.md โžก๏ธ Implementation Summary: FEDERATION-IMPLEMENTATION-SUMMARY.md

๐Ÿ•ต๏ธ Code Review

The 2025-10-31 internal review confirms the hardening of the group email automation (header filtering and attachment caps) and the case-sensitive variable handling in the OpenAI external action tool, and only flags a low-severity performance concern around guest token transient churn for public chat embeds. These findings have been consolidated into the master code review document. One follow-up action item recommends re-using or rate-limiting guest tokens to keep the options table tidy on cache-less hosts.

โžก๏ธ See docs/developer/best-practices/CODE-REVIEW-MASTER.md for the complete code quality assessment.

๐Ÿ”’ MCP Server Authentication

Remote MCP assistants should authenticate with Auth0-issued bearer tokens (Authorization: Bearer YOUR_TOKEN) whose audience and scope align with the values configured under Settings โ†’ NV oOS. Same-origin experiences (the dashboard editor and shortcode UI) continue to rely on the X-WP-Nonce header tied to the logged-in WordPress session. Review docs/reference/api/mcp-server-authentication.md for a complete setup guide plus a breakdown of the structured error responses returned on failure, and keep the deployment troubleshooting checklist handy when diagnosing capability or credential regressions.

MCP transports (v1.1.55+): POST /wp-json/mcp-ai/v1/mcp speaks JSON-RPC 2.0 over Streamable HTTP by default. Legacy HTTP+SSE clients (SSE-only Accept: text/event-stream or ?stream=true) get a credential-bound session handshake from GET /mcp and receive responses as event: message on the GET stream โ€” enable with WP_MCP_AI_LEGACY_SSE_ENABLED. JSON-RPC errors return HTTP 200 with the {"jsonrpc","id","error"} envelope so agent SDKs that drop non-2xx bodies relay tool errors instead of hanging; auth/permission failures keep real HTTP statuses. Assistant credential headers may be sent as Authorization: Bearer cred_xxxxx.SECRET or raw Authorization: cred_xxxxx.SECRET. Tool-call traffic is governed by the settings-driven tool rate limiter (credential tokens exempt by default), and GET/HEAD discovery probes never consume the request quota. See docs/developer/implementation-plan-mcp-agent-compat.md and docs/developer/legacy-sse-transport-plan.md for the full rationale.

Using NV oOS as an MCP server

  1. Install the plugin and create assistants. Each WordPress instance that activates NV oOS exposes an MCP-ready assistant directory backed by the ai_assistant custom post type, so every published assistant becomes available to remote clients once credentials are issued.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L460-L620ใ€‘

  2. Configure the REST and connector settings. Populate the Auth0, model provider, and optional integration credentials under Settings โ†’ NV oOS so the REST controller can advertise the correct namespace URLs and enforce bearer tokens per your tenant, scope, and provider defaults.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L36-L118ใ€‘

  3. Expose the MCP directory endpoints. The REST layer publishes /assistants, /chat, /tools, and an SSE-compatible /sse handshake inside the wp-json/mcp-ai/v1 namespace, automatically scoping responses to the authenticated assistant or returning every assistant the caller may read.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L234-L703ใ€‘ Hand-held clients can subscribe to the streaming directory event or call the JSON routes directly using the base URLs returned in the directory payload.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L653-L703ใ€‘

  4. Register any additional tools. Extend the serverโ€™s capabilities by hooking into wp_mcp_ai_register_tools and loading custom tool classes; registered slugs flow through the assistant directory and tool execution endpoint without extra wiring.ใ€F:includes/class-wp-mcp-ai-tool-registry.phpโ€ L75-L195ใ€‘

  5. Verify the deployment before sharing credentials. Run wp mcp-ai remote https://example.com/wp-json/mcp-ai/v1 --token=YOUR_TOKEN from any WP-CLI environment to confirm authentication, assistant scope, and chat probes succeed before you hand tokens to operators or client teams.ใ€F:includes/class-wp-mcp-ai-cli-command.phpโ€ L137-L220ใ€‘

Operating multiple MCP deployments

Provision a separate WordPress site (or network site) for each MCP server you need, activate NV oOS, and repeat the configuration steps above with environment-specific Auth0 audiences, scopes, and provider keys. Because the assistant directory response includes the resolved REST base and namespace metadata, MCP clients can be pointed at different deployments simply by swapping the base URL and the bearer credential minted for that siteโ€™s assistants.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L48-L118ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L653-L703ใ€‘

Sites that enable the Simple JWT Login integration can now reuse those bearer tokens alongside Auth0 credentials. The plugin validates tokens with Simple JWT Loginโ€™s native services, falls back to manual JWT decoding when the dependency cannot resolve a user, and automatically scopes REST requests to the assistant encoded in the token so cross-assistant hops are blocked with actionable errors.ใ€F:includes/class-wp-mcp-ai-simple-jwt-login-integration.phpโ€ L47-L214ใ€‘ใ€F:includes/integrations/class-wp-mcp-ai-integration-simple-jwt.phpโ€ L240-L378ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L2769-L2808ใ€‘

๐ŸŒ Connecting Remote MCP Clients

NV oOS works seamlessly with popular MCP clients including Claude Desktop, LM Studio, and ChatGPT connectors. Each client connects to your WordPress site via the MCP REST API at /wp-json/mcp-ai/v1 and can access assistants, execute tools, and interact with your WordPress data remotely.

SSE Support: All MCP endpoints support Server-Sent Events (SSE) for real-time streaming. Enable SSE in your client configuration for better response times and real-time updates. See the SSE Streaming Support section for details.

Quick Start

  1. Generate an assistant credential from any published assistant's API Credentials meta box

  2. Copy the token (format: cred_xxxxx.SECRET) โ€” shown only once!

  3. Configure your MCP client with your site's base URL and the credential

  4. Test the connection using the provided test script or WP-CLI command

Claude Desktop setup

Claude Desktop supports MCP servers through a JSON configuration file. Add your WordPress site:

{
  "mcpServers": {
    "wordpress-site": {
      "url": "https://your-site.com/wp-json/mcp-ai/v1",
      "headers": {
        "Authorization": "Bearer cred_xxxxx.SECRET"
      },
      "sse": true
    }
  }
}

See the complete Claude Desktop setup guide and example configurations for multi-assistant deployments.

LM Studio Setup

โš ๏ธ Having SSE content-type errors? Use the JSON-RPC endpoint instead!

LM Studio can connect using two methods:

Use this if you're getting SSE error: Invalid content type, expected "text/event-stream":

{
  "servers": [
    {
      "id": "wordpress-mcp",
      "name": "WordPress Site",
      "url": "https://your-site.com/wp-json/mcp-ai/v1/mcp",
      "auth": {
        "type": "bearer",
        "token": "cred_xxxxx.SECRET"
      },
      "timeout": 30000
    }
  ]
}

Configure in LM Studio:

  • Server Name: WordPress Site

  • URL: https://your-site.com/wp-json/mcp-ai/v1/mcp

  • Auth Type: Bearer Token

  • Token: cred_xxxxx.SECRET

  • Do NOT enable SSE

Method 2: SSE Streaming (Optional)

If you want to use SSE for real-time updates:

  • Base URL: https://your-site.com/wp-json/mcp-ai/v1

  • Enable SSE: โœ“ (checked)

  • SSE Endpoint: /sse

See the complete LM Studio setup guide and example configurations:

ChatGPT connector setup

โš ๏ธ Note: ChatGPT connectors currently require Auth0 authentication. Assistant-issued credentials are not yet supported by OpenAI's ChatGPT platform.

To connect via ChatGPT:

  1. Configure Auth0 in Settings โ†’ NV oOS

  2. Generate an Auth0 access token with the configured audience

  3. Add the MCP server in ChatGPT's connector settings

See the ChatGPT connector guide for detailed Auth0 setup steps.

Testing your connection

Use the built-in test script to verify connectivity:

./bin/test-remote-connection.sh \
  -u https://your-site.com/wp-json/mcp-ai/v1 \
  -t cred_xxxxx.SECRET

Or use WP-CLI:

wp mcp-ai remote https://your-site.com/wp-json/mcp-ai/v1 \
  --token=cred_xxxxx.SECRET

Expected output confirms the server is reachable and lists available assistants.

Complete documentation

For comprehensive setup guides, troubleshooting, and advanced configurations, see:


๐ŸŽซ Token Management UI

NV oOS 1.0.0 introduces a centralized Token Manager for managing all external agent access tokens across your assistants. Access it via NV oOS โ†’ Token Manager in the admin menu.

Features

  • Centralized Control - Manage all assistant credentials in one place

  • Security Best Practice - Tokens shown only once after creation (cannot be retrieved later)

  • Lifecycle Management - Create, view, revoke, and delete credentials

  • Audit Trail - Track who created/revoked each token and when

  • Metadata Display - See creation date, status (active/revoked), associated assistant

  • Bulk Visibility - View credentials across all assistants at a glance

How It Works

The Token Manager follows industry standards similar to GitHub Personal Access Tokens, Stripe API keys, and Auth0 credentials:

  1. Create Token - Generate new credentials from the assistant editor

  2. Copy Immediately - Token shown once and cannot be retrieved later

  3. Use in MCP Clients - Configure external applications (Codex CLI, MCP clients, custom integrations)

  4. Revoke When Needed - Disable compromised tokens without deleting audit history

  5. Delete When Done - Permanently remove tokens and all metadata

Security Notes

  • Tokens are hashed before storage (only hash stored, never plaintext)

  • Requires manage_options capability

  • All actions logged with user attribution

  • Revoked tokens cannot be reactivated (must create new)

  • HTTPS strongly recommended for token transmission

Usage Example

# In assistant editor: Create credential โ†’ Copy token immediately
# Token format: cred_[YOUR_PREFIX].[YOUR_SECRET_KEY_HERE]
# Example format only - never share real tokens!

# Configure MCP client (e.g., Codex CLI)
export WPOOS_BEARER_TOKEN="your_token_here"
codex chat --assistant 123 "Hello world"

# Later: Revoke from Token Manager UI if compromised
# Or: Delete entirely when integration removed

โš ๏ธ Security Warning: The examples above use placeholder tokens. Never share real tokens publicly or commit them to version control.

Access Requirements

  • Capability: manage_options (administrators only)

  • Menu Location: NV oOS โ†’ Token Manager

  • REST API: /wp-json/mcp-ai/v1/token-manager/*

For complete documentation, see Token Management Guide.


๐Ÿค– ChatGPT Connector

OpenAIโ€™s ChatGPT connector beta currently authenticates exclusively through Auth0. Because NV oOS issues its own assistant-scoped bearer credentials, you can connect LM Studio, Claude Desktop, and other MCP-aware clients today, while ChatGPT support will require either Auth0 bridging or native bearer support from OpenAI. Weโ€™ll update this section as soon as ChatGPT adds compatibility with first-party tokens.ใ€F:docs/reference/api/mcp-server-authentication.mdโ€ L22-L46ใ€‘

๐Ÿ›ฐ REST API Endpoints

All front-end chat surfaces ultimately call the MCP REST namespace at /wp-json/mcp-ai/v1, which exposes dedicated endpoints for chat completions and direct tool execution. Both routes share the same authentication rules described above: supply an Auth0 bearer token, a plugin-issued assistant credential, or a WordPress REST nonce for same-origin requests. Guest tokens issued by the shortcode or Elementor widget continue to be honoured when allow_guests="true" is enabled.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L230-L322ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L289-L343ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1288-L1336ใ€‘

  • GET /assistants โ€“ Returns a directory of accessible assistants with provider defaults, tool counts, capability metadata, and implementation details so remote clients can choose which assistant to call. Credential tokens are automatically scoped to their issuing assistant while Auth0 tokens and REST nonces surface every published assistant the caller can read.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L238-L666ใ€‘ The endpoint also supports Server-Sent Events for MCP clients that expect streaming discovery payloads, emitting a single directory event with cache-busting headers before closing the stream.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1690-L1772ใ€‘

  • GET /sse โ€“ Mirrors the assistant directory response but forces a Server-Sent Events handshake so MCP clients that negotiate /sse subscriptions receive the streaming directory payload without additional query parameters.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L400-L715ใ€‘

  • POST /chat โ€“ Normalises structured messages, injects assistant defaults, auto-enables the Submit Document Prompt tool when uploads are present, and forwards the request through the language model router. Responses include the assistant ID and the raw provider payload so clients can stream or render messages as needed.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L230-L322ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L931-L1095ใ€‘

  • POST /tools โ€“ Executes a specific registered tool outside of a chat turn. The endpoint enforces assistant tool allowlists, scopes credential-based requests to the issuing assistant, merges assistant defaults (such as external action identifiers), and returns the tool result with execution metadata.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L264-L322ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1162-L1321ใ€‘

See docs/reference/api/rest-api.md for payload examples, attachment handling rules, and troubleshooting tips when integrating custom clients.

๐ŸŒŠ SSE Streaming Support

NV oOS includes comprehensive Server-Sent Events (SSE) support for real-time streaming responses, enabling faster perceived response times and better user experience.

What is SSE?

Server-Sent Events provide unidirectional server-to-client streaming over HTTP, allowing the server to push updates as they become available rather than waiting for the complete response.

Benefits:

  • โšก Faster perceived response time - Users see content immediately as it's generated

  • ๐Ÿ”„ Real-time updates - Progressive loading for long-running operations

  • ๐Ÿ“ถ Connection keep-alive - Prevents timeouts during lengthy responses

  • ๐ŸŽฏ Better UX - ChatGPT-style typing effect for AI responses

SSE-Enabled Endpoints

1. Assistant Directory Streaming (GET /assistants)

Stream the assistant directory for MCP clients expecting SSE handshakes:

curl -H "Accept: text/event-stream" \
  https://your-site.com/wp-json/mcp-ai/v1/assistants

The endpoint emits a single directory event with all accessible assistants, then closes the connection.

2. Dedicated SSE Endpoint (GET /sse)

Force SSE mode for MCP clients that specifically probe the /sse endpoint:

curl https://your-site.com/wp-json/mcp-ai/v1/sse

This mirrors the /assistants response but always uses SSE format, ensuring compatibility with LM Studio and Claude Desktop.

3. Job Status Streaming (GET /jobs/{job_id}/stream)

Subscribe to real-time updates for async operations like Crawl4AI jobs:

const eventSource = new EventSource(
    `/wp-json/mcp-ai/v1/jobs/${jobId}/stream?max_duration=300&poll_interval=2`
);

eventSource.addEventListener('status', (e) => {
    const status = JSON.parse(e.data);
    console.log('Progress:', status.progress + '%');
});

eventSource.addEventListener('complete', (e) => {
    console.log('Job finished:', e.data);
    eventSource.close();
});

SSE Configuration

Enable POST Method for SSE (LM Studio Compatibility)

By default, SSE uses the standard GET method. For clients with SSE bugs (like LM Studio), enable POST support:

  1. Go to Settings โ†’ NV oOS โ†’ Assistant Settings

  2. Enable "Enable POST Method on SSE Endpoint"

  3. Save settings

โš ๏ธ Note: Standard SSE specification uses GET. Only enable POST if you experience client compatibility issues.

Modern SSE Features (2024-2025)

The SSE implementation includes current best practices:

  • Automatic reconnection with retry: directive (3-second interval)

  • Event IDs for tracking reconnection state

  • HTTP/2 compatibility for multiplexing

  • Proper CORS headers for cross-origin requests

  • Cache-Control directives to prevent proxy buffering

  • Heartbeat messages to keep connections alive

Frontend Integration

Enable SSE streaming in your JavaScript client:

// Request streaming in chat
const response = await fetch('/wp-json/mcp-ai/v1/chat', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Accept': 'text/event-stream',
        'X-WP-Nonce': wpMcpAi.nonce
    },
    body: JSON.stringify({
        assistant_id: 123,
        messages: [{ role: 'user', content: 'Hello' }],
        stream: true
    })
});

// Process SSE stream
const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = '';

while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    
    buffer += decoder.decode(value, { stream: true });
    const events = buffer.split('\n\n');
    buffer = events.pop();
    
    for (const event of events) {
        if (event.startsWith('data: ')) {
            const data = JSON.parse(event.substring(6));
            // Update UI with streaming chunk
            updateChatUI(data);
        }
    }
}

Documentation

For complete SSE implementation details, configuration options, and troubleshooting:

๐Ÿ“ MCP JSON-RPC 2.0 Endpoint

NV oOS implements a dedicated /mcp endpoint that follows the Model Context Protocol specification version 2024-11-05 using JSON-RPC 2.0 for bidirectional communication with AI assistants and tools.ใ€F:docs/reference/api/mcp-endpoint.mdโ€ L1-L80ใ€‘

MCP Version: 2024-11-05
Compliance: Full MCP 2024-11-05 โ€” all 11 protocol methods, OAuth 2.1, Streamable HTTP, JSON-RPC batching, tool annotations, session management

What's New in MCP 2024-11-05

The latest specification is fully implemented:

  • OAuth 2.1 Security: PKCE, token rotation, mandatory HTTPS

  • Streamable HTTP Transport: Better reconnection and bidirectional communication

  • JSON-RPC Batching: Efficient parallel task processing (up to 20 messages per batch)

  • Tool Annotations: readOnlyHint, destructiveHint, idempotentHint, openWorldHint metadata

  • Progress Notifications: Descriptive status updates during tool execution

  • Completions: Argument autocompletion for tools and prompts

  • Session Management: State recovery via Mcp-Session-Id header (1h TTL)

  • Logging: Client-controlled log verbosity via logging/setLevel

  • Cancellation: Request cancellation via notifications/cancelled

Endpoint URL

POST /wp-json/mcp-ai/v1/mcp

JSON-RPC 2.0 Format

All requests must use standard JSON-RPC 2.0 format:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "initialize",
  "params": {}
}

Supported Methods

  • initialize - Initialize MCP connection and retrieve server capabilities

  • ping - Server liveness check

  • tools/list - List available tools with annotations for the authenticated assistant

  • tools/call - Execute a specific tool with progress notifications support

  • resources/list - List available resources (knowledge files, etc.) with metadata

  • resources/read - Read resource content by URI with MIME-typed responses

  • prompts/list - List available prompt shortcuts

  • prompts/get - Get full prompt content with system instructions and argument values

  • completion/complete - Argument autocompletion (enum/boolean for tools, slug matching for prompts)

  • logging/setLevel - Client-controlled log verbosity (8 standard levels)

  • notifications/cancelled - Cancel a pending request

Authentication (OAuth 2.1 Enhanced)

The MCP endpoint uses enhanced authentication aligned with MCP 2024-11-05 security standards:

  • WordPress Nonce (X-WP-Nonce header)

  • Bearer Tokens (Authorization: Bearer <token>) with rotation support

  • Assistant Credentials (generated from assistant editor, OAuth 2.1 compliant)

  • Auth0 JWT (for enterprise authentication)

  • Session Management (Mcp-Session-Id header for reconnection)

Error Handling

Enhanced Error System (Phase 3):

  • Severity Levels: CRITICAL, ERROR, WARNING, INFO, DEBUG for categorized logging

  • User-Friendly Messages: Automatic translation of technical errors into actionable guidance

  • Recovery Suggestions: Built-in troubleshooting steps for common failure scenarios

  • Centralized Error Handler: Consistent error creation with automatic logging

  • Comprehensive Logging: Track errors, tool executions, and chat interactions

  • Sensitive Data Protection: Automatic redaction of API keys and tokens in logs

See Error Handling Documentation for detailed usage.

MCP Standard Error Codes:

  • -32700: Parse error (invalid JSON)

  • -32600: Invalid Request (malformed JSON-RPC)

  • -32601: Method not found

  • -32603: Internal error

Use Cases

Scenario

Use Endpoint

Method

MCP 2024-11-05 Feature

Remote MCP client connection

/mcp

POST

OAuth 2.1, Sessions

Real-time streaming responses

/sse

GET

Traditional SSE

Streamable HTTP (new)

/mcp

POST

Bidirectional streaming

Standard chat interface

/chat

POST

N/A

Direct tool execution

/tools

POST

Tool annotations

Learn More

โžก๏ธ Complete MCP Documentation:


๐Ÿ›  Assistant Editor Overview

Assistant posts ship with dedicated controls that map directly to runtime behaviour:

  • Available Tools โ€“ Choose which registered tools (core, WooCommerce, JetEngine, or custom) the model may invoke. Dependency-aware notices explain why certain tools are unavailable, and you can now disable the pre-built prompt shortcuts that tools normally contribute.

  • Quick Tool Selection Presets โ€“ one-click presets group the current live registry by use-case (๐Ÿค– Agentic Workflow, ๐Ÿ›’ E-commerce, โš•๏ธ Healthcare, ๐Ÿ’ฌ Communication, ๐Ÿ’ป Development, ๐Ÿ“‹ Registration & Compliance, and more). Click a preset to add its tools to the current selection; click again to remove them. Combine multiple presets freely. Use โœ“ Select All / โœ— Clear All for bulk actions. Implemented in includes/helpers/class-wp-mcp-ai-tool-presets-helper.php.

  • Model Defaults โ€“ Provide assistant-specific overrides for the OpenAI model, temperature (0โ€“2), and system prompt applied to every conversation.

  • Base Knowledge โ€“ Attach Media Library items that are chunked, truncated, and streamed as memory context, and optionally store an external Vector Store ID to coordinate retrieval workflows.

  • Prompt Shortcuts โ€“ Capture labelled prompts with optional descriptions and tool affinities; they render as accessible quick actions in the chat UI so operators can seed conversations instantly.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L893-L1048ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L430-L693ใ€‘ใ€F:assets/js/chat.jsโ€ L600-L666ใ€‘

If an API or shortcode request omits the assistant parameter, the plugin automatically uses the default assistant configured in the global settings.

๐Ÿ“Š Assistant Storage: CPT vs CCT

NV oOS uses a Custom Post Type (CPT) as the primary storage for AI assistants, with automatic synchronization to a JetEngine Custom Content Type (CCT) when JetEngine is available.

Storage Architecture

  • CPT (mcp_ai_assistant): The authoritative source for all assistant data

    • Full-featured WordPress editor with 14 meta fields

    • Supports credentials, shortcuts, memory files, and advanced features

    • Always available in both Base and Full versions

    • Primary REST endpoint: /wp-json/mcp-ai/v1/

  • CCT (assistants): Synchronized secondary storage (Full Version only)

    • Receives automatic updates when CPT is saved

    • 7 basic fields: title, description, provider, model, system_prompt, temperature, tools

    • Available via JetEngine REST endpoint: /wp-json/jet-cct/assistants

    • Ideal for JetEngine-based integrations and queries

Automatic Synchronization (v1.0.0+)

When you save an assistant through the WordPress admin:

  1. CPT is updated with all settings

  2. CCT is automatically synced (if JetEngine is active)

  3. Link is maintained via _wp_mcp_ai_cct_item_id meta

  4. Deletion cascades - removing CPT also removes linked CCT item

What gets synced: Basic configuration (title, description, provider, model, system_prompt, temperature, tools)
What's CPT-only: Advanced features (credentials, shortcuts, memory files, role rules, vector store, external actions)

When to Use Each Endpoint

Use CPT endpoint (/wp-json/mcp-ai/v1/) for:

  • Chat, tools, and directory interactions

  • Full assistant configuration access

  • Credential-based authentication

  • Primary integration scenarios

Use CCT endpoint (/wp-json/jet-cct/assistants) for:

  • JetEngine-specific queries and filters

  • Building JetEngine relations

  • Integrating with JetEngine dashboards

  • Querying basic assistant metadata

โžก๏ธ Read the complete CPT vs CCT guide for detailed comparisons, code examples, and migration information.

โšก Assistant Tool Shortcuts

Every assistant exposes a Prompt Shortcuts meta box so editors can curate prewritten instructions, scope them to registered tools, and add operator-facing descriptions that appear as tooltips and screen reader hints in the chat UI.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L893-L1048ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L430-L693ใ€‘ใ€F:assets/js/chat.jsโ€ L600-L666ใ€‘ The shortcode merges these custom prompts with each toolโ€™s declared shortcut tasks and always appends a safe fallback so assistants remain usable even without bespoke entries.ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L430-L693ใ€‘

Developers can extend or replace these prompts with filters such as wp_mcp_ai_assistant_custom_tool_shortcuts and wp_mcp_ai_default_tool_shortcut, letting sites tailor default quick actions per assistant or environment.ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L444-L692ใ€‘

โžก๏ธ Read the full guide to assistant prompt shortcuts.

๐Ÿง  Agent Skills

Agent Skills (agentskills.io) are reusable, portable behaviour packages that extend any assistant without touching its system prompt. Each skill is a SKILL.md file โ€” a standard Markdown document with a small YAML frontmatter block โ€” that lives in wp-content/uploads/mcp-ai-skills/{skill-name}/SKILL.md. When an assistant loads a skill, its instructions are automatically injected into the conversation context so the model knows exactly when and how to use that capability.

67 Pre-Built Skills (Base Plugin)

The base plugin ships with 67 pre-built skills that are automatically installed to wp-content/uploads/mcp-ai-skills/ on first activation. No Pro add-on is required โ€” they are available on every install out of the box. The skills include 24 general-purpose tools (document handling, design, testing), 22 WordPress developer skills (security, APIs, plugin patterns), 21 design-* skills (analytics through video creation), and the bundled mcp-ai-wpoos-plugin skill.

Skill slug

What it does

algorithmic-art

Generates algorithmic art with p5.js, seeded randomness, and interactive parameters

brand-guidelines

Applies Anthropic's official brand colours and typography to any artifact

canvas-design

Creates beautiful visual art in PNG/PDF documents using design philosophy

doc-coauthoring

Guides users through a structured co-authoring workflow for documentation

docx

Creates, reads, edits, and manipulates Word .docx files

frontend-design

Produces distinctive, production-grade frontend interfaces with high design quality

internal-comms

Drafts all kinds of internal communications (memos, announcements, updates)

mcp-builder

Guides creation of high-quality MCP (Model Context Protocol) servers

pdf

Handles any PDF task โ€” creation, reading, editing, and form filling

pptx

Handles any .pptx PowerPoint file as input or output

skill-creator

Creates, modifies, and measures the performance of other skills

slack-gif-creator

Creates animated GIFs optimised for Slack with design best practices

theme-factory

Applies consistent visual themes to slides, docs, and other artifacts

ui-ux-pro-max

Comprehensive UI/UX design system with component libraries, color palettes, typography scales, and stack-specific guidelines (React, Vue, Angular, Laravel, etc.)

web-artifacts-builder

Builds elaborate multi-component HTML artifacts for Claude.ai

webapp-testing

Tests local web applications using Playwright browser automation

xlsx

Handles any spreadsheet file as primary input or output

How Skills Are Loaded

Skills are selected per-assistant via the Skills meta box in the assistant editor. Whichever skills are checked, their combined instructions are prepended to the system prompt under an # Active Skills heading at inference time. This means skills are composable โ€” you can combine pdf + xlsx + doc-coauthoring on a single document-specialist assistant.

Skills are stored as plain text files and can be customised in-place. The original bundled content can be restored at any time from Settings โ†’ Advanced โ†’ Skill Management โ†’ Force Reinstall Bundled Skills.

Managing Skills

Base plugin โ€” Skill management is available under Settings โ†’ Advanced โ†’ Skill Management:

  • View installed skills and their metadata

  • Refresh the skill index

  • Install or force-reinstall the 16 bundled skills

Pro add-on โ€” The dedicated Skill Manager admin page (Assistants โ†’ Skill Manager) adds:

  • Upload a SKILL.md file or a ZIP archive containing a skill directory

  • Install a skill from a remote URL

  • Inline CodeMirror editor to create or edit SKILL.md content directly in the browser

  • Delete / uninstall skills

SKILL.md Format

---
name: my-skill
description: One-line description of what this skill does.
compatibility: claude-3-5-sonnet, claude-3-opus
---

# My Skill

Detailed instructions for the model go here in standard Markdown.
Use headings, lists, code blocks โ€” whatever best conveys the behaviour.

The name field (max 64 chars) becomes the skill's slug. The description field (max 1 024 chars) is shown in the admin UI. The compatibility field is optional and informational.

โžก๏ธ See Agent Skills reference for the complete specification, filters, and developer API.


๐Ÿ‘” Professional & Team Layers

NV oOS includes an enterprise-grade template system for rapid assistant deployment through Professions and Teams. Instead of manually configuring each assistant from scratch, administrators can:

  1. Select from ~311 pre-built professional templates spanning 12 industry categories

  2. Create custom profession templates with reusable configurations

  3. Deploy entire teams of specialized assistants with one click

  4. Test everything from the backend before exposing to end users

๐ŸŽ“ Professional Templates

Professions are reusable assistant templates with pre-configured:

  • Role descriptions and expertise areas

  • Default tools curated for each profession

  • Knowledge bases with industry-specific best practices

  • AI model defaults (provider, model, temperature)

  • Warnings and disclaimers for professional contexts

Available Categories (~311 professions across 12 categories):

Methodology note: the current sanity check counts 311 profession knowledge documents; runtime availability can vary with seeders, filters, and installed features.

  • ๐ŸŒพ Agriculture & Natural Resources

  • ๐ŸŽจ Art, Media & Entertainment

  • ๐Ÿ’ผ Business & Finance

  • ๐ŸŽ“ Education

  • ๐Ÿฅ Healthcare & Medicine

  • โš–๏ธ Law & Public Safety

  • ๐Ÿ”ฌ Science & Engineering

  • ๐Ÿฝ๏ธ Service Industry

  • ๐Ÿ’ป Technology

  • ๐Ÿ”ง Trades & Manual Labor

  • ๐Ÿšš Transportation

  • ๐Ÿ“‹ Miscellaneous

Example Professions:

  • Software Developer, Web Developer, Data Scientist

  • Accountant, Financial Advisor, Marketing Consultant

  • Registered Nurse, Physician, Pharmacist

  • Attorney, Paralegal, Mediator

  • Content Writer, Graphic Designer, Social Media Manager

  • And ~180 more, depending on active seeders and installed features...

Creating Assistants from Templates

Navigate to AI Assistants โ†’ Add New to browse the visual profession grid:

  1. Browse by category or search for a specific role

  2. Click "Create" on any profession to open a customization modal

  3. Customize the assistant name and AI settings (or use defaults)

  4. Deploy your configured assistant instantly

Each profession template includes:

  • Pre-written system prompts with role-specific expertise

  • Curated tool selections appropriate for the profession

  • Industry knowledge bases and best practices

  • Recommended model settings for optimal performance

๐Ÿ‘ฅ Team Deployments

Teams group multiple professionals for coordinated workflows. Deploy an entire team of specialists with one click:

Pre-Built Teams:

  • Engineering Team - Software, Mechanical, Electrical, Civil Engineers

  • Pharmaceutical Development Team - Pharmacist, Researcher, Clinical Pharmacologist, Regulatory Affairs

  • Research & Data Science Team - Data Scientist, Research Scientist, Statistician, Computer Scientist

  • Marketing & Growth Team - Marketing Consultant, Content Creator, Graphic Designer, Business Consultant

Team Features:

  • Centralized configuration - Set provider, model, and temperature for all team members

  • One-click deployment - Creates all team member assistants simultaneously

  • Consistent settings - Team defaults override individual profession defaults

  • Custom teams - Create your own teams with any combination of professions

Navigate to Teams โ†’ Add Team to deploy a pre-configured team or create custom team combinations.

๐Ÿงช Backend Testing

Test assistants, professions, and teams directly from the WordPress admin before deploying to end users:

Test Assistant (Admin โ†’ AI Assistants โ†’ Test Assistant)

  • Full feature parity with frontend chat interfaces

  • All tools enabled including sensitive/restricted tools (admin-only)

  • File upload support with complete MIME type configuration

  • Transcript saving for debugging and analysis

  • Tool shortcuts pre-loaded from assistant configuration

  • Streaming responses with real-time feedback

Test Profession (Admin โ†’ Professions โ†’ Test Profession)

  • Preview profession templates before creating assistants

  • Validate role descriptions and expertise areas

  • Test default tool selections in live conversations

  • Verify knowledge base content and accuracy

  • Assess AI model performance with profession-specific tasks

Test Team (Admin โ†’ Teams โ†’ Test Team)

  • Test entire teams before deployment

  • Validate team member coordination and role separation

  • Verify shared settings propagate correctly

  • Multi-assistant conversations to test team dynamics

  • Performance benchmarking across team members

Security Note: All test pages require manage_options capability and are restricted to WordPress administrators. Sensitive tools are enabled in test environments because administrators already have full site access.

Documentation:

Custom Professions & Teams

Administrators can create custom profession templates and teams:

Create Custom Profession:

  1. Navigate to Professions โ†’ Add New

  2. Set title, description, and category

  3. Define expertise areas and role description

  4. Select default tools from the registry

  5. Add knowledge base content

  6. Configure AI model defaults

  7. Publish for use in assistant creation

Create Custom Team:

  1. Navigate to Teams โ†’ Add New

  2. Set team name and description

  3. Select profession members from your library

  4. Configure team-wide defaults (provider, model, temperature)

  5. Publish to enable one-click team deployment

Benefits

For Organizations:

  • โœ… Rapid assistant deployment without manual configuration

  • โœ… Consistent configurations across similar roles

  • โœ… Template library grows with your organization

  • โœ… Share profession templates across sites

  • โœ… Professional-grade assistant quality out of the box

For Administrators:

  • โœ… Test everything safely from the backend

  • โœ… No coding required for template-based assistants

  • โœ… Visual template selection interface

  • โœ… Reusable configurations reduce errors

  • โœ… Full control over custom templates

For Developers:

  • โœ… JSON-based knowledge base system

  • โœ… Extensible via filters and hooks

  • โœ… WordPress standard CPT architecture

  • โœ… REST API access for profession and team data

  • โœ… Automated seeding from knowledge base files


๐Ÿ”‘ Assistant API credentials

Administrators can issue per-assistant access tokens from the API Credentials meta box that appears on every assistant edit screen. Tokens are only available to users with the manage_options capability, surface the credential history in a table, and expose one-click revoke and delete actions for rapid cleanup.ใ€F:includes/assistants/class-wp-mcp-ai-assistant-cpt.phpโ€ L483-L595ใ€‘ When you click Generate Credential the plugin produces a single-use token in the form cred_xxxxx.SECRET, hashes the secret server-side, and records the issuer so you have an audit trail of who created each credential.ใ€F:includes/class-wp-mcp-ai-credentials.phpโ€ L94-L135ใ€‘

Remote integrations can authenticate by sending that token in the standard Authorization: Bearer headerโ€”no Auth0 dependency required. The REST layer validates the credential, emits structured errors when a token is revoked or malformed, and scopes the request to the assistant that issued the token so clients cannot hop between assistants without an explicit credential for each one.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L316-L444ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L1282-L1321ใ€‘ใ€F:includes/class-wp-mcp-ai-credentials.phpโ€ L242-L297ใ€‘


๐Ÿณ Local Development with Docker

Spin up a disposable WordPress instance that mounts the plugin source directly into the container:

docker compose up -d
  • WordPress will be available at http://localhost:8000.

  • The plugin source in this repository is mounted to /var/www/html/wp-content/plugins/mcp-ai-wpoos inside the container, so edits on your machine are reflected immediately.

  • The MySQL service is provisioned with the wordpress database, user, and password (wordpress / wordpress).

Visit the site in your browser to complete the standard WordPress installation flow, using the database credentials above when prompted. When you're finished developing, stop the stack with docker compose down.

๐Ÿ” Codex environment startup script

If you are working inside an OpenAI Codex environment, add bin/codex-startup.sh to your workspace start-up tasks so a fresh WordPress install is provisioned automatically for every session โ€” no Docker required.

bin/codex-startup.sh

The script performs the following steps:

  • Downloads WP-CLI locally (if necessary) and uses it to fetch the latest WordPress core files into .codex-wordpress/wordpress.

  • Installs the SQLite Database Integration plugin so WordPress can run without a MySQL server.

  • Symlinks this repository into the new install's wp-content/plugins/mcp-ai-wpoos directory.

  • Installs Composer development dependencies (when available) and provisions the WordPress test suite so composer run test works immediately.

  • Runs wp core install, activates the NV oOS plugin, enables pretty permalinks, and sets a default site tagline.

  • Boots a development server on port 8000 via wp server and logs output to .codex-wordpress/wp-server.log.

Default credentials:

Setting

Value

Site URL

http://localhost:8000

Admin user

admin

Admin password

password

Admin email

admin@example.com

Override any of these values by exporting the environment variables WORDPRESS_URL, WORDPRESS_TITLE, WORDPRESS_ADMIN_USER, WORDPRESS_ADMIN_PASSWORD, WORDPRESS_ADMIN_EMAIL, or WORDPRESS_PORT before running the script.


๐Ÿง‘โ€๐Ÿ’ป Development Tooling

Install the PHP development dependencies (including PHP_CodeSniffer, the WordPress Coding Standards ruleset, and PHPUnit) with:

bin/setup-dev.sh

The script runs composer install and makes the following Composer scripts available:

Purpose

Command

WordPress coding standards lint

composer run lint

PHP compatibility checks (PHP 7.4โ€“8.3)

composer run lint:compat

Auto-fix coding standards violations

composer run format

Generate the translation template

composer run pot

Install the WordPress unit test scaffolding

composer run test:install

Execute the PHPUnit suite

composer run test

These commands automatically resolve the bundled vendor/bin tools (such as phpcs, phpcbf, and phpunit), so a global installation is no longer required.

NOTE

Thetest:install script prefers the Composer-provided wp-phpunit/wp-phpunit package for the WordPress test suite. Run composer install before invoking it, especially on networks where develop.svn.wordpress.org is inaccessible.

NPM Dependencies & Bundling

For details on how NPM dependencies are managed and bundled for both the base plugin and Pro addon, see DEPENDENCIES_BUNDLING.md.

Quick Reference:

  • Base plugin dependencies: @microsoft/fetch-event-source, dompurify, marked, ky, chart.js, @neplex/vectorizer, @langchain/*, @mlc-ai/web-llm

  • Build commands: npm run build:js, npm run install:chartjs, npm run install:vectorizer, npm run build:js:pro

  • Pro addon has separate addons/pro/package.json for Pro-specific dependencies


๐Ÿ“ฆ NPM Packages

Twenty-three standalone browser-utility packages have been extracted from the oOS chat UI and published to the NPM registry under the @nvdigitalsolutions scope. Each package is independently usable in any JavaScript/TypeScript project (no WordPress required).

Package

Description

Dependencies

nvoos-storage

Async JSON via Web Worker โ€” prevents main-thread blocking for large data

Zero

nvoos-markdown

XSS-safe markdown renderer with configurable allowed-tags profile

marked, dompurify

nvoos-events

SSE client with POST support + mitt-compatible job event bus

@microsoft/fetch-event-source

nvoos-http-client

HTTP client with automatic retry, exponential backoff, and request hooks

ky

nvoos-clipboard

copyTextToClipboard() with Clipboard API / execCommand fallback

Zero

nvoos-offline-sync

IndexedDB offline-first sync with automatic server sync on reconnect

Zero

nvoos-slash-commands

Slash command system with fuzzy-search autocomplete and execution engine

Zero

nvoos-audio

Browser audio I/O: TTS, STT, translation, voice chat with VAD

Zero

nvoos-dom-batcher

requestAnimationFrame DOM batcher, scroll batcher, and UI utilities for streaming UIs

Zero

nvoos-api

Typed REST API client โ€” endpoint builders, request helpers, and payload constructors

Zero

nvoos-attachments

File attachment helpers: type detection, validation, normalisation, segment builders

Zero

nvoos-chat-bubble

Floating chat bubble widget โ€” accessibility, sessionStorage, badge notifications, MutationObserver

Zero

nvoos-chat-memory

Promise-based REST client for AI chat memory bridge (wake-up, recall, store, audit, preferences)

Zero

nvoos-chat-memory-ui

Chat memory drawer UI โ€” side panel for viewing, editing, scoping, and exporting long-term AI memories

Zero

nvoos-client-tools

Browser-native AI tool registry (summarize, sentiment, translate, embed, image, audio) using Transformers.js

Zero

nvoos-cron-status

SSE-first cron/job status monitor with REST polling fallback

Zero

nvoos-llm-worker

Web Worker manager for non-blocking LLM operations

Zero

nvoos-model-loader

Progressive AI model loading UI with 4-stage progress tracking

Zero

nvoos-sse-client

TypeScript-native SSE connection manager with lifecycle tracking, per-connection status, automatic cleanup

Zero

nvoos-transcription

MediaRecorder-based audio recording + tool-call transcription pipeline for AI chat surfaces

Zero

nvoos-transformers-client

HuggingFace Transformers.js task wrapper (summarization, sentiment, NER, translation, QA, embeddings)

Zero

nvoos-types

Canonical TypeScript type definitions โ€” AI providers, chat messages, tool execution, SSE streaming, attachments, history, memory, agents, WordPress global augmentations

Zero

nvoos-vad

Browser Voice Activity Detection (VAD) using the Web Audio API

Zero

Installation

# Tier 1 โ€” Core utilities
npm install @nvdigitalsolutions/nvoos-storage
npm install @nvdigitalsolutions/nvoos-markdown marked dompurify
npm install @nvdigitalsolutions/nvoos-events @microsoft/fetch-event-source
npm install @nvdigitalsolutions/nvoos-types

# Tier 2 โ€” Extended browser utilities
npm install @nvdigitalsolutions/nvoos-http-client ky
npm install @nvdigitalsolutions/nvoos-clipboard
npm install @nvdigitalsolutions/nvoos-offline-sync
npm install @nvdigitalsolutions/nvoos-sse-client
npm install @nvdigitalsolutions/nvoos-api
npm install @nvdigitalsolutions/nvoos-attachments

# Tier 3 โ€” Chat UI utilities
npm install @nvdigitalsolutions/nvoos-slash-commands
npm install @nvdigitalsolutions/nvoos-audio
npm install @nvdigitalsolutions/nvoos-dom-batcher
npm install @nvdigitalsolutions/nvoos-chat-bubble
npm install @nvdigitalsolutions/nvoos-chat-memory
npm install @nvdigitalsolutions/nvoos-chat-memory-ui
npm install @nvdigitalsolutions/nvoos-cron-status
npm install @nvdigitalsolutions/nvoos-vad
npm install @nvdigitalsolutions/nvoos-transcription

# Tier 4 โ€” AI runtime utilities
npm install @nvdigitalsolutions/nvoos-client-tools
npm install @nvdigitalsolutions/nvoos-llm-worker
npm install @nvdigitalsolutions/nvoos-model-loader
npm install @nvdigitalsolutions/nvoos-transformers-client

Publishing

Two GitHub Actions workflows handle NPM publishing automatically:

Workflow

Trigger

Tag pattern

.github/workflows/npm-publish.yml

Push tag or workflow_dispatch

v*.*.*

.github/workflows/npm-publish-alpha.yml

Push tag or workflow_dispatch

v*.*.*-alpha.*

Setup โ€” only one secret is required: add an NPM_TOKEN to the repository at Settings โ†’ Secrets and variables โ†’ Actions.

Adding a new package: update the PACKAGES environment variable in both workflow files and place the package directory under packages/.

See packages/README.md for a full package listing and API overview, and packages/QUICK_START.md for usage examples.


๐Ÿงช Testing & QA

  • composer run test executes the PHPUnit suite bundled with wp-phpunit/wp-phpunit and Yoastโ€™s polyfills, covering REST, tooling, and helper contracts.ใ€F:composer.jsonโ€ L16-L23ใ€‘

  • Run composer run test:install once per environment to provision the WordPress test scaffolding before the first test pass.ใ€F:composer.jsonโ€ L16-L23ใ€‘

  • For offline or air-gapped environments, use ./bin/package-vendor-dev.sh to create a downloadable test framework package (~140 MB), then ./bin/install-vendor-dev.sh to deploy it without requiring composer or internet access.

Coding standards & static analysis

  • Enforce the WordPress Coding Standards with composer run lint; auto-fix what you can with composer run format.ใ€F:composer.jsonโ€ L16-L23ใ€‘

  • Validate cross-version compatibility (PHP 7.4โ€“8.3) via composer run lint:compat prior to release builds.ใ€F:composer.jsonโ€ L16-L23ใ€‘

Manual smoke tests

  • Follow the scenarios in ## โœ… Manual QA Scenarios after significant changes to chat flows, tool execution, or authentication wiring.

  • For logging-centric debugging, enable logging in the NV oOS settings and reference the retrieval commands in ๐Ÿชต Logging.


โš™๏ธ CI/CD Pipelines

The repository runs ~30 automated GitHub Actions workflows on every push and PR:

Workflow

Purpose

phpunit.yml

PHPUnit test suite (PHP 8.1, MySQL 8.0)

javascript-tests.yml

Jest-based JS test suite

php-linting.yml

PHPCS + PHP compatibility (7.4โ€“8.3)

security.yml

Dependency vulnerability scanning

security-regression.yml

Security regression tests

build-spa-addons.yml

Build all SPA addon ZIPs

build-canvas-addon.yml

Canvas addon ZIP build

build-comic-reader-addon.yml

Comic Reader addon ZIP build

build-nvoos-graphify*.yml

Graphify standalone plugin builds (3 workflows)

npm-publish.yml / npm-publish-alpha.yml

NPM package publishing (stable + alpha)

release.yml

GitHub Release automation

chat-parity-check.yml

Cross-provider chat parity testing

qa-e2e.yml

End-to-end QA tests

spa-a11y.yml

WCAG 2.1 AA accessibility checks

spa-bundle-size.yml

SPA bundle size monitoring

link-check.yml

Documentation link validation

cloud-worker-tests.yml

Cloud Worker integration tests

post-deploy-health.yml

Post-deployment health checks

sync-nvoos-*.yml

lib/ package sync to standalone repos (5 workflows)

stale.yml

Stale issue/PR management

auto-label.yml

Automated PR labeling

project-automation.yml

GitHub project board automation


๐Ÿ’ฌ Frontend Shortcode

Embed a published assistant anywhere on the site with the shortcode. Replace 123 with the post ID of the assistant you created under AI Assistants.

[mcp_ai_chat assistant="123"]

How it works

  • The shortcode renders a lightweight chat UI that talks to the plugin's REST API endpoints.

  • Scripts and styles are enqueued automatically and include REST nonces plus the selected assistant ID.

  • Responses are displayed inline, including tool invocation feedback when the model requests a registered tool.

Requirements

  • The assistant post must be published and, by default, the current user must have the edit_posts capability (matching the REST permission check). Add allow_guests="true" to the shortcode when you want anonymous visitors to participate in the chat.

  • An OpenAI API key and default model must be configured in Settings โ†’ NV oOS.

Tips

  • Omit the assistant attribute to fall back to the default assistant configured in the settings screen.

  • Multiple shortcodes can be added to the same page; each chat instance maintains its own conversation context on the client.

  • Use allow_guests="true" to expose the chat UI to logged-out visitors. Each render issues a short-lived guest token that authorises REST requests without a WordPress login.

  • REST interactions rely on the [wp_rest] nonce, so caching plugins should avoid caching pages for logged-in editors running the chat.

Elementor widget

  • Elementor sites automatically gain an NV oOS Chat widget that mirrors the shortcode controls, including the optional assistant selector and the guest access toggle.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ€ L17-L109ใ€‘

  • Leaving the assistant control blank falls back to the default assistant configured in the plugin settings, and enabling Allow Guests injects the same temporary tokens used by the shortcode flow.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ€ L45-L110ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L132-L224ใ€‘

  • The Elementor chat widget can surface everything saved on the assistant postโ€”model defaults, knowledge files, prompt shortcuts, and assigned toolsโ€”so you can build documentation and dashboards without copying values manually.ใ€F:includes/elementor/class-wp-mcp-ai-elementor-widget.phpโ€ L95-L845ใ€‘


๐Ÿงต REST Chat Payloads & Attachments

The /wp-json/mcp-ai/v1/chat endpoint accepts rich, multi-part messages. Each message object still requires a role, but the content may now be either a plain string or an array of structured segments that map to OpenAI's multimodal contract.

{
  "assistant_id": 123,
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Describe this photo" },
        { "type": "input_image", "attachment_id": 456, "detail": "high" }
      ]
    }
  ],
  "options": {
    "response_format": { "type": "json_schema", "json_schema": { "name": "caption" } }
  }
}

Supported segment types

  • text โ€“ Free-form text (text property). Strings supplied directly to content are automatically wrapped in this format. For backwards compatibility, existing input_text payloads sent to the REST API are still accepted and normalised to the new schema.

  • input_image โ€“ Reference an uploaded WordPress attachment (attachment_id) or provide a remote url. Optional detail hints (low, auto, high) and caption fields are preserved. (Fixed in v1.0.0: Chat client attachments now properly processed)

  • input_file โ€“ Reference an uploaded attachment that should be streamed to the model. (Fixed in v1.0.0: Chat client file attachments now properly processed)

The REST controller validates attachment ownership/permissions, enforces a default 5โ€ฏMB size cap (filterable via wp_mcp_ai_max_attachment_bytes), and only allows safe MIME types by default. Text and structured data formats include Markdown, CSV/TSV, HTML, JSON/JSONL/NDJSON, and XML; binary documents cover PDFs and Microsoft Word/PowerPoint/Excel variants; and audio/video uploads accept AAC/FLAC/M4A/MP3/OGG/OPUS/WAV/WEBM plus MP4 or QuickTime sources. ใ€F:includes/class-wp-mcp-ai-message-attachments.phpโ€ L642-L709ใ€‘

Whenever attachments are present, the plugin automatically inlines the asset data when sending requests to OpenAI's Responses API. Image segments are converted to data URLs and file segments include the base64-encoded payload alongside the original filename, so integrators do not need to upload assets manually before invoking a model.

REST requests that include attachments automatically gain access to the bundled Submit Document Prompt tool so the files reach OpenAI even when the assistant has the tool disabled in its configuration.ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L22-L29ใ€‘ใ€F:includes/class-wp-mcp-ai-rest.phpโ€ L963-L991ใ€‘

Assistant memory files configured on the post (memory_files) are also promoted to structured text segments on the system channel, retaining the existing chunking/truncation safeguards.

Need to relax or tighten the allowed file types? Administrators can override the image and file MIME lists directly in Settings โ†’ NV oOS โ†’ Attachments, and the same values are used by shortcode-driven chat surfaces (including the Elementor widget) when building upload restrictions.ใ€F:includes/admin/class-wp-mcp-ai-admin-settings.phpโ€ L225-L267ใ€‘ใ€F:includes/class-wp-mcp-ai-message-attachments.phpโ€ L456-L565ใ€‘ใ€F:includes/class-wp-mcp-ai-shortcode.phpโ€ L197-L218ใ€‘ When JSON Lines support is enabled in the allowlist the plugin also registers .jsonl and .ndjson extensions with WordPress so uploads succeed without additional filters.ใ€F:mcp-ai-wpoos.phpโ€ L236-L272ใ€‘

Assistants can also query existing knowledge files with the Search Attachments tool, which reuses WP_MCP_AI_Message_Attachments::user_can_access_attachment() so only publicly accessible or user-owned media is returned alongside download URLs and file metadata for the model to reuse.ใ€F:includes/tools/class-wp-mcp-ai-tool-search-attachments.phpโ€ L15-L207ใ€‘ใ€F:includes/class-wp-mcp-ai-message-attachments.phpโ€ L480-L575ใ€‘


๐Ÿ” JetEngine Capability Reference

When the plugin interacts with JetEngine objects it defers to the capabilities enforced by JetEngineโ€™s own REST handlers and editor interfaces. Use the following table to review the specific capability checks that gate each object type:

Object / Context

Capability string(s)

Notes

Custom Post Type editor & REST endpoints

manage_options

Editing built-in post types and all CPT REST endpoints require the user to have manage_options.

Custom Taxonomy editor & REST endpoints

manage_options

Built-in taxonomy edits and every taxonomy REST endpoint enforce the manage_options capability.

Relation management UI & REST endpoints

manage_options

Creating, editing, listing, or deleting relations through the admin REST handlers requires manage_options.

Relation REST access settings (rest_get_access, rest_post_access)

Stored capability string or 'public' (default manage_options)

The public REST controller checks a capability stored in relation args; if blank or 'public' the request is allowed, otherwise current_user_can( $cap ) is enforced. Newly created relations default rest_post_access to manage_options in the editor UI.

Relation object type โ€œPostsโ€

edit_post, delete_post

Editing or deleting related post items requires the corresponding post capability for the specific post ID.

Relation object type โ€œTaxonomy Termsโ€

edit_term, delete_term

Term relations check the matching term capabilities for the targeted term ID.

Relation object type โ€œMix โ†’ Usersโ€

edit_users (for edits); deletion disallowed

Editing user relations needs edit_users; deletions are explicitly forbidden (returns false). Other mix objects defer to filters for capability checks.

Relation object type โ€œCustom Content Types (CCT)โ€

Configured capability (defaults to manage_options)

Relation checks defer to the CCTโ€™s user_has_access(), which in turn checks current_user_can( $this->user_cap() ); the capability defaults to manage_options unless overridden in the CCT settings or filters.


๐Ÿ›ฐ JetEngine REST API Reference

  • ๐Ÿ“„ Review the full endpoint catalogue in docs/reference/api/jet-engine-rest-routes.md for route paths, callbacks, and required parameters.

  • ๐Ÿค– When JetEngine is active, assistants can invoke the List JetEngine REST Routes tool to retrieve the same metadata directly inside a conversation (requires a user with the manage_options capability).


๐Ÿชต Logging

  • Enable or disable logging from Settings โ†’ NV oOS โ†’ Enable Logging.

  • When logging is enabled the plugin records:

    • Chat requests and responses processed by the REST API.

    • Tool executions (including permission denials).

    • Errors returned from the OpenAI API and internal validation.

  • Log entries are written via PHP's error_log() and can be filtered with wp_mcp_ai_log_entry to route them elsewhere.ใ€F:includes/class-wp-mcp-ai-logger.phpโ€ L16-L137ใ€‘

  • Recent errors and activity snapshots are also persisted in the wp_mcp_ai_recent_errors (50 entries) and wp_mcp_ai_recent_activity (100 entries) options for dashboards and widgets, keeping autoload disabled to avoid bloating frontend requests.ใ€F:includes/class-wp-mcp-ai-logger.phpโ€ L611-L662ใ€‘

  • Retrieve those rolling buffers quickly with WP-CLI when debugging production incidents:

    wp option get wp_mcp_ai_recent_errors --format=json
    wp option get wp_mcp_ai_recent_activity --format=json

๐Ÿงพ JetEngine REST Endpoint Report Helper

Use the JetEngine report helper to surface the CRUD coverage matrix that was compiled during the REST endpoint audit. The helper exposes the underlying endpoint metadata as a structured array so you can reuse it in documentation, dashboards, or custom checks.

$report = wp_mcp_ai_get_jetengine_endpoint_report();

foreach ( $report['coverage'] as $resource => $operations ) {
    printf( "%s supports: %s\n", ucfirst( $resource ), implode( ', ', array_keys( array_filter( $operations ) ) ) );
}

if ( empty( $report['missing'] ) ) {
    echo "All CRUD operations are covered.";
}

The helper is filterable via:

  • wp_mcp_ai_jetengine_endpoint_routes โ€“ Adjust the source routes before the coverage matrix is derived.

  • wp_mcp_ai_jetengine_endpoint_coverage โ€“ Modify the generated CRUD coverage.

  • wp_mcp_ai_jetengine_missing_operations โ€“ Override the derived list of missing operations per resource.

Each filter receives the full data set so you can extend or replace the output when JetEngine adds new endpoints or when your project needs to surface additional metadata.


๐Ÿ”Œ Optional Tools & Dependencies

NV oOS works perfectly with vanilla WordPress - you don't need any third-party plugins for core functionality.

However, certain features require third-party plugins (sold separately). The plugin automatically detects which plugins are active and enables the corresponding tools:

Plugin Detection & Tool Loading

  • JetEngine (5 tools) โ€“ Server-side chat transcripts, JetEngine content access, JetFormBuilder integration

  • WooCommerce (3 tools) โ€“ E-commerce automation, product/order management

  • Elementor (1 tool + widgets) โ€“ Template management, pre-built chat widgets

  • Rank Math SEO (1 tool) โ€“ SEO analysis and schema data access

  • WPCode (1 tool) โ€“ Code snippet management and automation

๐Ÿ“– See the complete breakdown: ๐Ÿ”Œ What You Lose Without Third-Party Plugins

How It Works

  1. Each tool description in the admin UI shows which plugin it requires

  2. Tools are automatically hidden when their dependency is missing

  3. Administrators see informational notices explaining unavailable tools

  4. No errors occur - the plugin gracefully handles missing dependencies


โœ… Manual QA Scenarios

The project currently relies on manual verification. Run these checks after updating the plugin:

  1. Baseline (no optional plugins)

    • Deactivate WooCommerce and JetEngine.

    • Load the AI Assistant edit screen and confirm only core tools appear. No PHP notices or fatal errors should occur.

    • Visit the WordPress dashboard to confirm the informational notices explain why optional tools are disabled.

  2. WooCommerce enabled

    • Activate WooCommerce.

    • Reload the Assistant editor and ensure the WooCommerce Orders and Products tools appear and can be selected.

    • Trigger each tool (e.g., via an assistant conversation) and confirm recent orders and product summaries return without errors.

  3. JetEngine enabled

    • Activate JetEngine.

    • Confirm the JetEngine Items tool appears for assistants and returns data for a configured JetEngine post type.

  4. Tool call retry resilience

    • Initiate a chat conversation that triggers a tool call (for example, request an operation that requires either WooCommerce tool).

    • After the tool output appears, send a follow-up message that prompts the assistant to continue without invoking another tool.

    • Confirm the follow-up succeeds without a JavaScript console error referencing a missing tool_call_id.

Document the results of each scenario when preparing releases to ensure optional integrations remain stable.


๐Ÿงฉ Hooks & Filters

Use the following hooks to extend the plugin:

Hook

Type

Description

do_action( 'wp_mcp_ai_before_chat_request', $assistant_id, $messages, $options, $request )

Action

Fires before a chat request is sent to OpenAI.

do_action( 'wp_mcp_ai_after_chat_response', $assistant_id, $response, $request )

Action

Fires after a chat response is received.

apply_filters( 'wp_mcp_ai_chat_options', $options, $assistant_config, $request )

Filter

Modify the OpenAI request options before dispatch.

apply_filters( 'wp_mcp_ai_chat_capability', $capability, $assistant_id, $context )

Filter

Adjust the capability required to use the chat shortcode and REST endpoints (defaults to edit_posts). Return 'public' or an empty value to allow any visitor.

do_action( 'wp_mcp_ai_before_tool_execution', $tool_slug, $arguments, $context )

Action

Runs immediately before a tool executes.

apply_filters( 'wp_mcp_ai_tool_output', $result, $tool_slug, $arguments, $context )

Filter

Inspect or transform tool output before it is returned.

do_action( 'wp_mcp_ai_after_tool_execution', $tool_slug, $arguments, $context, $result )

Action

Runs after a tool completes execution.

apply_filters( 'wp_mcp_ai_log_entry', $entry, $type, $message, $context )

Filter

Intercept or redirect logging output.

apply_filters( 'wp_mcp_ai_onboarding_presets', $presets )

Filter

Add, remove, or modify onboarding wizard use-case presets. Each preset defines tools, system prompt, temperature, and assistant name.

do_action( 'wp_mcp_ai_onboarding_presets_seeded', $created, $preset_keys )

Action

Fires after the onboarding wizard creates assistant CPT posts from selected presets. $created maps preset keys to post IDs.


๐Ÿงฐ WP-CLI Commands

Manage the NV oOS environment from the command line when WP-CLI is available.

Command

Description

wp mcp-ai status

Summarises WordPress core details, PHP version, and NV oOS supported plugin coverage.

wp mcp-ai remote <base>

Probes a remote MCP REST namespace (such as https://example.com/wp-json/mcp-ai/v1) by loading the assistant directory and issuing a lightweight POST /chat probe, reporting connectivity, assistant counts, and token scope metadata.

wp mcp-ai plugins list

Lists optional dependencies (WooCommerce, JetEngine, etc.) with install and activation state.

wp mcp-ai plugins activate <slug>

Activates a supported plugin; pass --network on multisite installations.

wp mcp-ai plugins deactivate <slug>

Deactivates a supported plugin; pass --network on multisite installations.

wp mcp-ai chat <message>

Sends a one-shot chat message to an assistant via the language model router. Accepts --assistant, --model, --provider, --temperature, --max-tokens, --stream, and --format flags.

wp mcp-ai memory recall

Recalls agent memory entries. Use --assistant to scope operations.

wp mcp-ai thread list

Lists chat threads. Use --assistant to filter. Also supports get and delete subcommands with --thread-id.

wp mcp-ai provider list

Lists all 15 AI providers with enabled/disabled status. Also supports test <slug> and models <slug> subcommands.

wp mcp-ai cron list

Lists scheduled cron jobs tracked by NV oOS. Also supports run <job-id> and delete <job-id> subcommands.

wp mcp-ai transcript list

Lists transcripts eligible for mining. Use --assistant to filter. Also supports mine subcommand for batch mining.

wp mcp-ai approval list

Lists pending human-in-the-loop approval items. Accepts --format flag. Also supports approve and reject subcommands with --item-id.

wp mcp-ai tool list

Lists all registered tools with status, capability, and toolkit metadata. Accepts --status, --format, --toolkit, and --search flags. Also supports enable <slug> and disable <slug>.

wp mcp-ai assistant list

Lists all published AI assistants. Accepts --status and --format flags.

wp mcp-ai credential list

Lists API credentials configured for an assistant.

wp mcp-ai slash-command list

Lists registered slash commands.

wp mcp-ai settings get

Retrieves all NV oOS settings.

wp mcp-ai cache clear

Clears the NV oOS object cache.

wp mcp-ai remote accepts additional flags so you can mirror the authentication mode used by your deployment while exercising TLS and timeout controls:

  • --token=<token> โ€“ Include an Auth0 access token or assistant-issued credential via the Authorization header.

  • --guest-token=<token> โ€“ Attach a guest token when testing public chat surfaces that rely on the X-WP-MCP-AI-Guest header.

  • --nonce=<nonce> โ€“ Supply a WordPress REST nonce for same-origin checks.

  • --assistant-id=<id> โ€“ Hint which assistant to load when the directory endpoint supports scoped tokens.

  • --timeout=<seconds> โ€“ Override the default 15-second timeout when probing slow networks.

  • --verify-ssl=<boolean> โ€“ Toggle certificate validation (defaults to true).

  • --user-agent=<agent> โ€“ Send a custom user agent instead of the built-in WP-MCP-AI-Remote-Tester/<version> signature.

Filter wp_mcp_ai_supported_plugins to expose additional managed dependencies to the CLI helpers.

Each hook receives sanitized data and respects the current user's permissions and multisite membership.


๐Ÿ†˜ Getting Help & Support

Documentation Resources

Start with the comprehensive documentation before seeking additional support:

  1. Quick Reference Guide - Fast answers to common questions and tasks

  2. Documentation Index - Navigate all 1,600+ documentation files

  3. Troubleshooting Guide - Solutions to common issues

  4. REST API Reference - Complete API documentation

Before Reporting Issues

When encountering problems, please:

Common Issues

npm EACCES Permission Error (package-lock.json)

If you get EACCES: permission denied, open '.../package-lock.json' when running npm install:

This means you do NOT need to run npm install.

The plugin distributes pre-built minified assets (.min.js/.min.css files) so npm install is never required for production use. You only need npm if you are a developer modifying JavaScript source files.

Solutions:

  • If installing from ZIP: Simply upload and activate the plugin. No npm commands needed.

  • If cloning the repository for production use: Activate the plugin as-is. The pre-built assets in the repository are ready for production.

  • If you need to rebuild assets (development only): Run npm on a development machine where you have write access, then deploy the built files.

If you must run npm in a restricted directory (e.g., during CI or scripted deployments), use:

npm install --no-package-lock

npm/Composer Install Error After Cloning

If you get ENOENT: no such file or directory, uv_cwd (npm) or getcwd() failed (composer) errors:

For Cloudways Users (Most Common):

These errors occur when you try to run npm or composer from a directory that has been moved, deleted, or no longer exists. This commonly happens when you clone outside the WordPress plugins directory and then move/copy files while your shell session is still in the original location.

Solution: Always clone directly into the plugins directory:

# SSH into your Cloudways server
cd /home/master/applications/YOURAPP/public_html/wp-content/plugins/

# Clone directly (replace YOURAPP with your application name)
git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
cd mcp-ai-wpoos

# Verify you're in the right place
pwd  # Should show the full plugins path

# NOTE: npm install is NOT required for production use.
# Activate the plugin in WordPress admin - it is ready to use.
# Only run composer if you need to update PHP dependencies (development only):
# composer install --no-dev

For Local Development or VPS:

  1. Ensure you're in the correct directory - Run pwd to verify you're in the mcp-ai-wpoos directory

  2. Do not run commands from a moved/deleted directory - If you moved files, open a new terminal session in the new location

  3. Production workflow (no npm or composer needed):

    # Clone the repository
    git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
    
    # Copy to WordPress plugins directory
    cp -r mcp-ai-wpoos /path/to/wordpress/wp-content/plugins/
    # Plugin is ready to activate - no build step required.
  4. Development workflow (only if you need to rebuild JS/CSS assets):

    # Clone the repository on your development machine (not the server)
    git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
    cd mcp-ai-wpoos
    
    # Install dev dependencies and rebuild assets
    npm install && npm run build
    composer install --no-dev
    
    # Deploy built files to the server
  5. Alternative: Clone directly into WordPress - This avoids copy/move issues:

    cd /path/to/wordpress/wp-content/plugins/
    git clone https://github.com/nvdigitalsolutions/mcp-ai-wpoos.git
    # Activate the plugin - it is production-ready without any npm or composer commands.

Chat Not Working

  1. Verify OpenAI API key is configured in Settings โ†’ NV oOS

  2. Ensure assistant is published

  3. Check user has edit_posts capability or add allow_guests="true" to shortcode

  4. Enable logging and check browser console for errors

Tool Execution Failures

  1. Verify tool is enabled for the assistant

  2. Check required dependencies are installed (WooCommerce, JetEngine, etc.)

  3. Ensure user has necessary capabilities

  4. Review tool-specific requirements in tool reference

Remote Client Connection Issues

  1. Verify credentials are correct and not expired

  2. Test with remote client quickstart guide

  3. Use WP-CLI command: wp mcp-ai remote <url> --token=<token>

  4. Review authentication documentation

Reporting Issues

When creating a GitHub issue, please include:

  • Plugin version (found in WordPress admin)

  • WordPress version and PHP version

  • Error messages from logs (enable logging in settings)

  • Steps to reproduce the issue

  • Expected behavior vs actual behavior

  • Screenshots if applicable

Create issues at: https://github.com/nvdigitalsolutions/mcp-ai-wpoos/issues

Contributing

We welcome contributions! Please see:

Documentation

Comprehensive documentation is available:

For Historical Reference:

Security Vulnerabilities

For security issues, please review our Security Policy and report vulnerabilities responsibly.

Do not create public GitHub issues for security vulnerabilities.

Community & Updates


๐Ÿ“„ License

NV oOS ships under a three-tier license model:

Component

License

Base plugin (root + includes/)

GPL-3.0-or-later

addons/algorave/

AGPL-3.0-or-later (bundles @strudel/web AGPL-3.0)

addons/pro/, addons/graphify/, addons/embedded/, addons/cornerstone3d/, addons/canvas/, addons/cloud-worker/, addons/fantasy-football/

Proprietary โ€” ยฉ NV Digital Solutions, all rights reserved

The base plugin's GPL-3 grant is in LICENSE. Bundled third-party dependencies retain their upstream licenses; see CREDITS.md for the full attribution index.


Thank you for using Open Operator System!

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    A self-contained MCP server plugin that connects WordPress to AI, providing 58 abilities for managing posts, pages, media, users, plugins, menus, comments, and more through any MCP-compatible AI client.
    161
    GPL 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Turns any WordPress site into an MCP server, allowing AI clients to directly control files, database, WP-CLI, PHP, content, and more through declarative abilities without writing code.
    1
    GPL 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    A free WordPress plugin that turns your site into a governed MCP server, exposing 153 curated WordPress abilities (posts, media, users, WooCommerce, ACF, SEO) as tools for AI agents like Claude and Cursor. Every ability is off by default, scoped to a least-privilege user, capability-gated, and logged.
    3
    GPL 2.0