agent-hint.yaml 1.8 KB

123456789101112131415161718192021222324252627
  1. name: agent-hint
  2. repo: https://github.com/dachaimahogany/hermes-agent-hint
  3. sha: f9ee87b69a3a5c44e0b2adeca75bbf54a1d7657e
  4. description: "Give the inference engine behind each request a standard, machine-readable view of the agent session that produced it. Injects an X-Agent-Hint header (base64url JSON: session identity and call index, lifecycle state, soft priority, a cache-pinning hint, optional measured statistics) on main LLM requests, and can emit session lifecycle events out of band as local ndjson or as POSTs to a URL you configure. Request bodies are never modified, and nothing is added or sent until the plugin is enabled. Lets a scheduler pin a session to the instance already holding its KV cache, or rank a user-blocked session above background work, without teaching the engine anything about the client. Disclosure — when enabled, every main LLM request carries an X-Agent-Hint header (base64url JSON with the session id, call index, lifecycle state, priority, cache-retention hints and measured latency/token/request-interval statistics, plus tool names and timings when next_action_map is set) to whatever provider is configured, not only hint-aware engines; with status_sink: http the same session events and usage/latency statistics are POSTed to the status_url you set, and ndjson writes them under $HERMES_HOME."
  5. maintainer: dachaimahogany
  6. tier: community
  7. category: general
  8. docs_url: https://github.com/dachaimahogany/hermes-agent-hint#readme
  9. version: "0.7.1"
  10. requires_hermes: ">=0.21.6"
  11. platforms: []
  12. capabilities:
  13. provides_tools: []
  14. provides_hooks:
  15. - on_session_start
  16. - on_session_end
  17. - on_session_finalize
  18. - pre_tool_call
  19. - post_tool_call
  20. - pre_approval_request
  21. - post_approval_response
  22. - subagent_start
  23. - subagent_stop
  24. - post_api_request
  25. provides_middleware:
  26. - llm_request
  27. requires_env: []