Struct BasicToolService 

pub struct BasicToolService { /* private fields */ }

The default tool service for embedded worlds. See the module docs for what it does and does not provide.

Implementations

impl BasicToolService

pub fn new(hub: InteractionHub) -> Self

A service whose interaction tools ask through hub.

pub fn tool_defs(workdir: &Path) -> Vec<Tool>

The tool definitions this service can execute for an agent working in workdir - the set stage resolution filters available_tools against.

pub fn register(&self, entity: Entity, agent_id: &str, workdir: PathBuf)

Register entity’s tool state: built-ins confined to workdir, and interactions attributed to agent_id. The embed spawner calls this for every agent it creates; a host spawning agents directly on the world does the same.

pub fn unregister(&self, entity: Entity)

Drop entity’s tool state. Called by the reaper when a terminal agent is unloaded, so the map stays bounded by the set of live agents.

Trait Implementations

impl ToolService for BasicToolService

fn exec_for( &self, entity: Entity, calls: Vec<ToolCall>, progress: ToolProgress, ) -> BoxedToolExec

Build the closure that runs calls for entity, resolving (id, result) pairs. The executor calls progress with each call’s result as it resolves (per-call, not at batch end).

fn sync_stage(&self, entity: Entity, _stage_index: usize, stage_name: &str)

Notify the service that entity entered the stage at stage_index named stage_name, so it can re-sync that agent’s per-stage tool permissions. Default no-op for services without per-stage policy.

fn refresh_tools( &self, _entity: Entity, _stage_index: usize, ) -> Option<Vec<Tool>>

Re-resolve entity’s advertised tool defs for the stage at stage_index - e.g. after new tools were discovered on disk. None means “no change” (the default, for services without dynamic tools); Some(tools) replaces the stage’s advertised set.

fn wants_refresh(&self, _entity: Entity) -> bool

Whether entity (a dynamic_tools agent) has pending tool changes that warrant a re-scan + re-advertise. Polled by poll_dynamic_tool_refresh; implementors return (and clear) a per-agent dirty flag. Default false.