webhook

Documentation

Overview

Package webhook implements inbound webhook routing for serve channels. External services (GitHub, CI, etc.) POST events to /webhook/<path>, which are verified and dispatched to agent tasks.

Index

• type Handler
• type RouteConfig
• type Router
  • func NewRouter(routes []RouteConfig, secret string, handler Handler) *Router
  • func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request)

Types

type Handler

type Handler interface {
	HandleWebhookEvent(ctx context.Context, route RouteConfig, payload []byte) error
}

Handler processes incoming webhook events.

type RouteConfig

type RouteConfig struct {
	Path           string   `json:"path"`
	Events         []string `json:"events"`
	Skill          string   `json:"skill"`
	Delivery       string   `json:"delivery"`                  // "wechat", "feishu", or "" (no delivery)
	DeliveryTarget string   `json:"delivery_target,omitempty"` // platform-specific recipient id
}

RouteConfig defines a webhook route.

type Router

type Router struct {
	// contains filtered or unexported fields
}

Router manages webhook routes and dispatches events.

func NewRouter

func NewRouter(routes []RouteConfig, secret string, handler Handler) *Router

NewRouter creates a webhook router.

func (*Router) ServeHTTP

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

ServeHTTP handles incoming webhook requests. Expected path: /webhook/<route-path>