Expand description
oino-tools: the built-in tools — read, write, edit, bash, grep, find,
ls and (Windows) powershell — with fixed names, schemas, descriptions, prompt text,
error strings, truncation footers and details shapes.
Tools implement oino_agent::AgentTool; oino-core builds them from a ToolConfig
(cwd, agent dir, ExecutionEnv, live ToolContext, image and shell options) and uses
BuiltinToolInfo for the system prompt. Temp files go to <agent>/tmp/oino-bash-*.log;
the shell environment is D12.
§API map
Re-exports§
pub use bash::BashDetachRegistry;pub use bash::BashOutcome;pub use bash::DetachedProcess;pub use bash::ShellRunOptions;pub use bash::ShellTool;pub use bash::run_shell_command;pub use config::ImageOptions;pub use config::ModelImageInfo;pub use config::NoContext;pub use config::SessionEnv;pub use config::ShellOptions;pub use config::ToolConfig;pub use config::ToolContext;pub use edit::EditTool;pub use env::ExecutionEnv;pub use env::FsError;pub use env::LocalEnv;pub use env::SpawnedProcess;pub use find::FindTool;pub use grep::GrepTool;pub use info::BuiltinToolInfo;pub use info::BuiltinToolName;pub use info::DEFAULT_ACTIVE_TOOLS;pub use info::READ_ONLY_TOOLS;pub use info::builtin_tool_info;pub use ls::LsTool;pub use mutation_queue::FileMutationQueue;pub use read::ReadTool;pub use registry::builtin_tool_infos;pub use registry::builtin_tools;pub use registry::coding_tools;pub use registry::create_tool;pub use registry::read_only_tools;pub use registry::tool_by_name;pub use write::WriteTool;
Modules§
- bash
- Shell tools and reusable shell execution (
tools/bash.ts,tools/powershell.ts,tools/output-accumulator.ts,core/bash-executor.ts,utils/shell.ts). - config
- Tool configuration and the per-call context core supplies (the
ToolsOptions+ExtensionContextfields the built-ins read). - edit
edit.- env
- Execution environment: the file system and process boundary every tool goes through.
- find
find.- grep
grep.- image
- Image handling for
read(image-process,image-resize-core,image-convert.ts,mime.ts,exif-orientation.ts). - info
- Static metadata of the built-in tools (names, descriptions, schemas, prompt text).
- ls
ls.- mutation_
queue - Per-file serialisation of mutations.
- path_
utils - Path resolution of tool arguments.
- read
read.- registry
- Construction of the built-in tools (
tools/index.ts:createTool,createAllTools,createCodingTools,createReadOnlyTools). - truncate
- Output truncation shared by the tools.
- write
write.
Constants§
- OPERATION_
ABORTED - The abort error text.