AI agent

Agent tool calls

Read the runtime tool names, how availability is decided, and the inputs, outputs, errors, and changed files shown in the Agent timeline.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Availability is decided per turn

Each turn assembles its tool list from the active pane, the selected provider and model, the attached context, the kits installed in Kition, and any connected MCP servers. Hosted web search and hosted image generation are offered only when the selected model supports them; the local-folder tools only while a local folder is attached; kit tools only for installed kits.

A tool name listed here does not guarantee that the current turn can call it. Use the timeline to see what was actually called.

Tool names in the runtime

  • Documents — document_list, document_search, document_read, document_write
  • Workspace files — file_search, fs_read, fs_stat, fs_list, fs_mkdir, fs_remove, fs_copy, apply_patch, view_image
  • Kit files — <kit>_inspect, <kit>_commands, <kit>_run, <kit>_check, <kit>_export, <kit>_create, plus <kit>_query and <kit>_batch for kits with an object model and <kit>_draft_ready and <kit>_draft_reopen for kits with drafts; for example slide_inspect, sheet_run, or doc_check
  • Local folders — source_list, source_read, source_search, source_file_search, source_git_status, source_git_log, source_git_show, source_git_blame
  • Web — web_search (hosted by the model provider), web_fetch, web_article_save
  • Images and saved results — image_generation (hosted by the model provider), image_search, save_image_asset, artifact_write, register_artifact
  • Shell — exec_command
  • Plans — update_plan
  • Workflow email — configure_smtp_connection
  • MCP — tools from connected MCP servers are named server__tool

Kit tools

Kit tools work on files opened by a kit. Inspect reports a file’s contents and can attach a rendered preview; Commands searches the kit’s editing commands; Run applies up to 50 commands in order as one undoable edit and rolls the whole run back if a step fails; Check lists problems such as broken references, overflowing text, or formula errors; Export writes a new file in a format the kit exports; Create makes a new, empty file.

A file open in a kit editor is edited live in that editor; otherwise the kit edits the file directly. In Draft mode the edits go to a draft that only you can merge or discard.

What the timeline shows

  • Running, completed, and failed tool status
  • Tool input and output when available
  • Friendly labels for known tools, MCP server: tool for MCP tools, and raw names for others
  • Saved results and Files modified for paths changed in the chat
  • Reconnect progress for supported transient network and provider failures
  • Model steps and replies when desktop debug mode is enabled

Tool-loop controls that exist

You can stop the active turn. A shell command outside the execution policy pauses for Allow once, an optional Always allow for a suggested prefix, or Deny. A turn stops by itself after a fixed number of model steps and asks you to narrow the task.

The timeline does not offer Retry tool, Edit arguments, Skip tool, or tool-concurrency controls. Correct a failed step with a new message or stop and start a new turn.

Treat output as evidence, not proof

A completed tool card means the runtime reported completion. Verify durable changes in the document, filesystem, or external system before treating the task as done.

Stopping a turn does not undo a file write, external request, or command that already finished.

Implementation sources

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.