feat: Agentic Discover endpoint — API search for agents

[santoshkumarradha]

Summary

Agents need a programmatic way to find the right API endpoint for their task. Currently they must know exact paths or read documentation.

Solution

GET /api/v1/agentic/discover — Search and filter API endpoints.

Query Parameters

Param	Type	Description
q	string	Keyword search (matches path, summary, tags)
group	string	Filter by endpoint group (nodes, execute, memory, etc.)
method	string	Filter by HTTP method
limit	int	Max results (default 20, max 100)

Response

{
    "ok": true,
    "data": {
        "endpoints": [...],
        "total": 42,
        "groups": ["health", "discovery", "nodes", "execute", ...],
        "filters": {"q": "execute", "group": "", "method": ""}
    }
}

Results are filtered by the caller's auth level — unauthenticated callers only see public endpoints.

Depends On

• # (API Catalog Registry)

Files

• New: internal/handlers/agentic/discover.go
• Modify: internal/server/server.go — Register route

Acceptance Criteria

• curl /api/v1/agentic/discover?q=execute returns relevant endpoints
• curl /api/v1/agentic/discover?group=memory returns only memory endpoints
• Without API key: only public endpoints returned

[santoshkumarradha]

Implemented in feat/agentic-api branch (commit 80e7920). PR #283.

File: internal/handlers/agentic/discover.go