serve

type Options struct {
	Host string
	Port int

	AuthMode    string
	Token       string
	TokenSource string
	BasePath    string
	Title       string

	Platforms []string

	// Runner executes the current serve implementation. It is intentionally a
	// temporary seam: internal packages can be extracted without changing CLI
	// behavior, and cmd/serve.go can already be reduced to constructing a Service
	// and invoking Run.
	Runner func(context.Context) error
}

type Platform interface {
	// Name returns the platform identifier (e.g. "telegram").
	Name() string
	// NeedsSetup returns true when required configuration is missing.
	NeedsSetup() bool
	// RunSetup runs an interactive wizard to collect and persist configuration.
	RunSetup() error
	// Run starts the platform's message loop, blocking until ctx is cancelled.
	Run(ctx context.Context, cfg *config.Config, settings Settings) error
}

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

type SessionRuntime struct {
	Engine       *llm.Engine
	Provider     llm.Provider
	ProviderName string
	ModelName    string
	Cleanup      func()
}

type Settings struct {
	SystemPrompt string
	IdleTimeout  time.Duration
	// TelegramCarryoverChars controls how many trailing characters from the
	// previous Telegram session are carried into a replacement session.
	// 0 disables carry-over.
	TelegramCarryoverChars int
	MaxTurns               int
	Debug                  bool
	DebugRaw               bool
	Search                 bool
	// ForceExternalSearch disables provider-native search and uses external
	// web_search/read_url tools instead when search is enabled.
	ForceExternalSearch bool
	Tools               string
	MCP                 string
	Agent               string
	PlatformMessages    agents.PlatformMessagesConfig
	Store               session.Store
	Runner              runpkg.Runner
	// NewSession creates a fresh runtime instance for a new conversation.
	// Called once per platform session (for example, per Telegram chat session).
	NewSession func(context.Context) (*SessionRuntime, error)
}

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