export const EXEC_TOOL_DISPLAY_SUMMARY = "Run shell commands that start now.";

export const PROCESS_TOOL_DISPLAY_SUMMARY = "Inspect and control running exec sessions.";

export const CRON_TOOL_DISPLAY_SUMMARY = "Schedule cron jobs, reminders, and wake events.";

export const SESSIONS_LIST_TOOL_DISPLAY_SUMMARY =

"List visible sessions with mailbox filters and optional previews.";

export const SESSIONS_HISTORY_TOOL_DISPLAY_SUMMARY =

"Read sanitized message history for a visible session.";

export const SESSIONS_SEND_TOOL_DISPLAY_SUMMARY =

"Send a message to another visible session or configured agent.";

export const SESSIONS_SPAWN_TOOL_DISPLAY_SUMMARY = "Spawn sub-agent or ACP sessions.";

export const SESSIONS_SPAWN_SUBAGENT_TOOL_DISPLAY_SUMMARY = "Spawn sub-agent sessions.";

export const SESSION_STATUS_TOOL_DISPLAY_SUMMARY = "Show session status, usage, and model state.";

export const UPDATE_PLAN_TOOL_DISPLAY_SUMMARY = "Track a short structured work plan.";

export const EXEC_TOOL_DISPLAY_SUMMARY = "Run shell now.";

export const PROCESS_TOOL_DISPLAY_SUMMARY = "Inspect/control exec sessions.";

export const CRON_TOOL_DISPLAY_SUMMARY = "Schedule reminders, cron, wake events.";

export const SESSIONS_LIST_TOOL_DISPLAY_SUMMARY = "List visible sessions; filters/previews.";

export const SESSIONS_HISTORY_TOOL_DISPLAY_SUMMARY = "Read sanitized session history.";

export const SESSIONS_SEND_TOOL_DISPLAY_SUMMARY = "Message session or configured agent.";

export const SESSIONS_SPAWN_TOOL_DISPLAY_SUMMARY = "Spawn subagent or ACP session.";

export const SESSIONS_SPAWN_SUBAGENT_TOOL_DISPLAY_SUMMARY = "Spawn subagent session.";

export const SESSION_STATUS_TOOL_DISPLAY_SUMMARY = "Show session status/model/usage.";

export const UPDATE_PLAN_TOOL_DISPLAY_SUMMARY = "Track short work plan.";

export function describeSessionsListTool(): string {

return [

"List visible sessions with optional filters for kind, label, agentId, search, recent activity, derived titles, and last-message previews.",

"Use this to discover a target session before calling sessions_history or sessions_send.",

"List visible sessions; filter by kind, label, agentId, search, activity.",

"Use before sessions_history or sessions_send target selection.",

].join(" ");

}

export function describeSessionsHistoryTool(): string {

return [

"Fetch sanitized message history for a visible session.",

"Supports limits and optional tool messages; use this to inspect another session before replying, debugging, or resuming work.",

"Fetch sanitized history for visible session.",

"Use before replying, debugging, resuming; supports limits/tool messages.",

].join(" ");

}

export function describeSessionsSendTool(): string {

return [

"Send a message into another visible session by sessionKey or label, or to a configured agent by agentId.",

"Thread-scoped chat sessions are rejected; target the parent channel session for inter-agent coordination.",

"Missing configured agent main sessions are created before send; waits for the target run and returns the updated assistant reply when available.",

"Send message to visible session by sessionKey/label, or configured agent by agentId.",

"Thread-scoped chats rejected; target parent channel session.",

"Creates missing configured-agent main session; waits for reply when available.",

].join(" ");

}

export function describeSessionsSpawnTool(options?: {

acpAvailable?: boolean;

threadAvailable?: boolean;

}): string {

const runtimeDescription =

options?.acpAvailable === false

? 'Spawn clean child session; default `runtime="subagent"`.'

: 'Spawn clean child session; default `runtime="subagent"`; set `runtime="acp"` explicitly for ACP.';

const baseDescription = [

'Spawn a clean isolated session by default with `runtime="subagent"` or `runtime="acp"`.',

runtimeDescription,

options?.threadAvailable

? '`mode="run"` is one-shot and `mode="session"` is persistent and thread-bound.'

: '`mode="run"` is one-shot background work.',

"Subagents inherit the parent workspace directory automatically.",

"Native subagents receive the delegated task in their first visible `[Subagent Task]` message.",

'For native subagents only, set `context="fork"` when the child needs the current transcript context; otherwise omit it or use `context="isolated"`.',

"Use this when the work should happen in a fresh child session instead of the current one.",

? '`mode="run"` one-shot; `mode="session"` persistent/thread-bound.'

: '`mode="run"` one-shot background work.',

"Subagents inherit parent workspace.",

"Native subagents get task in first visible `[Subagent Task]` message.",

'Native only: `context="fork"` only when child needs current transcript; else omit or `isolated`.',

"Use for fresh child-session work.",

];

if (options?.acpAvailable === false) {

return baseDescription

.map((line) =>

line.replace(

' with `runtime="subagent"` or `runtime="acp"`',

" with the native subagent runtime",

),

)

.join(" ");

return baseDescription.join(" ");

}

return [

...baseDescription.slice(0, 3),

'`runtime="acp"` is for external ACP harness ids such as codex, claude, gemini, or opencode, or agents configured with `agents.list[].runtime.type="acp"`.',

'`runtime="acp"` for ACP harness ids: codex, claude, gemini, opencode, or agent ACP runtime config.',

...baseDescription.slice(3),

].join(" ");

}

export function describeSessionStatusTool(): string {

return [

"Show a /status-equivalent session status card for the current or another visible session, including usage, time, cost when available, and linked background task context.",

'Use `sessionKey="current"` for the current session; do not use UI/client labels such as `openclaw-tui` as session keys.',

"Optional `model` sets a per-session model override; `model=default` resets overrides.",

"Use this for questions like what model is active or how a session is configured.",

"Show /status-like card for current/visible session: model, usage, time, cost, tasks.",

'Use `sessionKey="current"` for current session; UI labels like `openclaw-tui` are not keys.',

"`model` sets session override; `model=default` resets.",

"Use for active model/session config questions.",

].join(" ");

}

export function describeUpdatePlanTool(): string {

return [

"Update the current structured work plan for this run.",

"Use this for non-trivial multi-step work so the plan stays current while execution continues.",

"Keep steps short, mark at most one step as `in_progress`, and skip this tool for simple one-step tasks.",

"Update current run plan.",

"Use for non-trivial multi-step work; keep plan current while executing.",

"Short steps; max one `in_progress`; skip for simple one-step work.",

].join(" ");

}