Skip to content

docs: add a minimal custom plugin template (#889)#899

Open
jmgomezl wants to merge 1 commit into
hashgraph:mainfrom
jmgomezl:docs/custom-plugin-template
Open

docs: add a minimal custom plugin template (#889)#899
jmgomezl wants to merge 1 commit into
hashgraph:mainfrom
jmgomezl:docs/custom-plugin-template

Conversation

@jmgomezl

@jmgomezl jmgomezl commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

What this does

Adds a "Creating a Custom Plugin" section to the plugin docs, addressing #889.

It gives a minimal, copy-paste TypeScript template so teams can stand up their own plugin quickly:

  • Plugin / Tool / Context imports from @hashgraph/hedera-agent-kit
  • a Zod parameter schema
  • a plain-object tool with a simple execute(client, context, params)
  • registration alongside the core plugins (e.g. coreAccountQueryPlugin, coreConsensusPlugin)
  • a short note on when to extend BaseTool instead, for hook/policy coverage

The existing examples/plugin/example-plugin.ts is a great full BaseTool reference, so I kept this focused on the quick-start path and linked out to that example for the advanced case.

Docs-only change, additive.

Adds a 'Creating a Custom Plugin' section to HEDERAPLUGINS.md with a
copy-paste TypeScript template: Plugin/Tool/Context imports, a Zod
parameter schema, a plain-object tool with execute(client, context,
params), and registration alongside the core plugins. Includes a short
note on when to extend BaseTool instead (for hook/policy coverage),
linking the existing examples/plugin/example-plugin.ts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: jmgomezl <juanmag.lpez@gmail.com>
@jmgomezl jmgomezl requested review from a team as code owners June 5, 2026 03:46
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.

1 participant