Enum Object 

pub enum Object {
    Path {
        canonical: String,
        asked: String,
    },
    Command {
        argv: Vec<String>,
        argv_sha256: String,
        cwd: String,
        executable: String,
        network: bool,
    },
    Tool {
        name: String,
        digest: String,
    },
    Agent {
        agent: String,
        call: String,
        argvs: Vec<Vec<String>>,
        paths: Vec<String>,
        input: String,
    },
}

What a person’s decision covers: exactly one resolved object — never the request’s spelling and never a pattern (constitution V). A path is the canonical file a write reaches; a command is its exact argv with the directory it runs in and the executable it resolves to; an MCP tool is its name with the digest of its definition.

Variants

Path

write_file / edit_file of this file.

Fields

canonical: String

Workspace-relative, every existing ancestor’s symlinks resolved.

asked: String

The path as the model sent it (normalised).

Command

run_command with exactly this argv.

Fields

argv: Vec<String>

The argv.

argv_sha256: String

Hex SHA-256 over the argv as a JSON array.

cwd: String

The working directory, workspace-relative (. for the root).

executable: String

The executable’s absolute canonical path, or not found.

network: bool

Whether the call has the network.

Tool

This MCP tool, as its server defines it now.

Fields

name: String

mcp__<server>__<tool>.

digest: String

agentplane’s digest over the tool’s definition.

Agent

An external agent’s own action, in its own process: exactly these commands and paths — never covered by a grant of speccoder’s own calls, nor covering one.

Fields

agent: String

The agent (its preset id).

call: String

execute, edit, read, … as the agent declared it.

argvs: Vec<Vec<String>>

The commands it runs, exactly.

paths: Vec<String>

The worktree paths it names, canonical.

input: String

A digest of what else it carries, when that decides (a call speccoder cannot read); empty otherwise.

Implementations

impl Object

pub fn command( argv: Vec<String>, cwd: String, executable: String, network: bool, ) -> Self

A command object; the argv’s hash is computed.

pub const fn class(&self) -> Class

Its class.

pub fn describe(&self) -> String

One line for people.

pub fn grant_id(&self) -> String

Its grant id: g-<16 hex> over what the object is — the canonical path, every field of a command, a tool’s name and digest — so one id names one object and nothing else.

pub fn short(&self) -> String

The short form events and lists carry: the path, argv#<12 hex>, <tool>@<12 hex> — never more of the argv than the target shows.

pub fn same_name(&self, other: &Self) -> bool

Whether other names the same thing as this one by the request’s spelling (the path as asked, the argv, the tool’s name) — the case in which a different object is worth telling the person about.

pub fn changed_from(&self, earlier: &Self) -> Option<String>

What differs from earlier, an object of the same name a person approved: executable /usr/bin/make → /w/bin/make.

pub fn tool_name(&self) -> Option<&str>

The MCP tool’s name, for a tool object.

pub fn path(&self) -> Option<&str>

The canonical path, for a path object.

Trait Implementations

impl Clone for Object

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Object

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Object

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Object

impl PartialEq for Object

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

A path is the file it reaches (any spelling); a command and a tool are every field.

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

Inequality operator !=.

impl Serialize for Object

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

where __S: Serializer,

Serialize this value into the given Serde serializer.