integration.communication-channel-sms
CommunicationOS SMS channel adapter: inbound normalization (Twilio webhook parse), outbound send (provider-sms/Twilio), and documented-retention erasure.
@lssm-tech/integration.communication-channel-smsbun add @lssm-tech/integration.communication-channel-smsManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
This package owns the canonical Twilio SMS channel adapter for CommunicationOS. It supports signature-verified inbound form webhooks, provider-backed outbound delivery, normalized ecosystem events and receipts, and explicit provider-retention behavior.
The adapter uses an explicit Node-compatible build profile, including Bun server hosts. Its credential and webhook boundary does not advertise a browser export condition. Existing package entry points and provider contracts remain unchanged.
Ecosystem composition
Use createTwilioSmsEcosystemAdapter from @lssm-tech/integration.communication-channel-sms/ecosystem-adapter when composing the current CommunicationOS ecosystem port. The adapter requires an injected SmsProvider, an E.164 sender number, and the Twilio auth token used to verify inbound signatures.
Managed connections store only an opaque credential reference. The resolved secret document is expected to contain:
{
"network": "sms",
"provider": "twilio",
"accountSid": "...",
"authToken": "...",
"fromNumber": "+..."
}The managed API accepts only application/x-www-form-urlencoded payloads with an X-Twilio-Signature that verifies against the exact callback URL. The managed worker rejects other providers or incomplete credential material.
Local conformance is not live provider qualification. Production activation still requires consent and opt-out enforcement, credentialed callback/send tests, delivery-status reconciliation, and an accepted Runtime Node effect path.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
7 declarations
@lssm-tech/integration.builder-whatsappworkspace:^
Read the package manual ↗@lssm-tech/integration.communication-channel-coreworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-smsworkspace:^
Read the package manual ↗@lssm-tech/lib.builder-runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.builder-specworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-integrationsworkspace:^
Read the package manual ↗
Declared capabilities
CommunicationOS SMS channel adapter: inbound normalization (Twilio webhook parse), outbound send (provider-sms/Twilio), and documented-retention erasure.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolint:checknode ../../../scripts/biome.cjs check .lint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit