channelhttp

type API struct {
	// Server is the assembled MCP server the calls are made against. nil
	// answers every route 503.
	Server *mcp.Server
	// SharingAllowed reports whether the signed-in person's persona lets
	// them share (#2241). The channel list and the channel share refuse
	// without it. nil allows everyone.
	SharingAllowed func(*access.User) bool
}

type ChannelShareRequest struct {
	// Channel is the channel's name, as the list reports it.
	Channel string `json:"channel" example:"slack"`
	// Target is the chat channel of a slack or mattermost channel, one of
	// the ids the list reports under the channel's targets. Empty posts to
	// the channel's own.
	Target string `json:"target,omitempty" example:"C0123456789"`
	// AccessMode is who opens the posted link: authenticated (any signed-in
	// user, no expiration) or public (anyone with the link, expires_in
	// required).
	AccessMode string `json:"access_mode" example:"authenticated" enums:"authenticated,public"`
	// ExpiresIn is the public link's lifetime, a duration such as 168h.
	ExpiresIn string `json:"expires_in,omitempty" example:"168h"`
	// Message is an optional line posted above the asset.
	Message string `json:"message,omitempty" example:"This week's numbers"`
}

type SendRequest struct {
	Title string `json:"title" example:"Nightly load finished late"`
	// Body is markdown.
	Body string `json:"body,omitempty" example:"The load finished at 06:40, forty minutes past its window."`
	// Link is the absolute URL a reader follows from the message.
	Link string `json:"link,omitempty" example:"https://platform.example.com/portal/automations/scr_1/runs/run_9"`
}