Namespace DotBoxD.Plugins
Namespaces
Section titled “Namespaces”Classes
Section titled “Classes”Public carrier for a generated hook or subscription kernel package supplied by the source generator to a
fluent terminal such as Run, RunLocal, Register, or RegisterLocal.
One index-eligible predicate from a lowered .Where(…) chain: a comparison between an event
property (DotBoxD.Plugins.IndexedPredicate.Path) and a compile-time constant (DotBoxD.Plugins.IndexedPredicate.Value). Hosts match
DotBoxD.Plugins.IndexedPredicate.Path against their own indexed fields and dispatch through equality/range buckets.
Encodes server extension IR values as a small binary payload: one value-kind byte followed by only the active scalar or child sequence. The IPC layer transports the resulting bytes as an ordinary binary argument, avoiding reflection-bound DTO maps and repeated string kind tags on the wire.
Converts between the compact server extension wire IR and the sandbox values consumed by installed verified IR. The expected sandbox type is supplied by the server-side installed function signature.
In-process server-extension convenience surface: register a batch kernel under a service contract, then obtain a typed proxy that invokes it request/response. Plugin-facing remote facades usually expose the same capability from the domain surface they extend.
Server-side owner of the kernels installed over one connection. Each kernel it installs is tagged with this session as its owner, so another session cannot replace or mutate it. Disposing the session — e.g. from a transport disconnect handler — revokes and unregisters every kernel it owns.
The host’s wiring seam for DotBoxD.Plugins.PluginServer.WireHook(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions) / DotBoxD.Plugins.PluginServer.WireSubscription(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions).
Everything mechanical (terminal selection, by-name event resolution, the trusted recompute) is owned by the
router; this carries only the genuinely host-specific bits: the remote-local callbacks, the world-owned
event index, and an optional classification override.
Structs
Section titled “Structs”A compact intermediate representation for plugin-defined server extension arguments and results. Scalars carry only their active field, and lists/records carry positional child values matching the verified kernel IR type.
The trusted terminal classification for an DotBoxD.Plugins.Kernel.InstalledKernel: which pipeline terminal to wire
and the arguments it needs. Recomputed from verified IR / install-owned metadata — never trusted from the
raw manifest — so a single audited DotBoxD.Plugins.KernelWireTerminal.Classify(DotBoxD.Plugins.Kernel.InstalledKernel,System.Type) replaces the hand-written routing every host used
to copy.
The remote-callback delegates a projecting terminal needs: DotBoxD.Plugins.WireCallbacks.LocalPush for a remote
RunLocal chain and DotBoxD.Plugins.WireCallbacks.LocalResult for a remote RegisterLocal chain. Either may be
null for a connection that uses no remote-local terminal; the router only requires the one a kernel’s
classified terminal actually uses.
The resolved event adapter and terminal used when an installed kernel is wired through
DotBoxD.Plugins.PluginServer.WireHook(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions) or DotBoxD.Plugins.PluginServer.WireSubscription(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions).
Interfaces
Section titled “Interfaces”IServerExtensionClientRegistry
Adds service-contract lookup for generated domain-style server extension client extensions.
Client-side transport used by generated server extension proxies. The payload is DotBoxD’s compact
server extension value IR encoded by DotBoxD.Plugins.KernelRpcBinaryCodec, so transports can carry it as an
ordinary binary IPC argument without knowing the plugin-owned service contract.
The comparison an DotBoxD.Plugins.IndexedPredicate applies, normalized so the event property is always the
left operand (e.Damage >= 5 and 5 <= e.Damage both lower to
DotBoxD.Plugins.IndexPredicateOperator.GreaterThanOrEqual).
The compact, transport-neutral value kinds used for server extension IPC payloads.
How an installed kernel’s verified terminal must be wired into a hook or subscription pipeline. This is the
single classification the host-side router (DotBoxD.Plugins.PluginServer.WireHook(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions) /
DotBoxD.Plugins.PluginServer.WireSubscription(DotBoxD.Plugins.Kernel.InstalledKernel,DotBoxD.Plugins.WireOptions)) computes once from install-owned + verified metadata, replacing
the per-host boolean lattice (is-local-terminal / is-result / is-result-local-terminal) every host used to
hand-roll.