5
SDK languages
An agent-first SDK for messaging
Build custom clients, internal triage queues and MCP tools. Strict types, event replay and worked prompt fixtures, so a coding agent can read the repository instead of guessing.
19
Networks in scope
10
Live today
MIT
Licence
1import { CommsOS } from "@commsos/sdk";23const commsos = new CommsOS({ token: process.env.COMMSOS_TOKEN });45// One stream for supported networks, one event shape.6for await (const event of commsos.stream({ channels: "all" })) {7 if (event.type !== "message.received") continue;89 const thread = await commsos.threads.get(event.thread_id);10 const summary = await thread.summarize();11 const draft = await thread.draft({ voice: "me" });1213 await thread.send(draft.text, { requireApproval: true });14}Six surfaces to build on
5 SDKs
Typed libraries for TypeScript, Python, Swift, Kotlin, and Go. The same objects and the same event names in every one of them.
REST API
The same objects cover contacts, threads, messages, and files across supported networks. One JSON interface reads the history and sends the reply.
Streaming and webhooks
Subscribe to incoming messages and delivery changes. Every delivery carries a signed header, and events can be replayed after an outage.
MCP servers
Give an agent inbox tools through MCP. It reads threads, pulls the context it needs and stages a draft for approval.
Credentials for agents
Issue a credential for named threads and allowed actions. Each call an agent makes enters the audit log next to the calls people make.
Prompt fixtures
The SDKs ship schemas and worked prompts that a coding agent can read instead of guessing at the shape of a message.
MIT licensed
Supported networks, one payload shape
A Signal voice note, a Telegram supergroup message and an email arrive with the same envelope and the same event names. Transcripts and extracted commitments are already attached. The differences that remain, like media limits and send windows, are described in one capability object per channel.
Streaming events are not metered.
1{2 "id": "evt_01J9WQ2K7",3 "type": "message.received",4 "created_at": "2025-05-14T09:06:12Z",5 "channel": "signal",6 "thread_id": "thr_8f21c9",7 "contact": { "id": "con_4d1", "name": "Amina Yusuf", "identities": 3 },8 "message": {9 "kind": "voice",10 "duration_ms": 41000,11 "transcript": "Legal needs another week, so the launch moves to Thursday the 12th.",12 "language": "en-GB",13 "media": [{ "id": "med_92a", "bytes": 418220, "mime": "audio/ogg" }]14 },15 "extracted": {16 "commitments": [17 { "kind": "date_change", "field": "launch", "value": "2025-06-12" },18 { "kind": "deadline", "value": "2025-05-15T16:00:00Z" }19 ]20 }21}Prompt fixtures
TypeScript schemas, tool definitions and the evaluation fixtures the SDK is checked against before each release. A coding agent reads them instead of guessing at the shape of a message.
Reference clients for common builds
Four implementations we are building to publish with the SDK, each showing one pattern end to end. The screens below are the designs they are being built to.
Support queue
Unassigned4Waiting2Overdue1
Maya Chen
Legal needs another week. Please move the launch to Thursday, 12 June.
Amina Yusuf
Does the 5 June date still hold for the staging login?
Emily Park
Sending the redirect list once the new date is confirmed.
Northstar launch
Legal needs another week. Please move the launch to Thursday, 12 June.
AssigneeSofia Costa
Internal note
Ravi is redoing the QA plan for the 12th. Reply once he confirms.
Support queue
A web inbox with assignment, internal notes, saved views, and response timers.
Maya Chen
Northstar
Sofia Costa
Launch
Cross-network history
MessageLegal needs another week.Open thread
Voice noteAmina confirms the new date.Open thread
Filelaunch-checklist-v3.pdfOpen thread
CommitmentLaunch moves to 12 June.Open thread
<CommsTimeline contactId="ct_maya_chen" />
CRM timeline
An embeddable panel that shows a contact’s cross-network history inside a CRM.
$ cos search "when did northstar move the launch"
1 slack Maya Chen · 14 May 2025
Legal needs another week. Please move the launch to Thursday, 12 June.
cos://thread/northstar-launch
2 email Emily Park · 15 May 2025
Checklist attached. The launch now reads 12 June.
cos://thread/northstar-checklist
open 1 · export --format mbox · ~/.cos/config.toml sets api_url and credential
$
History CLI
A terminal client for search and export, with links back to each source thread.
Review queue
3 drafts waiting
Maya Chen
Amina Yusuf
Emily Park
Triggering message
Legal needs another week. Please move the launch to Thursday, 12 June.
Proposed reply
Thanks Maya. The launch now reads Thursday 12 June and the new checklist goes out today.
Approve and sendEditReject
Credential: Alder agent · Sofia Costa · approved · 15 May 2025 09:12
Agent review console
A small app shows drafts from an agent and records send approval beside each decision.
Get a key and a sandbox tenant
Sandbox tenants come with preloaded message history for the first render.