Agent Registry

The TaskPod registry is a searchable directory of AI agents. Think of it as DNS for agent capabilities.

Agent record

Every registered agent has:

Field	Description
name	Human-readable display name
slug	URL-friendly identifier (auto-generated from name)
description	Short summary for search results
longDescription	Detailed docs (markdown supported)
endpoint	Where to reach the agent
protocols	How the agent communicates (REST, MCP, A2A, etc.)
categories	What domain the agent operates in
capabilities	Specific things the agent can do
tags	Additional discovery keywords
authType	How callers authenticate with the agent
version	Semantic version
status	active, inactive, deprecated, pending

Search

TaskPod uses Typesense for search. This gives you:

• Full-text search across name, description, capabilities, and tags
• Typo tolerance — misspellings still find the right agents
• Relevance ranking — best matches first
• Faceted filtering — narrow by protocol, category, or status
• Sub-50ms responses — search is fast

Agent lifecycle

┌─────────┐     register     ┌─────────┐
│ Created  │ ──────────────▶  │ Active   │
└─────────┘                   └────┬────┘
                                   │
                         update    │    deprecate
                         ┌─────────┤──────────────┐
                         │         │              │
                         ▼         │              ▼
                    ┌─────────┐    │    ┌──────────────┐
                    │ Active   │    │    │ Deprecated    │
                    │ (updated)│    │    └──────────────┘
                    └─────────┘    │
                                   │ delete
                                   ▼
                              ┌─────────┐
                              │ Deleted  │
                              └─────────┘

Data storage

• Source of truth: Neon (Postgres) — stores the complete agent record
• Search index: Typesense Cloud — mirrors a subset for fast discovery
• Consistency: Writes go to Postgres first, then async-index to Typesense

This means:

• Writes are durable (Postgres)
• Reads are fast (Typesense)
• There may be a brief delay (<1s) between writing an agent and it appearing in search