codegen

type AdapterData struct {
	ServiceName           string
	ServiceGoName         string
	MCPServiceName        string
	MCPName               string
	MCPVersion            string
	MCPDescription        string
	WebsiteURL            string
	Icons                 []*IconData
	Package               string
	MCPPackage            string
	ImportPath            string
	Tools                 []*ToolAdapter
	Resources             []*ResourceAdapter
	SkillDirectories      []*SkillDirectoryAdapter
	StaticPrompts         []*StaticPromptAdapter
	DynamicPrompts        []*DynamicPromptAdapter
	HasWatchableResources bool

	Register   *RegisterData
	OAuth      *OAuthData
	ToolSearch *ToolSearchData
}

type AnnotationMetaEntry struct {
	Key    string
	Values []string
}

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

type DynamicPromptAdapter struct {
	Name               string
	Description        string
	Icons              []*IconData
	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 EnumField struct {
	Name    string
	Values  []string
	Pointer bool
}

type IconData struct {
	Source   string
	MIMEType string
	Sizes    []string
	Theme    string
}

type OAuthData struct {
	AuthorizationServers     []string
	Scopes                   []OAuthScopeData
	ResourceIdentifier       string
	BearerMethodsSupported   []string
	ResourceDocumentationURL string
	// TrustProxyHeaders controls whether generated code honors
	// X-Forwarded-* and RFC 7239 Forwarded headers when deriving
	// the canonical resource URL and the WWW-Authenticate
	// challenge origin. Default is false: a server reachable
	// directly by clients must not trust forwarded headers because
	// an attacker could otherwise control the PRM `resource` field.
	TrustProxyHeaders bool
}

type OAuthScopeData struct {
	Name        string
	Description string
}

type ProjectedToolAdapter struct {
	SourceToolset       string
	SourceTool          string
	Description         string
	Title               string
	PlacementService    string
	PlacementMCPServer  string
	SpecsPackageName    string
	SpecsImportPath     string
	SpecName            string
	BoundService        string
	BoundMethod         string
	MethodPayloadType   string
	RuntimeToolName     string
	DispatcherFuncName  string
	DispatchOptionsName string
	QualifiedSourceTool string
	HasPayload          bool
	HasResult           bool
	InjectedFields      []string
	HasBounds           bool
	InputSchema         string
	OutputSchema        string
	ExampleArguments    string
}

type PromptArg struct {
	Name        string
	Description string
	Required    bool
	Values      []string
}

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 RequiredField struct {
	Name       string
	AllowsNull bool
}

type ResourceAdapter struct {
	Name               string
	Description        string
	URI                string
	MimeType           string
	Icons              []*IconData
	OriginalMethodName string
	HasPayload         bool
	HasResult          bool
	PayloadType        string
	ResultType         string
	QueryFields        []*ResourceQueryField
	QuerySchema        string
	Watchable          bool
	IsStreaming        bool
	StreamInterface    string
	StreamEventType    string
}

type ResourceQueryField struct {
	QueryKey       string
	GuardExpr      string
	ValueExpr      string
	CollectionExpr string
	FormatKind     string
	Repeated       bool
	Bits           int
	DefaultValues  []string
}

type RuntimePromptAdapter struct {
	AgentID  string
	Role     string
	Template string
	Version  string
}

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

type SkillDirectoryAdapter struct {
	Root string
}

type StaticPromptAdapter struct {
	Name          string
	Description   string
	Icons         []*IconData
	Messages      []*PromptMessageAdapter
	RuntimePrompt *RuntimePromptAdapter
}

type ToolAdapter struct {
	Name               string
	Description        string
	Title              string
	DiscoveryCategory  string
	DiscoveryTags      []string
	DiscoveryKeywords  []string
	Icons              []*IconData
	OriginalMethodName string
	Meta               []AnnotationMetaEntry
	MetaJSON           string
	AnnotationsJSON    string
	HasPayload         bool
	HasResult          bool
	PayloadType        string
	ResultType         string
	InputSchema        string
	OutputSchema       string
	IsStreaming        bool
	StreamInterface    string
	StreamEventType    string
	// Simple validations (top-level only)
	RequiredFields []RequiredField
	EnumFields     []EnumField
	DefaultFields  []DefaultField
	// ExampleArguments contains a minimal valid JSON for tool arguments
	ExampleArguments string
	// CanonicalExampleJSON is a deterministic, always-valid JSON example of
	// the payload, synthesized from the IR. Used by the per-tool input
	// recovery function emitted into the adapter.
	CanonicalExampleJSON string
	// UnionEnvelopes lists, for each top-level payload field whose type is
	// a discriminated union, the metadata the recovery hint needs to
	// describe valid discriminator values and the configured branch key.
	UnionEnvelopes []UnionEnvelopeMeta
	// Projected is non-nil when this adapter comes from an agent toolset
	// projected into MCP instead of a method-level MCP Tool declaration.
	Projected *ProjectedToolAdapter
}

type ToolSearchData struct {
	DefaultMaxResults int
	MinScore          int
	ExactMatchMode    string
	FuzzyNameMatching bool
	BroadFallback     bool
	NameWeight        int
	TitleWeight       int
	MetadataWeight    int
	DescriptionWeight int
	ParameterWeight   int
	FuzzyNameWeight   int
}

type UnionEnvelopeMeta struct {
	// FieldName is the outer payload field that holds the union envelope
	// (e.g. "request" when the payload declares Attribute("request", OneOf(...))).
	FieldName string
	// TypeKey is the discriminator field name inside the envelope (defaults to "type").
	TypeKey string
	// ValueKey is the inner branch payload key inside the envelope (defaults to "value").
	ValueKey string
	// Tags lists the declared discriminator values in DSL source order.
	Tags []string
	// FirstTag is the deterministic substitution tag used when the caller
	// supplied an invalid discriminator. Equal to Tags[0] when Tags is non-empty.
	FirstTag string
	// TagExamples maps each declared tag to the canonical full-payload JSON
	// example that uses that tag for this envelope. When the caller supplies a
	// valid tag but some other field is malformed, the recovery hint reuses the
	// caller's tag by looking it up here.
	TagExamples map[string]string
}