Struct CoreState 

pub struct CoreState { /* private fields */ }

The central state machine for an Extro extension.

Owns all domain state and provides deterministic command dispatch. JavaScript never mutates this directly — it sends CoreCommands and receives CoreResults.

Example

use extro_core::*;

let mut state = CoreState::new();
let command = CoreCommand {
    surface: RuntimeSurface::Popup,
    action: CoreAction::SyncState,
    snapshot: BrowserSnapshot {
        url: "https://example.com".into(),
        title: "Example".into(),
        selected_text: None,
        context: serde_json::Value::Null,
    },
};
let result = state.dispatch(command);
assert_eq!(result.message, "State synchronized");

Implementations

impl CoreState

pub fn new() -> Self

Create a new core state with zeroed counters and empty logs.

pub fn dispatch(&mut self, command: CoreCommand) -> CoreResult

Dispatch a command and return the result with any side effects.

This is the main entry point for all extension logic. Each command increments the session counter and appends to the internal log.

pub fn telemetry(&self) -> Vec<String>

Return the telemetry log as a vector of strings.

Each entry is a formatted record of a dispatched command.

pub fn history(&self) -> Vec<String>

Return the full command history for agent introspection.

Agents can use this to review what commands have been processed and in what order, enabling replay and debugging.

pub fn session_count(&self) -> u64

Return the current session counter value.

Trait Implementations

impl Debug for CoreState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CoreState

fn default() -> CoreState

Returns the “default value” for a type.