hashgraph / hashgraph/hedera-agent-kit-py
docs: add hook lifecycle stages and BaseTransactionTool guidance to PLUGINS.md
- Dominant language
- Python
- Stars
- 11
- Forks
- 10
- PR merge metrics
- No merged PRs in 30d
Description
#353 (predicates epic) must be fully complete before starting this task. T3 (#357) must also be complete — this doc references `BaseTransactionTool` and `BaseQueryTool` introduced there.
JS reference: [PR #720](https://github.com/hashgraph/hedera-agent-kit-js/pull/720)
## Scope
- Add 4-stage hook lifecycle section to `docs/PLUGINS.md`:
1. `pre_tool_execution`
2. `post_params_normalization`
3. `post_core_action`
4. `post_secondary_action`
- Clarify which stages fire for `BaseTransactionTool` vs query tools; note that plain `Tool` subclasses do not participate in hooks
- Add `examples/plugin/smoke_test.py` mirroring the JS lifecycle test pattern
- Cross-link from main hooks docs
Contributor guide
Research direction
First verify that #353 and #357 are complete, then read docs/PLUGINS.md and the existing hook documentation. Use the JS lifecycle test pattern referenced in PR #720 to shape examples/plugin/smoke_test.py. Done means the four stages, tool participation rules, and cross-links are documented and the smoke test covers the lifecycle.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100