Skip to content

Toolshed v0.1.0

Choose a tag to compare

@Huy3ko Huy3ko released this 23 Aug 12:50
· 79 commits to main since this release

First public release.

An adaptive tool-surface proxy for Hermes — reduces repeated tool-schema overhead while preserving on-demand recovery.

Highlights

  • Session-sticky tool-surface routing (deterministic + optional LLM classifier)
  • Floor toolsets: critical capabilities are never pruned
  • Dynamic MCP routing: any configured MCP server becomes routable automatically
  • Monotonic recovery via request_toolset (fail-open)
  • Profile-scoped state: multi-agent safe
  • Explicit authorization: requires --allow-tool-override grant; fail-closed without it

Measured

  • ~31% input-token reduction on a fresh Hermes setup (identical tasks, ON vs OFF)
  • 32–70% in earlier controlled paired workloads
  • Results vary with tool count and workload — see docs/benchmarks for methodology

Install

hermes plugins install Huy3ko/toolshed
hermes plugins enable hermes-token-router --allow-tool-override

Then set global.enabled: true in the plugin's config.yaml. See README for the full guide.

Known limitations

  • Gateway-restart/learning persistence not yet validated in systemd-user environments
  • Validated against Hermes upstream b766607b