Struct Governor 

pub struct Governor { /* private fields */ }

Who decides for one attempt, and what they decided.

Implementations

impl Governor

pub fn new(s: Setup) -> Self

The governor for one attempt.

pub fn root(&self) -> &Path

The worktree.

pub fn log(&self) -> Vec<Value>

The decisions and calls so far.

pub fn pending(&self) -> Option<Value>

The call waiting for a person nobody could ask, if one is.

pub fn stopped(&self) -> bool

Whether the attempt is ending.

pub fn asked(&self) -> u32

Prompts a person was shown.

pub fn asking(&self) -> Duration

How long a person has spent deciding so far: the attempt’s clock stands while they do.

pub fn said(&self, text: &str)

The agent’s words since its last call.

pub fn reported(&self, call: &ToolRequest)

The agent reported a call it makes: recorded beside the decisions, as the agent’s own (decision: "reported") — its claim, never evidence. Masked, its long values cut; one that changed something without a decision of speccoder’s is counted (Governor::unasked).

pub fn unasked(&self) -> u32

Calls the agent reported changing something (an edit, a command) that never reached speccoder as a request: its own settings let it decide them.

pub fn stop(&self)

Ends the attempt: nothing more is allowed.

pub fn permission( &self, call: &ToolRequest, options: &[PermissionOption], ) -> Option<String>

Answers a permission request: the agent’s allow-once option when allowed (a plain read, or a person’s yes), its reject option when not, None (cancelled) when the attempt ends here.

pub fn abandon(&self, call: &ToolRequest)

A decision that could not be made (it failed): refused, and the request closed.

pub fn decide( &self, tool: &str, args: &Value, call: Option<&ToolRequest>, ) -> Verdict

Decides one speccoder tool call as a native attempt would.

pub async fn read_text_file( &self, path: &Path, line: Option<u32>, limit: Option<u32>, ) -> Result<String, String>

fs/read_text_file: a file in the worktree, read through the workspace tools (credentials refused, copied secrets masked).

Errors

Why it is refused or cannot be read.

pub async fn write_text_file( &self, path: &Path, content: &str, ) -> Result<(), String>

fs/write_text_file: a file in the worktree, written through the workspace tools (protected paths refused, frozen tests a person’s).

Errors

Why it is refused or cannot be written.

pub fn command( &self, argv: Vec<String>, cwd: Option<&Path>, ) -> Result<Command, String>

terminal/create: whether the command may run, and how — its argv, directory and scrubbed environment.

Errors

Why it is refused.

Trait Implementations

impl Debug for Governor

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

Formats the value using the given formatter.