Most/Docs

Most documentation

Most is a self-hosted messaging bridge: one HTTP API for iMessage and SMS, with signed inbound webhooks, PostgreSQL-backed state, deterministic per-chat worker affinity and location tracking — so Wisent keeps credentials, conversation identity, delivery state and where its contacts are instead of handing them to an external aggregator.

What Most solves#

Wisent messaging services need iMessage and SMS without making an external aggregator the authority for credentials, conversation identity, delivery state, or inbound events. The previous dependency on an external aggregator made transport behavior and recovery depend on a third-party control plane.

Most replaces that with auditable, self-hosted state, explicit transport capability, deterministic per-chat worker affinity, and independently recoverable adapters.

Who it serves#

  • Wisent service developers call one `/v3` HTTP API instead of integrating separately with Messages.app, Apple protocols, and Twilio.
  • Messaging operators run the control plane, PostgreSQL, and physical transport workers while retaining explicit control over identities and credentials.
  • Worker and integration authors implement one capability-declaring backend contract without changing the public messaging API.

How it works#

`most-server` owns the public API and composition. `most-core` owns wire contracts, persistence interfaces, backend routing, signing, and worker affinity. PostgreSQL is authoritative in production; in-memory storage exists only for explicit development compositions.

`BackendRouter` chooses a backend that truthfully declares the requested service. `BackendPool` chooses a worker for a new chat and persists that assignment; every subsequent operation resolves the same worker.

Architecture
api_service
    │  HTTPS /v3/* + bearer capability
    ▼
most-server ───────── PostgreSQL
    │
    ├── Twilio SMS
    ├── direct-apple receive/development path (outbound unavailable)
    └── mTLS WebSocket ── native Mac / device worker
                              │
                              ├── Messages.app via AppleScript
                              └── ~/Library/Messages/chat.db
                                          │
                                          ▼
                                  signed subscriber webhooks

Status#

Pre-1.0: current source version 0.1.0, owned by `most-rs/crates/most-server/Cargo.toml`. Public contracts may change under the 0.x policy. `main` is the supported development source; no stable release channel has been published yet, so production installation from `main` is unsupported.

Most is proprietary Wisent AI software. Issues and operational support run through the private wisent-ai/most repository; security reports follow SECURITY.md via the repository's private GitHub Security Advisory channel.