codegen

type AdapterData struct {
	ServiceName         string
	ServiceGoName       string
	MCPServiceName      string
	MCPName             string
	MCPVersion          string
	ProtocolVersion     string
	Package             string
	MCPPackage          string
	ServiceJSONRPCAlias string
	ImportPath          string
	Tools               []*ToolAdapter
	Resources           []*ResourceAdapter
	StaticPrompts       []*StaticPromptAdapter
	DynamicPrompts      []*DynamicPromptAdapter
	Notifications       []*NotificationAdapter
	Subscriptions       []*SubscriptionAdapter
	// Streaming flags derived from original service DSL
	ToolsCallStreaming bool
	// Derived flags
	HasWatchableResources bool
	NeedsMCPClient        bool
	NeedsOriginalClient   bool
	NeedsQueryFormatting  bool

	Register     *RegisterData
	ClientCaller *ClientCallerData
}

type AnnotationMetaEntry struct {
	Key    string
	Values []string
}

type ClientCallerData struct {
	MCPImportPath string
}

type DefaultField struct {
	Name    string
	GoName  string
	Literal string
	Kind    string
}

type DynamicPromptAdapter struct {
	Name               string
	Description        string
	OriginalMethodName string
	HasPayload         bool
	PayloadType        string
	ResultType         string
	// Arguments describes prompt arguments derived from the payload (dynamic prompts)
	Arguments []PromptArg
	// ExampleArguments contains a minimal valid JSON for prompt arguments
	ExampleArguments string
}

type NotificationAdapter struct {
	Name               string
	Description        string
	OriginalMethodName string
	HasMessage         bool
	MessagePointer     bool
	HasData            bool
}

type PromptArg struct {
	Name        string
	Description string
	Required    bool
}

type PromptMessageAdapter struct {
	Role    string
	Content string
}

type RegisterData struct {
	Package            string
	HelperName         string
	ServiceName        string
	SuiteName          string
	SuiteQualifiedName string
	Description        string
	Tools              []RegisterTool
}

type RegisterTool struct {
	ID            string
	QualifiedName string
	Description   string
	Meta          []AnnotationMetaEntry
	PayloadType   string
	ResultType    string
	InputSchema   string
	ExampleArgs   string
}

type ResourceAdapter struct {
	Name               string
	Description        string
	URI                string
	MimeType           string
	OriginalMethodName string
	HasPayload         bool
	HasResult          bool
	PayloadType        string
	ResultType         string
	QueryFields        []*ResourceQueryField
	Watchable          bool
}

type ResourceQueryField struct {
	QueryKey       string
	GuardExpr      string
	ValueExpr      string
	CollectionExpr string
	FormatKind     string
	Repeated       bool
}

type ServiceMethodMapping struct {
	ToolMethods          map[string]string
	ResourceMethods      map[string]string
	DynamicPromptMethods map[string]string
}

type StaticPromptAdapter struct {
	Name        string
	Description string
	Messages    []*PromptMessageAdapter
}

type SubscriptionAdapter struct {
	ResourceName       string
	ResourceURI        string
	OriginalMethodName string
}

type ToolAdapter struct {
	Name               string
	Description        string
	OriginalMethodName string
	Meta               []AnnotationMetaEntry
	AnnotationsJSON    string
	HasPayload         bool
	HasResult          bool
	PayloadType        string
	ResultType         string
	InputSchema        string
	IsStreaming        bool
	StreamInterface    string
	StreamEventType    string
	// Simple validations (top-level only)
	RequiredFields []string
	EnumFields     map[string][]string
	EnumFieldsPtr  map[string]bool
	DefaultFields  []DefaultField
	// ExampleArguments contains a minimal valid JSON for tool arguments
	ExampleArguments string
}