Docs / Plugins & Unified Bridges

Plugins & Unified Bridges

Implementation of the plugins/bridges platform pack for _AugmentedIntelligence.

What shipped

Piece	Files	Status
Plugin host wiring	`PluginManager.*`, `BuiltinPlugins.cpp`	`Init` at boot; `TryHandle` early in `SpeechCommands`
Expanded HostApi	enqueue, bridge status/send, toast, catalog run, device, sandbox FS	Wired in `WireDefaultHostServices`
Builtin plugins	`greet`, `bridgekit`, `notify`, `mathkit`	`PLUGIN_REGISTER`
Unified envelope	`BridgeProtocol.hpp`	JSON-lines v1, fixture-safe parser
Bridge manager	`BridgeManager.*`	list/status/metrics/dry-run/replay/hello/start/stop
Fixture replay	`bridge replay …`	Uses `tests/fixtures/**`
Lua	`_PluginManager::RegisterLuaGlobals` from AgentRuntime	On agent VM create
Tests	`suite_bridge_protocol.cpp`	In `run_math_tests.ps1`

Commands

plugins list|status|info <name>|enable|disable|reload|doctor|help <verb>
plugins load <dll>
plugins selftest

greet [name]
notify <title> [detail...]
bridgekit status|hello [id]|replay <id> <path>
mathkit run <model> [t1] | device

bridge list|status|metrics|info <id>
bridge dry-run <id> on|off
bridge replay <id> <fixture_path>
bridge hello [id] | ping [id]
bridge start <minecraft|se|creo|blender|c4d|source_mod|...|all>
bridge stop <id|all>
bridge tail <gamemod_id> [n]
bridge send <id> {json}          # dry-run by default

Fixture examples

bridge replay minecraft tests/fixtures/minecraft/status_response.json
bridge replay se tests/fixtures/space_engineers/status_response.json
bridge replay creo tests/fixtures/creo/context.json
bridge start creo
bridge start blender
bridge start c4d
bridge dry-run minecraft on

Creo CAD adapter (creo): profiles live/batch/configurator/file/toolkit — CreoIntegration.md.

Blender + Cinema 4D DCC adapters (blender, c4d / plugins blenderkit, c4dkit) — BlenderCinema4DIntegration.md.

HostApi (plugins)

auto& h = _PluginManager::Host();
h.EnqueueCommand("de catalog list");
h.BridgeStatus("minecraft");
h.BridgeSend("minecraft", json);   // respects dry-run
h.Toast("title", "detail", "info");
h.CatalogRun("decay", 1.0);
h.DeviceStatus();
h.SandboxRead("note.txt");         // under plugins/data/
h.SandboxWrite("note.txt", body);
h.EthicsAllows("actuate.write");

Safety

All generic bridge send paths default dry-run.
Plugin dispatch blocked in kill-switch safe mode + rate limited.
Dynamic DLL load: plugins load path\to\plugin.dll export ai_plugin_entry.

Enabling ExamplePlugin.dll

plugins load ExamplePlugin.dll
plugins list
plugins selftest

Deferred

Full live multi-client action routing through BridgeManager (still uses native MC/SE/GameMod handlers for start/stop).
Signed plugin policy file.
Out-of-process untrusted plugin worker.
Discord approval bot / browser CDP (brainstorm only).

Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.