Skip to content

Conversation

@triepod-ai
Copy link
Contributor

Summary

Adds missing destructiveHint annotations to 4 tools that already had partial annotations (title, openWorldHint):

  • Abort Actor run (src/tools/run.ts): Added destructiveHint: true - terminates running processes (irreversible)
  • Add tool (src/tools/helpers.ts): Added destructiveHint: false - registers tools (additive operation)
  • Call Actor (src/tools/actor.ts): Added destructiveHint: false - creates new runs (additive)
  • Dynamic Actor tools (src/tools/actor.ts): Added destructiveHint: false - execute actors

Why

The destructiveHint annotation helps LLM clients understand whether a tool performs destructive operations, enabling better safety prompting and user confirmation flows.

Test plan

  • npm run build passes
  • npm run lint passes
  • npm run type-check passes

🤖 Generated with Claude Code

Complete the tool annotation coverage by adding destructiveHint:

- Abort Actor run: destructiveHint=true (terminates running processes)
- Add tool: destructiveHint=false (additive - registers new tools)
- Call Actor: destructiveHint=false (creates new runs)
- Dynamic Actor tools: destructiveHint=false (executes actors)

This completes the MCP tool annotation coverage for the project,
helping LLMs better understand tool behavior.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Copy link
Contributor

@MQ37 MQ37 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the contribution 👍

FYI @jirispilka

@jirispilka jirispilka self-requested a review January 5, 2026 07:48
Copy link
Collaborator

@jirispilka jirispilka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

We appreciate it!
When reviwing it, I've noticed that the hints can be improved. I'l address it in a seperate PR

@jirispilka jirispilka merged commit fe796e1 into apify:master Jan 5, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants