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
Business
invoice-processorintermediateExtract line items, validate totals, categorize expenses, escalate on mismatch.
APIs used
ctx.filesctx.llmctx.dbctx.provenancectx.call.human()finance/invoice/processcontract-analyzerintermediateAnalyze contracts, extract clauses, identify risks, flag for legal review.
APIs used
ctx.filesctx.llmctx.call.human()legal/contract/analyzeexpense-report-generatorbeginnerAggregate expenses by category, generate formatted reports, cache templates.
APIs used
ctx.dbctx.filesctx.memoryctx.llmfinance/expense/reportreceipt-ocr-processorbeginnerExtract structured data from receipt images via LLM vision.
APIs used
ctx.filesctx.llmctx.secretsfinance/receipt/extractResearch
multi-source-researcherintermediateQuery multiple sources in parallel, synthesize into a coherent result.
APIs used
ctx.call.parallel()ctx.llmctx.memory.sessionresearch/multi_sourcecompetitive-intelligenceintermediateMonitor competitor sites, summarize changes, schedule recurring jobs.
APIs used
ctx.queuectx.llmctx.cacheresearch/competitive/monitordocument-summarizerbeginnerSummarize long documents with intelligent chunking (map-reduce pattern).
APIs used
ctx.filesctx.llmctx.promptsdocument/summarizesemantic-searchintermediateIndex documents and search by semantic similarity. The RAG foundation.
APIs used
ctx.llm.embed()ctx.memory.persistentresearch/semantic-searchresearch/index-documentsprompt-driven-analyzeradvancedFull prompt management flow with telemetry, feedback, and composed layers.
APIs used
ctx.prompts.load()ctx.prompts.compose()ctx.llmanalysis/prompt-drivenWorkflows
multi-level-approvaladvancedRequest → Manager → VP → CFO approval flow with delegation narrowing at each level.
APIs used
ctx.call.human()workflow/approval/multi_levelnewsletter-orchestratorintermediateMulti-agent workflow: fetch headlines → summarize → send email.
APIs used
ctx.call.agent()ctx.llmcontent/newsletter/orchestrateresilient-pipelineadvancedPipeline with retry, fallback, and human escalation for error recovery.
APIs used
ctx.call.human()ctx.queueworkflows/resilient-pipelineworkflows/error-recoveryjob-lifecycle-managerintermediateManage background jobs with deduplication, cancellation, and cache invalidation.
APIs used
ctx.queuectx.cacheworkflows/job-lifecycleworkflows/dedupsystem-integrationintermediateSync data between CRM, billing, and support systems.
APIs used
ctx.secretsctx.queuectx.filesintegration/syncSecurity
pii-redactorintermediateScan documents for PII, redact automatically, or escalate to human review.
APIs used
ctx.filesctx.llmctx.call.human()security/pii/redactcode-reviewerbeginnerReview code for security and quality issues (runs in isolated V8 sandbox).
APIs used
ctx.llmctx.filessecurity/code/reviewcompliance-auditorintermediateCheck actions against compliance rules by querying the provenance trail.
APIs used
ctx.provenance.query()ctx.provenance.trace()compliance/auditData
etl-pipelineadvancedExtract from APIs, transform, load to warehouse with dedup and atomic transactions.
APIs used
ctx.queuectx.cachectx.db.transaction()data/etl/executedata-quality-checkerintermediateValidate data integrity, flag anomalies, escalate critical quality issues.
APIs used
ctx.dbctx.provenancectx.call.human()data/quality/checkreport-generatorbeginnerGenerate daily analytics reports from DB, cache templates, write output.
APIs used
ctx.dbctx.memoryctx.filesreporting/generatestreaming-analyzerintermediateStream LLM analysis over datasets with real-time token accumulation.
APIs used
ctx.llm.stream()ctx.dbctx.provenancedata/stream-analysisdata/real-time-analyticsdata-validatorbeginnerValidate JSON input against an optional schema. Returns valid/invalid status + error list.
APIs used
ctx.provenancedata/validateOperations
meeting-notes-agentintermediateEvent-triggered extraction of meeting notes from transcripts. Uses prompt registry for all LLM calls, execution memory for transcript buffer, and Fourth Law escalation.
APIs used
ctx.promptsctx.resourcesctx.memory.executionctx.llmctx.call.human()ctx.provenancemeetings/notes/extractinterview-coachadvancedMulti-turn interview coach: session start, score answers, generate questions, synthesize feedback. Demonstrates session + persistent memory and resource-backed state.
APIs used
ctx.promptsctx.memory.sessionctx.memory.persistentctx.memory.executionctx.resourcesctx.llmctx.eventsctx.provenancecoaching/interview/conductcoaching/interview/assesshuman.support-triageintermediateSupport ticket triage muscle: classify ticket, re-rank KB docs, draft resolution. Published as agent via publishAsAgent: true.
APIs used
ctx.promptsctx.memory.executionctx.resourcesctx.llmctx.provenancesupport/triageprompt-refinement-agentadvancedSelf-improving prompt system with human-in-loop review and governance.
APIs used
ctx.promptsctx.llmctx.call.human()operations/prompt-refinementConnectors
Connectors integrate HUMΛN notifications and events with external services. Each one is a reference implementation in packages/connectors/.Build your own →
@human/connector-email-sendgridTransactional email via Twilio SendGrid. Tier 1 HUMΛN-published.
@human/connector-email-google-workspaceEnterprise email via Google Workspace Gmail API.
@human/connector-email-microsoft365Enterprise email via Microsoft 365 Graph API.
@human/connector-email-mailgunTransactional email via Mailgun.
@human/connector-email-postmarkTransactional email via Postmark.
@human/connector-email-sesEmail via AWS SES.
@human/connector-email-smtpUniversal SMTP — covers self-hosted, Exchange relay, Gmail SMTP, and any SMTP endpoint.
Messaging & Alerts
@human/connector-slack-notificationsSlack channel notification connector.
@human/connector-twilio-smsSMS notifications via Twilio.
@human/connector-pagerdutyOps and alerting via PagerDuty.
@human/connector-webhookGeneric webhook — deliver notifications to any HTTPS endpoint.
Platforms
@human/connector-salesforceSalesforce CRM integration.
@human/connector-google-calendarGoogle 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