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>_queryand<kit>_batchfor kits with an object model and<kit>_draft_readyand<kit>_draft_reopenfor kits with drafts; for exampleslide_inspect,sheet_run, ordoc_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: toolfor 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
- kition@7d49036f: crates/kition-agent/src/tools/mod.rs
- kition@7d49036f: crates/kition-agent/src/catalog.json
- kition@7d49036f: crates/kition-kits/src/tools.rs
- kition@7d49036f: crates/kition-agent/src/providers/core.rs
- kition@7d49036f: crates/kition-agent/src/mcp.rs
- kition@7d49036f: src/features/agent/lib/agentTimelineI18n.ts
- kition@7d49036f: src/features/agent/components/AgentConversation.tsx
Related pages
Agent chat basics
Open a workspace-scoped chat, attach only the context you need, choose a model, and review the streamed work and the files it changed.
Agent approvals and safety boundaries
Use the shell-command approval card and kit drafts without assuming Kition has a universal per-tool permission editor.
Web research for the Agent
Let the Agent search the web through the model provider, fetch public pages, and save articles into the workspace.