Skip to main content

The Plugins System

Plugin runtime contracts and extension surfaces

The Plugins System

Plugins are the execution substrate of Ratio1 workloads. Deeploy deployments, ChainDist jobs, and direct workload paths all resolve to plugin runtime behavior on edge nodes.

Where plugins fit in the stack

  1. Orchestration defines deployment intent and policy.
  2. Pipelines bind execution context to target nodes.
  3. Plugin signatures select capability families.
  4. Plugin instances execute configuration and emit payloads, notifications, and heartbeats.

Runtime extension surfaces

In the current edge runtime, plugin capabilities are organized through extension surfaces such as:

  • extensions/business/ for business plugins that expose endpoints/APIs, orchestrate operational behavior, and combine symbolic or heuristic logic with neural-model outputs (for example deeploy, container_apps, chain_dist, cstore, dauth, oracle_sync, jeeves).
  • extensions/data/ for Data Capture Thread plugins (listener/capture ingestion paths).
  • extensions/serving/ for Serving Process plugins (they run as processes, not threads).
  • extensions/utils/

Exact module sets can evolve between releases; treat this as a current orientation map (reviewed February 18, 2026), not a fixed compatibility contract.

naeural_core provides backbone modules and runtime contracts, while edge_node operationalizes and extends those capabilities for network runtime behavior.

Why this matters for production

This architecture allows multiple product experiences to share one execution substrate:

  • managed deployments through Deeploy;
  • distributed compute patterns through ChainDist;
  • app runners (CAR/WAR) over consistent runtime contracts;
  • evolving data/auth/service modules without replacing the full platform runtime.

SDK relation

SDKs configure and interact with pluginized workloads, but plugins are runtime-level architecture first. In production framing, SDK entities are interfaces to the system, not the system itself.

Ground truth references

Primary:

Supporting:

Notable date

  • Reviewed on February 18, 2026.

Next steps