Package dev.shamoo.runtime.core

package dev.shamoo.runtime.core

Class	Description
CloseNotifyingResource	Resource that can notify an ownership registry after it closes naturally.
CompiledBindingMetadata	Generated binding identity required before a platform operation can be invoked.
CrossPluginEventBus	Version-filtering event bus whose subscriptions follow plugin generation ownership.
CrossPluginServiceRegistry	Core-owned service directory with generation-aware providers and stable consumer proxies.
DependencyBlock	Stable reason that prevents a plugin from loading.
DependencyResolution	Immutable dependency graph and deterministic lifecycle ordering.
DependentReloadPolicy	Consumer behavior when a service provider generation is transactionally replaced.
DirectRuntimeHost	A synchronous host suitable for command-line tools and deterministic tests.
HotStatePluginRuntime	Optional engine-neutral contract for transferring opaque state between runtime generations.
IllegalLifecycleTransitionError	Raised when a caller requests a transition outside the central transition table.
IncompatibleManifestException	Indicates that a valid manifest cannot run in the current runtime environment.
InstalledPluginCandidate	Immutable discovered plugin installation; it does not imply activation.
InvocationAdmission	Atomic invocation admission and drain accounting for one plugin.
InvocationAdmission.Lease	Idempotent active-invocation lease.
InvocationController	Runtime-facing invocation admission boundary.
InvocationRejectedError	Raised when a plugin is no longer admitting invocations.
InvocationSnapshot	Immutable invocation admission counters.
LifecycleError	Structured base error emitted by lifecycle coordination.
LifecycleMetricsSnapshot	Measured lifecycle coordination counters.
LifecycleTimeoutError	Structured timeout from a lifecycle hook or invocation drain.
LifecycleTransition	Immutable audit entry for an atomic lifecycle state transition.
ManifestValidator	Runtime-core admission boundary for parsing and compatibility validation.
OptionalProxyTransport	Optional correlated request transport over an allowlisted raw plugin-message sender.
OptionalProxyTransport.Response	Explicit distinction between an absent carrier/proxy, a canonical response frame, and a local transport error.
OptionalProxyTransport.Sender
PlatformCapabilities	Immutable allowlist of narrow platform operations; platform service objects are never exposed.
PlatformCapabilities.Operation
PlatformOperationResult<T>	A platform operation result with an optional generation-owned resource.
PluginDependencyError	Structured lifecycle rejection caused by dependency state or compatibility.
PluginDependencyGraph	Resolves semantic dependencies and ordering hints with stable lexical tie-breaking.
PluginDirectoryWatcher	Recursively observes plugin directories and emits one candidate path after a quiet window.
PluginDisableError	Structured disable hook failure.
PluginDiscovery	Secure, deterministic discovery of directory-based plugin installations.
PluginDiscoveryError	Structured rejection produced while inventorying the runtime plugins directory.
PluginDiscoveryResult	Complete discovery outcome; one bad installation does not hide valid siblings.
PluginDrainError	Structured drain hook or active-invocation wait failure.
PluginEnableError	Structured enable hook failure.
PluginEventHandler	Engine-neutral subscriber for a compatible versioned event payload.
PluginEvents	Generation-scoped cross-plugin versioned event surface.
PluginId	Validated stable identity of a script plugin.
PluginIntrospectionSnapshot	One immutable administrative view assembled under coordinator serialization.
PluginLifecycleCoordinator	Serializes plugin lifecycle operations and enforces dependency, drain, timeout, and cleanup rules.
PluginLifecycleError	Structured hook failure with a phase-specific code.
PluginLifecycleMachine	Thread-safe state machine backed by the single authoritative transition table.
PluginLifecycleState	Stable administrative states for one installed plugin candidate.
PluginLoadError	Structured load hook failure.
PluginQuarantinedError	Structured rejection of operations on a quarantined plugin.
PluginReadyError	Structured ready hook failure.
PluginRuntime	Engine-neutral lifecycle hooks for one plugin runtime.
PluginRuntimeContext	Core-owned services supplied to a runtime implementation.
PluginRuntimeFactory	Composition-root interface used to create an engine runtime for an admitted candidate.
PluginServiceHandler	Engine-neutral implementation of one explicitly versioned plugin service.
PluginServiceProxy	Stable consumer handle that resolves its provider generation for every invocation.
PluginServices	Generation-scoped cross-plugin service registration and lookup surface.
PluginStager	Prepares an installation candidate without replacing the currently installed candidate.
PluginUnloadError	Structured unload hook failure.
QuarantinePolicy	Explicit policy for moving repeated failures or resource leaks into quarantine.
RegistrationRefCounter<K>	Thread-safe first/last registration ownership for shared native resources.
ResourceCategory	Categories exposed in plugin resource ownership reports.
ResourceCleanupError	Structured unload failure caused by plugin-owned resources.
ResourceCleanupReport	Result of a reverse-order resource cleanup pass.
ResourceRegistration	Immutable view of a live plugin-owned resource.
ResourceRegistry	Thread-safe typed ownership registry that closes resources in reverse registration order.
RuntimeHost	Platform services available to a runtime without exposing server-specific types.
RuntimeInitializationException	Indicates that a runtime could not acquire its engine resources.
RuntimeMetricsSnapshot	Truly measured per-runtime counters.
RuntimePermissions	Canonical immutable runtime permissions derived from a manifest Node policy.
RuntimeState	Observable lifecycle state of a per-plugin runtime.
ScriptCallback	Opaque allowlisted JS callback; platform adapters may pass only copied data values.
ScriptRuntime	A lifecycle-bound script engine.
ServiceInvocationException	Correlated data-boundary failure for one cross-runtime service operation.
ServiceUnavailableException	Raised by a stable service proxy when no active compatible provider can admit the call.
SourceMapRegistry	Deterministic registry of exact generated-to-original source positions.
SourcePosition	One-based source location.