MagmaCore/com.magmaguy.magmacore.ai

Package-level declarations

Version-independent contracts for native Mind programs, bodies and host integration.

Mind behaviors control native movement through exclusive leases. The ACTION lease permits a behavior to submit a bounded com.magmaguy.magmacore.ai.MindActionRequest to the host's synchronous com.magmaguy.magmacore.ai.MindActionSink. MagmaCore validates and dispatches requests but does not interpret, persist or queue them.

Types

MindActionContext

public final class MindActionContext extends Record

Current logical and physical context supplied to a host action sink.

MindActionRequest

public final class MindActionRequest extends Record

Immutable, version-independent request for a host-owned semantic action.

MindActionRequester

@FunctionalInterface()

public interface MindActionRequester

Guarded action-request channel available to the active Mind callback.

MindActionResult

public enum MindActionResult

Immediate disposition returned by a host for one semantic Mind action request.

@FunctionalInterface()

public interface MindActionSink

Host adapter for semantic actions requested by Mind behaviors.

public interface MindActuator

Version-independent control seam implemented by the active native body.

public interface MindBehavior

MindBodyCapabilities

public final class MindBodyCapabilities extends Record

Physical body features provided by the active native adapter.

MindBodyLocomotion

public enum MindBodyLocomotion

Native movement model installed on a MagmaCore Mind body.

MindBodyProfile

public final class MindBodyProfile extends Record

Version-independent physical and locomotion request for a native Mind body.

MindBodyRehydration

public final class MindBodyRehydration extends Record

Data recovered from a vanilla carrier before its logical mind session is reopened.

public final class MindContext extends Record

public enum MindControl

Exclusive channels that a running mind behavior may control.

MindExecutionPolicy

public final class MindExecutionPolicy extends Record

Soft per-tick scheduling budgets used to defer later Mind work under load.

public final class MindFailure extends Record

MindFailureListener

@FunctionalInterface()

public interface MindFailureListener

public interface MindHandle implements AutoCloseable

public interface MindHost

Version-independent seam for one logical mind session.

public final class MindMemoryKey<T>

MindMemoryStore

public final class MindMemoryStore

public interface MindMemoryView

MindNavigationProgress

public final class MindNavigationProgress extends Record

Last observed native body movement while a destination was active.

MindNavigationStatus

public final class MindNavigationStatus extends Record

Immutable navigation diagnostics sampled at the current native Mind tick.

public interface MindPerception

Read-only native perception available to sensors and behaviors.

MindPersistentState

public final class MindPersistentState extends Record

Versioned, plugin-owned memory payload.

public final class MindPosition extends Record

public final class MindProgram

MindProgramFactory

@FunctionalInterface()

public interface MindProgramFactory

Catalog-safe definition that creates one executable program per entity binding.

MindRunawayException

public final class MindRunawayException extends RuntimeException

Signals that a hard script runaway limit interrupted a Mind callback before completion.

MindRunawayPolicy

public final class MindRunawayPolicy extends Record

Hard interruption limits for one script callback.

public final class MindSchema

public interface MindSensor

public final class MindSnapshot extends Record

public enum MindStopReason

public interface MindValueCodec<T>

Converts plugin-owned mind memory to persistence-safe scalar values.

public interface MobBody

Native body owned by MagmaCore and driven by its version-specific AI engine.

public enum StateTransfer

Memory migration policy used when a running mind program is replaced.

public final class SwapReceipt extends Record