Message Courier Service
The message courier service is a headless automation engine that reads pending dispatch records from an internal ledger, executes portal interactions via private runtime adapters, and writes completion timestamps back without embedding any client-specific logic in the open-source codebase.
service-message-courier is a headless web-automation and
messaging component designed to bridge service-people, the
internal identity ledger, with external web portals. The service
operates as a generic execution engine: all portal-specific logic
is supplied at runtime through the adapter pattern, so the core
engine remains free of hard-coded selectors, credentials, or
target URLs. The adapter directory (private-adapters/) is
excluded from version control so proprietary client operational
data never enters the public Git history.
Adapter pattern
The core engine contains no knowledge of any specific portal or
site. Operational logic — CSS selectors, URL shapes, authentication
flows — is injected at runtime via scripts placed in
private-adapters/. This directory is explicitly excluded by
.gitignore. The separation means the open-source monorepo
remains tenant-agnostic while each deployment instance carries its
own private adapter set.
Operational flow
The courier follows a three-step cycle per dispatch:
- Query. The engine polls the local ledger for pending dispatch records.
- Execution. It mounts the specified private adapter and runs the headless browser routine against the target portal.
- Write-back. On success, the engine logs the completion timestamp to the ledger and unloads the adapter.
Each step is isolated. A failure at execution does not corrupt the ledger record; the dispatch remains pending until a successful write-back closes it.
See Also
References
Copyright © 2026 Woodfine Capital Projects Inc. Licensed under Creative Commons Attribution 4.0 International.
Woodfine Capital Projects™, Woodfine Management Corp™, PointSav Digital Systems™, Totebox Orchestration™, and Totebox Archive™ are trademarks of Woodfine Capital Projects Inc., used in Canada, the United States, Latin America, and Europe. All other trademarks are the property of their respective owners.