Skip to main content

Module messaging_adapter

Module messaging_adapter 

Source
Expand description

Messaging adapter plugin discovery and external plugin wrapper.

§Plugin discovery

Plugins are searched in order:

  1. ~/.config/ta/plugins/messaging/ — user-global
  2. .ta/plugins/messaging/ — project-local
  3. $PATH — bare executable with prefix ta-messaging-

The first matching plugin for the given provider name is used.

§ExternalMessagingAdapter

Wraps an external plugin process and translates trait calls into JSON-over-stdio request/response exchanges. Each method call spawns a fresh process (plugins are stateless per-call).

§Credentials

Credentials (OAuth2 tokens, IMAP passwords) are stored in the OS keychain under the key ta-messaging:<provider>:<address>. Plugins retrieve them via the keyring crate or by calling ta adapter credentials get <key>.

Structs§

DiscoveredMessagingPlugin
A discovered messaging plugin with its manifest and origin.
ExternalMessagingAdapter
Messaging adapter that delegates all operations to an external plugin process.
MessagingPluginManifest
Parsed plugin.toml manifest for a messaging adapter plugin.

Enums§

MessagingPluginSource
Where a messaging plugin was discovered from.

Functions§

discover_messaging_plugins
Discover all messaging adapter plugins.
find_messaging_plugin
Find a messaging plugin by provider name.