Tools

Two tools, exposed over stdio.

notify_human

Fire-and-forget. Sends a message to the configured human and returns immediately without waiting for a reply.

Field	Type	Required	Description
`message`	`string`	Yes	The text delivered to the human.

notify_human({ message: "Deploy to prod finished ✅" })

Returns a success result as soon as the message is delivered.

ask_human

Sends a question, then blocks until the human replies (or a timeout elapses) and returns their answer.

Field	Type	Required	Description
`question`	`string`	Yes	The question delivered to the human.
`choices`	`string[]`	No	Renders as tappable inline buttons; the tapped value is returned.
`timeoutMs`	`number`	No	Reply deadline in ms. Defaults to 5 minutes.

With buttons

ask_human({
  question: "Apply this migration to prod?",
  choices: ["Yes", "No"]
})

The human taps a button; the agent receives "Yes" or "No".

Open-ended

ask_human({ question: "What should the release title be?" })

The agent receives the human's free-text reply.

On timeout

If no reply arrives before timeoutMs, the tool returns a clear timed-out result rather than throwing — so the calling agent always gets a clean, structured signal.

← Quickstart Configuration →