@spec app_mime_type() :: String.t()

The MIME type of MCP App HTML: text/html;profile=mcp-app.

@spec app_resource(map()) :: map() | nil

The MCP App in a resources/read result, or nil: the HTML of its first content with the MCP App MIME type (text, or base64 blob), with the csp and permissions of that content's _meta.ui.

iex> A2UICore.MCP.app_resource(%{"contents" => [
...>   %{"uri" => "ui://game", "mimeType" => "text/html;profile=mcp-app", "text" => "<p>Hi</p>"}
...> ]})
%{"htmlContent" => "<p>Hi</p>"}

@spec mime_type() :: String.t()

The MIME type of A2UI content: application/a2ui+json.

@spec resource_messages(map(), String.t()) ::
  {:ok, [map()]} | {:error, A2UICore.Error.t()}

The A2UI messages of a resources/read result: the JSON of every content with the A2UI MIME type, in order.

@spec tool_result_messages(map()) :: {:ok, [map()]} | {:error, A2UICore.Error.t()}

The A2UI messages embedded in a tool result's content: the JSON of every resource block with the A2UI MIME type, in order. A block whose text is not JSON is an error.

@spec ui_resource_uris(map() | nil) :: [String.t()]

The UI resource URIs a tool descriptor or a tool result names in _meta.ui.resourceUri, without duplicates.

iex> A2UICore.MCP.ui_resource_uris(%{"_meta" => %{"ui" => %{"resourceUri" => "ui://card"}}})
["ui://card"]
iex> A2UICore.MCP.ui_resource_uris(%{"content" => []})
[]