plugin.yaml 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. name: google_chat-platform
  2. label: Google Chat
  3. kind: platform
  4. version: 1.0.0
  5. description: >
  6. Google Chat gateway adapter for Hermes Agent.
  7. Connects through authenticated HTTP callbacks or an optional Cloud Pub/Sub
  8. pull subscription for inbound events, and uses the Google Chat REST API for
  9. outbound messages. Native file attachments are delivered via per-user OAuth
  10. (each user runs /setup-files once in their own DM).
  11. author: Ramón Fernández
  12. # ``requires_env`` entries are surfaced in ``hermes config`` UI via the
  13. # platform-plugin env var injector in ``hermes_cli/config.py``. Using the
  14. # rich-dict form lets us contribute description/url/prompt metadata so users
  15. # see helpful guidance instead of the auto-generated fallback text.
  16. requires_env:
  17. - name: GOOGLE_CHAT_SERVICE_ACCOUNT_JSON
  18. description: "Path to Service Account JSON key (or inline JSON). Leave empty to use Application Default Credentials on Cloud Run / GCE. Falls back to GOOGLE_APPLICATION_CREDENTIALS."
  19. prompt: "Path to SA JSON (or empty for ADC)"
  20. password: true
  21. optional_env:
  22. - name: GOOGLE_CHAT_HTTP_EVENTS_URL
  23. description: "Authenticated HTTP endpoint for Chat message events."
  24. prompt: "HTTP events callback URL"
  25. password: false
  26. - name: GOOGLE_CHAT_HTTP_EVENTS_AUDIENCE
  27. description: "Expected audience for Google-signed HTTP event bearer tokens. Defaults to GOOGLE_CHAT_HTTP_EVENTS_URL."
  28. prompt: "HTTP events token audience"
  29. password: false
  30. - name: GOOGLE_CHAT_HTTP_EVENTS_SERVICE_ACCOUNT_EMAIL
  31. description: "Expected Google service account email for HTTP event bearer tokens."
  32. prompt: "HTTP events service account email"
  33. password: false
  34. - name: GOOGLE_CHAT_PROJECT_ID
  35. description: "GCP project ID for optional Pub/Sub inbound mode. Falls back to GOOGLE_CLOUD_PROJECT."
  36. prompt: "GCP project ID"
  37. url: "https://console.cloud.google.com/"
  38. password: false
  39. - name: GOOGLE_CHAT_SUBSCRIPTION_NAME
  40. description: "Optional Pub/Sub subscription path for pull-mode inbound events."
  41. prompt: "Pub/Sub subscription name"
  42. password: false
  43. - name: GOOGLE_CHAT_ALLOWED_USERS
  44. description: "Comma-separated user emails allowed to interact with the bot."
  45. prompt: "Allowed user emails (comma-separated)"
  46. password: false
  47. - name: GOOGLE_CHAT_HOME_CHANNEL
  48. description: "Default space for cron / notification delivery (e.g. spaces/AAAA...)."
  49. prompt: "Home space ID (or empty)"
  50. password: false