Tool

---

Object Hierarchy:

Description:

Content:

Properties:

• public Object? arguments { get; set; }
  Parsed "arguments" object, or null if absent. Set by parse().
• public Document? document { get; set; }
  Executor output document. Set by ResultParser.exec_extract() on success.
• public string id { get; set; }
  Execution run id (e.g. "tool-0", "ref-1", "exec"). Empty for refinement-only.
• public string issues { get; set; }
  Validation or parse error messages; appended by parse() and validate().
• public string name { get; set; }
  Tool name from parsed JSON (e.g. "write_file").
• public unowned Details parent { get; set; }
  The task (Details) this tool belongs to.
• public ArrayList<Format> references { get; set; }
  References for this run (one or more). Used by reference_contents() to build executor input.
• public string summary { get; set; }
  Result summary from executor (Result summary section). Set by ResultParser.exec_extract().
• public ToolCall? tool_call { get; set; }
  ToolCall built from name and arguments; set by parse(), used in run() when this run has a tool.
• public string tool_run_result { get; set; }
  Tool execution result from this run. Set in run() when this run has a tool_call.

Creation methods:

• public Tool (Factory factory, SessionBase session, Details parent, string run_id = "")
  Creates a tool for refinement (run_id == "") or an execution run (run_id set).

Methods:

• public bool parse (Block block)
  Parses a fenced block: expects JSON with "name" and optional "arguments". Sets this.name, this.arguments, and this.tool_call (uid is assigned by caller via assign_id). Appends to this.issues on parse failures.
• public async void run () throws Error
  Run the tool (if any), build reference content + tool output, combine for executor input, send executor prompt, parse into summary and document. Up to 5 attempts; on failure appends to parent.issues and throws.
• public string to_instructions ()
  Returns instructions for the refine stage: tool name, description, and parameters. Uses this.name to look up the tool from the manager. Call after constructing the Tool with name set.
• public bool validate ()
  Validates that tool_call is set, the tool is registered on the manager, and required arguments are present. Appends to this.issues for refine feedback.

Inherited Members: