Struct PolicyKernel 

pub struct PolicyKernel { /* private fields */ }

Persistent routing policy store.

Wraps a PolicyKernelState with load/save operations tied to a file path. Changes are saved eagerly on every mutation.

Implementations

impl PolicyKernel

pub fn agent_path(agent_id: &str) -> Option<PathBuf>

Resolve the default policy kernel path for a given agent.

Returns ~/.clawft/agents/<agent_id>/policy_kernel.json.

pub fn global_path() -> Option<PathBuf>

Resolve the default global policy kernel path.

Returns ~/.clawft/memory/policy_kernel.json.

pub fn load(path: &Path) -> Result<Self, PolicyKernelError>

Load the policy kernel from disk, or create a new empty one.

If the file does not exist, returns an empty kernel that will create the file on the first save.

pub fn save(&self) -> Result<(), PolicyKernelError>

Save the current state to disk.

pub fn add_policy( &mut self, id: String, pattern: String, embedding: Vec<f32>, tier: u8, ) -> Result<(), PolicyKernelError>

Add a routing policy and persist to disk.

pub fn record_cost( &mut self, model: &str, tokens: u64, cost: f32, latency_ms: u64, ) -> Result<(), PolicyKernelError>

Record a cost observation and persist to disk.

pub fn policies(&self) -> &[PolicyEntry]

Return the policy entries (read-only).

pub fn cost_records(&self) -> &[PersistedCostRecord]

Return the cost records (read-only).

pub fn policy_count(&self) -> usize

Return the number of policy entries.

pub fn state(&self) -> &PolicyKernelState

Return the full state (for export).

pub fn set_state( &mut self, state: PolicyKernelState, ) -> Result<(), PolicyKernelError>

Replace the full state (for import). Saves immediately.

pub fn path(&self) -> &Path

Return the file path of this kernel.

pub fn clear(&mut self) -> Result<(), PolicyKernelError>

Clear all policies and cost records. Saves immediately.