Reference Implementations

23 production-quality agents and 11 connectors from packages/agents-reference. Clone them, run them, or adapt them as a starting point for your own agents.

These are real agents running in production. Each one is a complete, working implementation — not a toy or tutorial stub. They demonstrate real patterns: human escalation, cost tracking, parallel calls, vector search, atomic transactions, and more. Where multiple languages are available, a language switcher lets you compare TypeScript, Python, and Go side by side. Read the source. Run the tests. Fork and adapt.

Reference Agents

Research

Workflows

Data

Operations

Connectors

Connectors integrate HUMΛN notifications and events with external services. Each one is a reference implementation in packages/connectors/.Build your own →

Email

@human/connector-email-sendgrid

Transactional email via Twilio SendGrid. Tier 1 HUMΛN-published.

@human/connector-email-google-workspace

Enterprise email via Google Workspace Gmail API.

@human/connector-email-microsoft365

Enterprise email via Microsoft 365 Graph API.

@human/connector-email-mailgun

Transactional email via Mailgun.

@human/connector-email-postmark

Transactional email via Postmark.

@human/connector-email-ses

Email via AWS SES.

@human/connector-email-smtp

Universal SMTP — covers self-hosted, Exchange relay, Gmail SMTP, and any SMTP endpoint.

Messaging & Alerts

@human/connector-slack-notifications

Slack channel notification connector.

@human/connector-twilio-sms

SMS notifications via Twilio.

@human/connector-pagerduty

Ops and alerting via PagerDuty.

@human/connector-webhook

Generic webhook — deliver notifications to any HTTPS endpoint.

Platforms

@human/connector-salesforce

Salesforce CRM integration.

@human/connector-google-calendar

Google Calendar integration.

Running the Reference Suite

Every reference agent has a full test suite. Run them all to verify your environment, or run individual agents against your own HUMΛN instance.

# Run all reference agent tests

pnpm test:agents:reference

# Verbose output

pnpm test:agents:reference:verbose

See Also