plugin.yaml 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. name: line-platform
  2. label: LINE
  3. kind: platform
  4. version: 1.0.0
  5. description: >
  6. LINE Messaging API gateway adapter for Hermes Agent.
  7. Runs an aiohttp webhook server that receives LINE webhook events
  8. (with HMAC-SHA256 signature verification) and relays messages between
  9. LINE chats (1:1, groups, rooms) and the Hermes agent. Outbound replies
  10. prefer the free reply token and fall back to the metered Push API
  11. when the token has expired or is absent. Slow LLM responses surface a
  12. Template Buttons postback bubble so the user can fetch the answer with
  13. a fresh reply token (free) once it's ready.
  14. author: Hermes Agent contributors
  15. # ``requires_env`` and ``optional_env`` entries are surfaced in the
  16. # ``hermes config`` UI via the platform-plugin env var injector in
  17. # ``hermes_cli/config.py``.
  18. requires_env:
  19. - name: LINE_CHANNEL_ACCESS_TOKEN
  20. description: "LINE channel long-lived access token (LINE Developers Console > Messaging API > Channel access token)"
  21. prompt: "LINE channel access token"
  22. url: "https://developers.line.biz/console/"
  23. password: true
  24. - name: LINE_CHANNEL_SECRET
  25. description: "LINE channel secret (used for HMAC-SHA256 webhook signature verification)"
  26. prompt: "LINE channel secret"
  27. url: "https://developers.line.biz/console/"
  28. password: true
  29. optional_env:
  30. - name: LINE_PORT
  31. description: "Webhook listen port (default: 8646)"
  32. prompt: "Webhook port"
  33. password: false
  34. - name: LINE_HOST
  35. description: "Webhook bind host (default: unset → dual-stack, all interfaces IPv4+IPv6)"
  36. prompt: "Webhook host"
  37. password: false
  38. - name: LINE_PUBLIC_URL
  39. description: "Public HTTPS base URL for serving images/audio/video to LINE (e.g. https://my-tunnel.example.com). Required for media sending when the bind address is not directly reachable."
  40. prompt: "Public HTTPS base URL"
  41. password: false
  42. - name: LINE_ALLOWED_USERS
  43. description: "Comma-separated LINE user IDs allowed to DM the bot (U-prefixed)"
  44. prompt: "Allowed user IDs (comma-separated)"
  45. password: false
  46. - name: LINE_ALLOWED_GROUPS
  47. description: "Comma-separated LINE group IDs the bot will respond in (C-prefixed)"
  48. prompt: "Allowed group IDs (comma-separated)"
  49. password: false
  50. - name: LINE_ALLOWED_ROOMS
  51. description: "Comma-separated LINE room IDs the bot will respond in (R-prefixed)"
  52. prompt: "Allowed room IDs (comma-separated)"
  53. password: false
  54. - name: LINE_ALLOW_ALL_USERS
  55. description: "Allow any LINE user to talk to the bot (dev only — disables allowlist)"
  56. prompt: "Allow all users? (true/false)"
  57. password: false
  58. - name: LINE_HOME_CHANNEL
  59. description: "Default user/group/room ID for cron / notification delivery"
  60. prompt: "Home channel ID (or empty)"
  61. password: false
  62. - name: LINE_SLOW_RESPONSE_THRESHOLD
  63. description: "Seconds before the slow-LLM postback button fires (default: 45; set 0 to disable and always Push-fallback)"
  64. prompt: "Slow response threshold (seconds)"
  65. password: false