What problem does it solve?
Converts external webhook payloads (e.g., SMS, meeting updates, social mentions) into sanitized, structured brain pages so events reliably enter the brain ingestion pipeline with citations and entity extraction.
Core Features & Use Cases
- Webhook event transformation framework: Defines a consistent mapping from raw JSON payloads to brain page markdown plus metadata (slug/type/citations).
- Safety-focused input sanitization: Strips HTML and escapes script content to prevent unsafe content from reaching brain pages.
- Reliable processing with observability: Preserves raw payloads for troubleshooting via a dead-letter queue on transform failure and retries once, while surfacing error type to the agent.
- Downstream integration: Writes pages via
gbrain put, runs entity extraction/enrichment, adds timeline entries, and syncs with gbrain sync.
- Use case: When an SMS indicates a meeting time change, the skill transforms the message into a timeline entry on the sender’s brain page and updates related task context if an action item is detected.
Quick Start
Tell the system to register the webhook endpoint for your external provider and apply the webhook-transforms contract to convert incoming events into brain pages with entity extraction and timeline updates.