tools

const (
	ContentBlockText  ContentBlockType = "text"
	ContentBlockImage ContentBlockType = "image"
)

const (
	// READ_FILE — read a file by absolute path. Handles text, PDFs (with pages),
	// Jupyter notebooks, images. First-line defense for "what's in this file."
	READ_FILE ToolName = "read"

	// WRITE_FILE — create a new file or fully overwrite one. Use only when Edit
	// doesn't fit.
	WRITE_FILE ToolName = "write"

	// EDIT_FILE — exact string replacement in a file. Requires prior Read.
	// Preferred over Write for modifying existing files.
	EDIT_FILE ToolName = "edit"

	// BASH — run shell commands. Catch-all for git, build/test runs, find/grep/rg,
	// any CLI. Supports background execution.
	BASH ToolName = "bash"

	// AGENT — spawn a subagent (Explore, Plan, general-purpose, code-review, etc.)
	// for parallel/independent work or to protect main context from big result dumps.
	AGENT ToolName = "agent"

	// TOOL_SEARCH — load schemas for deferred tools by name (select:Foo,Bar) or
	// keyword search. Required before calling anything deferred.
	TOOL_SEARCH ToolName = "tool_search"

	// SKILL — invoke a user-installed skill by name (e.g. commit, code-review,
	// make-prd, pgagent). Same as the user typing /skill-name.
	SKILL ToolName = "skill"

	// SCHEDULE_WAKEUP — self-pace iterations in /loop dynamic mode.
	// Not relevant outside loops.
	SCHEDULE_WAKEUP ToolName = "schedule_wakeup"

	// TODO_WRITE — write the session's todo list (full-list replacement).
	// Used proactively at the start of any non-trivial task; subsequent calls
	// flip statuses and add/remove entries. One in_progress entry at a time.
	TODO_WRITE ToolName = "todo_write"

	// UPDATE_USER_PROFILE — merge sections into <APP_HOME>/USER_PROFILE.md.
	// Persistent across sessions; auto-memory feature. Section keys are fixed:
	// "Preferences", "Working style", "Recurring topics".
	UPDATE_USER_PROFILE ToolName = "update_user_profile"

	// UPDATE_PROJECT_MEMORY — merge sections into
	// <APP_HOME>/projects/<slug>/MEMORY.md keyed by slugified workdir path.
	// Section keys are fixed: "Project facts", "Decisions", "Open issues",
	// "References".
	UPDATE_PROJECT_MEMORY ToolName = "update_project_memory"
)

const (
	MONITOR ToolName = "monitor"

	// DAEMON_LIST — enumerate every registered daemon with status + metadata.
	// Optional kind filter and include_terminal flag.
	DAEMON_LIST ToolName = "daemon_list"
	// DAEMON_OUTPUT — fetch the captured output of one daemon. Format is
	// kind-specific: bash stdout/stderr tail, monitor event ring, agent
	// prompt/summary. Optional tail limits to the last N lines.
	DAEMON_OUTPUT ToolName = "daemon_output"
	// DAEMON_STOP — terminate a running daemon by id. Works uniformly
	// across bash background tasks, monitors, and async subagents.
	// Idempotent for daemons that have already reached a terminal status.
	DAEMON_STOP ToolName = "daemon_stop"

	ENTER_PLAN_MODE ToolName = "enter_plan_mode"
	EXIT_PLAN_MODE  ToolName = "exit_plan_mode"
	ENTER_WORKTREE  ToolName = "enter_worktree"
	EXIT_WORKTREE   ToolName = "exit_worktree"

	NOTEBOOK_EDIT ToolName = "notebook_edit"

	// LSP (Language Server Protocol) — semantic code intelligence.
	// Deferred: the LLM discovers it via tool_search when it needs
	// definition, references, hover, or document symbols.
	LSP_REQUEST ToolName = "lsp_request"
)

const (
	ASK_USER_QUESTION ToolName = "ask_user_question"
	PUSH_NOTIFICATION ToolName = "push_notification"
)

const (
	CRON_CREATE    ToolName = "cron_create"
	CRON_LIST      ToolName = "cron_list"
	CRON_DELETE    ToolName = "cron_delete"
	REMOTE_TRIGGER ToolName = "remote_trigger"
)

const (
	WEB_FETCH  ToolName = "web_fetch"
	WEB_SEARCH ToolName = "web_search"
)

const (
	// this is for explore agent (read only)
	GREP ToolName = "grep"
	TREE ToolName = "tree"
	GLOB ToolName = "glob"

	// Others — deferred.
	JSON_QUERY ToolName = "json_query"
	CALC       ToolName = "calc"

	// this is for dev phase
	FEEDBACK ToolName = "feedback"
)