mcp

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

type ProgressListener func(*ProgressNotification) error

type ProgressNotification struct {
	// JSONRPC version (always "2.0")
	JSONRPC string `json:"jsonrpc"`

	// Method is always "notifications/progress"
	Method string `json:"method"`

	// Params contains the progress notification parameters
	Params ProgressNotificationParams `json:"params"`

	// ID is optional for notifications but can be included for tracking
	ID interface{} `json:"id,omitempty"`
	// contains filtered or unexported fields
}

type ProgressNotificationParams struct {
	// ProgressToken is a unique identifier for this progress tracking session
	ProgressToken string `json:"progressToken"`

	// Progress is the current progress value (required)
	Progress float64 `json:"progress"`

	// Total is the total expected value (optional, for percentage calculations)
	Total *float64 `json:"total,omitempty"`

	// Message is an optional human-readable progress message
	// Note: Only supported in draft and 2025-03-26 versions, not in 2024-11-05
	Message string `json:"message,omitempty"`
}

type ProgressNotificationSender interface {
	SendProgressNotification(progressToken string, progress float64, total *float64, message string) error
}

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

type ProgressReporterConfig struct {
	// RequestID is the ID of the request this progress is associated with
	RequestID string

	// Total is the expected total value for progress (optional)
	Total *float64

	// InitialMessage is the initial progress message
	InitialMessage string

	// TokenManager is used for token lifecycle management (optional, will create default if nil)
	TokenManager *ProgressTokenManager

	// NotificationSender is used to send progress notifications (optional)
	NotificationSender ProgressNotificationSender

	// Parent is the parent ProgressReporter for hierarchical progress (optional)
	Parent *ProgressReporter

	// ChildWeight is how much this reporter contributes to parent's progress (0.0-1.0, default 1.0)
	ChildWeight float64

	// ProtocolVersion specifies which MCP version to use (draft, 2024-11-05, 2025-03-26)
	ProtocolVersion string
}

type ProgressToken struct {
	// Token is the unique string identifier
	Token string

	// RequestID is the ID of the request this progress token is associated with
	RequestID string

	// CreatedAt is when this token was created
	CreatedAt time.Time

	// LastUpdate is when this token was last used for progress reporting
	LastUpdate time.Time

	// IsActive indicates if this token is still active
	IsActive bool

	// LastProgress tracks the last reported progress value to enforce increasing requirement
	LastProgress float64

	// ProtocolVersion tracks which MCP version this token is for
	ProtocolVersion string
}

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

type Prompt struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description,omitempty"`
	Arguments   []PromptArgument       `json:"arguments,omitempty"`
	Annotations map[string]interface{} `json:"annotations,omitempty"`
}

type PromptArgument struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
}

type Resource struct {
	URI         string                 `json:"uri"`
	Name        string                 `json:"name,omitempty"`
	Description string                 `json:"description,omitempty"`
	MimeType    string                 `json:"mimeType,omitempty"`
	Annotations map[string]interface{} `json:"annotations,omitempty"`
}

type SpecVersion string

type Tool struct {
	Name         string                 `json:"name"`
	Description  string                 `json:"description,omitempty"`
	InputSchema  map[string]interface{} `json:"inputSchema"`
	OutputSchema map[string]interface{} `json:"outputSchema,omitempty"`
	Annotations  map[string]interface{} `json:"annotations,omitempty"`
}

type VersionAdapter struct {
	FromVersion string
	ToVersion   string
}

type VersionDetector struct {
	DefaultVersion string   // Default version to use when none is specified
	Supported      []string // Supported versions in order of preference (newest first)
}

type VersionSupport struct {
	V20241105 bool
	V20250326 bool
	Draft     bool
}