Tool

---

Object Hierarchy:

Description:

Content:

Properties:

• public Object? arguments { get; set; }
  Parsed "arguments" object, or null if absent. Set by parse().
• public ListModel children { get; }
  Placeholder empty list — tools are leaves; avoids null checks on ProgressItem.children.
• public Document? document { get; set; }
  Executor output document. Set by ResultParser.exec_extract() on success.
• public Format? exam_reference { get; set; }
  Primary document or code the executor must focus on.
• public string id { get; set; }
  Execution run id (e.g. "tool-0", "ref-1", "exec"). Empty for refinement-only.
• public ulong idx_notify_id { get; set; }
• public string issues { get; set; }
  Validation or parse error messages; appended by parse() and validate().
• public Message? message { get; set; }
• public string msg_idx_txt { owned get; }
• 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; }
  Shared reference links for this exec run.
• public PhaseEnum status { get; set; }
• public string status_str { owned get; }
• public Block? summary { get; set; }
  Result summary heading block from executor (Result summary section). Set by ResultParser.exec_extract(). Never store as text — always the Block.
• public string title { owned get; }
• 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 RequestBase? tool_request { get; set; }
• public string tool_run_result { get; set; }
  Tool execution result from this run. Set in run() when this run has a tool_call.
• public string tooltip_text { owned get; }
• public ArrayList<WriteChange> writes { get; set; }
  Write operations parsed from the write executor output.

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:

• protected override async void fill_model ()
  Set chat_call.model from this task's skill definition when the skill header has an optional model and it is available; otherwise use default.
• 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 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: