Enum ObsKind 

pub enum ObsKind {
    Read,
    Grep,
    Find,
    Write,
    Skill,
    Tool,
    Mcp,
    Child,
    Message,
    Error,
}

What an observation was, so assembly can reason about it.

The serde rendering (read, grep, find, write, skill, tool, mcp, child, message, error — snake_case, as Act and Effect already are) is a wire format: it is what a persisted ledger’s kind column holds, so each of those ten strings is a stored value that a later release may not rename. It is deliberately not ObsKind::label, which renders different words for a different reader — see the note there.

Variants

Read

A file read into context.

Grep

A content search.

Find

A filename search.

Write

A file written.

Skill

A skill body loaded.

Tool

A tool the embedding program registered.

Mcp

A tool an MCP server offered.

Child

A sub-agent’s composed result.

Message

The model said something instead of calling a tool.

Error

A tool failed, or the policy refused it.

Implementations

impl ObsKind

pub fn target_is_the_subject(self) -> bool

Whether a later observation of the same target replaces this one.

True where the target is the subject of the answer: a path, a search pattern, a glob, a skill’s name. False where the target is only the name of the thing that answered — a registered or MCP tool called twice with different arguments gave two different answers, and stubbing the first as “superseded” would throw one of them away.

pub fn label(self) -> &'static str

The word a stub uses for this kind — the same word the observation’s own header uses, so a stub reads as the thing it replaced.

Not the serialized form, and must not be unified with it. These are English for the model and the operator reading a prompt (Write is “wrote”, Mcp is “mcp tool”); the serde rendering on the type above is a stored value. Making either one match the other changes the prompt text or orphans every persisted ledger, and neither failure announces itself.

Trait Implementations

impl Clone for ObsKind

fn clone(&self) -> ObsKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ObsKind

impl Debug for ObsKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObsKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ObsKind

impl PartialEq for ObsKind

fn eq(&self, other: &ObsKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ObsKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ObsKind