mcpapps

type AppDefinition struct {
	// Name is the unique identifier for this app (e.g., "query-results").
	Name string

	// ResourceURI is the MCP resource URI that serves this app's UI
	// (e.g., "ui://query-results").
	ResourceURI string

	// ToolNames is the list of tool names this app enhances.
	// When any of these tools are called, the response will include
	// _meta.ui metadata pointing to this app.
	ToolNames []string

	// AssetsPath is the absolute filesystem path to the directory
	// containing the app's HTML/JS/CSS files.
	AssetsPath string

	// EntryPoint is the main HTML file within AssetsPath (e.g., "index.html").
	EntryPoint string

	// Config holds app-specific configuration that will be injected
	// into the HTML as JSON. This can be used to configure CDN URLs,
	// feature flags, or other runtime parameters.
	Config any

	// CSP defines Content Security Policy requirements for the app.
	// The host uses this to enforce appropriate CSP headers.
	CSP *CSPConfig
}

type CSPConfig struct {
	// ResourceDomains lists origins for static resources (scripts, images, styles, fonts).
	// Maps to CSP script-src, img-src, style-src, font-src, media-src directives.
	ResourceDomains []string `json:"resourceDomains,omitempty"`

	// ConnectDomains lists origins for network requests (fetch/XHR/WebSocket).
	// Maps to CSP connect-src directive.
	ConnectDomains []string `json:"connectDomains,omitempty"`

	// FrameDomains lists origins for nested iframes.
	// Maps to CSP frame-src directive.
	FrameDomains []string `json:"frameDomains,omitempty"`

	// Permissions lists browser capabilities the app needs.
	// Hosts MAY honor these by setting appropriate iframe allow attributes.
	Permissions *PermissionsConfig `json:"permissions,omitempty"`
}

type PermissionsConfig struct {
	// ClipboardWrite requests write access to the clipboard.
	ClipboardWrite *struct{} `json:"clipboardWrite,omitempty"`
}

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

type ToolMeta struct {
	// UI contains MCP Apps UI metadata.
	UI *UIMetadata `json:"ui,omitempty"`
}

type UIMetadata struct {
	// ResourceURI points to the MCP resource that serves the app UI.
	ResourceURI string `json:"resourceUri"`
}