serve

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 SessionRuntime struct {
	Engine       *llm.Engine
	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
	Store               session.Store
	// 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
}