Sovereignty enum

Defines the Commitment Authority and Escalation Protocol assigned to a Deputy.

Within the framework's Capability-Based Access Control (CBAC) model, these tiers govern the Reactive Update Cycle. They define whether a Logic Transformation (resulting from an agent's internal reasoning) can be committed to the state graph automatically or if it must remain a Staged Mutation pending administrative approval or Reciprocal Handshake validation.

When to use

Choose the sovereignty level based on how much autonomy the deputy needs:

  • supervised for proposals that require approval.
  • collaborative for mixed autonomy.
  • sovereign for full independence.
  • preemptive for emergency overrides.

How it works

Sovereignty determines if a pulse is queued for approval or executed immediately. High‑impact actions may be blocked even if the deputy is sovereign, depending on cell rules.

Non‑obvious

  • supervised pulses are held in a pending state until approval.
  • preemptive can cancel other pulses.
  • This is evolvable – a deputy can be promoted or demoted.

See also: Mandate.sovereignty.

Inheritance
Available extensions

Values

supervised → const Sovereignty

Level 0: Supervised. The Deputy acts as a "Proposal Engine." Every generated Pulse is intercepted and requires explicit approval (manual or automated) by the Principal before committing to the state layer.

This level is used for High-Risk Reasoning or training phases where the Causal Provenance must be verified by a higher authority.

collaborative → const Sovereignty

Level 1: Collaborative. The Deputy can mutate non-critical state independently but must pause and request authorization for high-impact transitions or operations that cross significant Clearance boundaries.

This implements a "Human-in-the-loop" or "Orchestrator-in-the-loop" safety pattern.

sovereign → const Sovereignty

Level 2: Sovereign. The Deputy is fully authorized to commit changes within its Clearance and Mandate.authority without real-time oversight.

This represents a Sovereign Resident agent operating autonomously under the constraints of System Law (enforced via TestCell).

preemptive → const Sovereignty

Level 3: Preemptive. Reserved for safety, homeostasis, or emergency recovery agents. A preemptive Deputy can override or cancel other active pulses to maintain system stability.

These agents operate at the highest tier of the Scene-Driven Ontology, prioritizing system integrity over standard business logic.

Properties

hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
isPreemptive → bool
Returns true if the deputy has high-authority override capabilities to maintain system homeostasis.
no setter
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
requiresApproval → bool
Returns true if the deputy requires external validation or approval before its actions can affect the reactive graph.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Constants

values → const List<Sovereignty>
A constant List of the values in this enum, in order of their declaration.