Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

api

package

Go to main page

Versions in this module

v1

v1.1.0

Apr 1, 2026

v1.0.0

Mar 6, 2026

Changes in this version

+ var ErrMissingMessage = errors.New("api: message is required")

+ var ErrMissingTenantID = errors.New("api: tenant_id is required")

+ type ChatHandler struct

+ func NewChatHandler() *ChatHandler

+ func (h *ChatHandler) GetHistory(ctx context.Context, sessionID string) ([]Message, error)

+ func (h *ChatHandler) Process(ctx context.Context, req ChatRequest) (*ChatResponse, error)

v0

v0.1.0

Apr 15, 2026

Changes in this version

+ const CorrelationIDHeader

+ const ErrAgentNotConfigured

+ const ErrForbidden

+ const ErrInternal

+ const ErrInvalidRequest

+ const ErrMethodNotAllowed

+ const ErrNotFound

+ const ErrRateLimited

+ const ErrUnauthorized

+ const ErrUnavailable

+ func CorrelationIDFromContext(ctx context.Context) string

+ func CorrelationMiddleware(next http.Handler) http.Handler

+ func MetricsHandler() http.Handler

+ type APIErrorDetail struct

+ Code string

+ Message string

+ type APIErrorResponse struct

+ Error APIErrorDetail

+ type AdminRouter struct

+ func NewAdminRouter(db *sql.DB) *AdminRouter

+ func (ar *AdminRouter) Handler() http.Handler

+ type AuditExecutionStore struct

+ func NewAuditExecutionStore(logger audit.AuditLogger) *AuditExecutionStore

+ func (s *AuditExecutionStore) QueryExecutions(ctx context.Context, limit int) ([]ExecutionRecord, error)

+ type BuildInfo struct

+ Branch string

+ BuildTime string

+ Commit string

+ GoVersion string

+ Version string

+ type ChatRequest struct

+ Message string

+ SessionID string

+ TenantID string

+ UserID string

+ type ChatResponse struct

+ Message string

+ SessionID string

+ SkillUsed string

+ type ComponentHealth struct

+ Details map[string]string

+ DurationMs int64

+ Error string

+ Status string

+ type ExecutionRecord struct

+ DurationMs int64

+ Error string

+ ExecutionID string

+ SessionID string

+ SkillID string

+ Status string

+ type ExecutionStore interface

+ QueryExecutions func(ctx context.Context, limit int) ([]ExecutionRecord, error)

+ type HealthChecker interface

+ Check func(ctx context.Context) ComponentHealth

+ Name func() string

+ type HealthReport struct

+ Branch string

+ BuildTime string

+ CheckedAt time.Time

+ Commit string

+ Components map[string]ComponentHealth

+ GoVersion string

+ Status string

+ Version string

+ type HistoryProvider interface

+ GetSessionHistory func(ctx context.Context, sessionID string) ([]Message, error)

+ type HistoryResponse struct

+ Messages []Message

+ SessionID string

+ type Message struct

+ Content string

+ Role string

+ type Metrics struct

+ func NewMetrics() *Metrics

+ func (m *Metrics) Handler() http.HandlerFunc

+ func (m *Metrics) IncErrors()

+ func (m *Metrics) IncRequests()

+ type ProviderHealthChecker struct

+ func NewProviderHealthChecker(baseURL, apiKey string) *ProviderHealthChecker

+ func (c *ProviderHealthChecker) Check(ctx context.Context) ComponentHealth

+ func (c *ProviderHealthChecker) Name() string

+ type RedisHealthChecker struct

+ func NewRedisHealthChecker(pingFunc func(ctx context.Context) error) *RedisHealthChecker

+ func (c *RedisHealthChecker) Check(ctx context.Context) ComponentHealth

+ func (c *RedisHealthChecker) Name() string

+ type Router struct

+ func NewRouter(a agent.Agent) *Router

+ func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request)

+ func (r *Router) SetAuthMiddleware(mw func(http.Handler) http.Handler)

+ func (r *Router) SetBuildInfo(info BuildInfo)

+ func (r *Router) SetExecutionStore(es ExecutionStore)

+ func (r *Router) SetHealthCheckers(checkers ...HealthChecker)

+ func (r *Router) SetHistoryProvider(hp HistoryProvider)

+ func (r *Router) SetSkillProvider(sp SkillProvider)

+ type SSEEvent struct

+ Data string

+ Event string

+ ID string

+ type SSEHandler struct

+ func NewSSEHandler(w http.ResponseWriter) *SSEHandler

+ func (h *SSEHandler) WriteEvent(event SSEEvent) error

+ type SSEStream struct

+ func NewSSEStream() *SSEStream

+ func (s *SSEStream) Close() error

+ func (s *SSEStream) Count() int

+ func (s *SSEStream) Send(event SSEEvent) error

+ type SkillProvider interface

+ Get func(id string) (skills.Skill, error)

+ List func() []string

+ type SkillResponse struct

+ Description string

+ Enabled bool

+ ID string

+ InputSchema interface{}

+ Name string

+ OutputSchema interface{}

+ Type string

+ Version string