AttestoMCP.Server.Content (attesto_mcp_server v0.14.0)

Typed constructors for MCP content returned by handlers.

Constructors emit canonical string-key maps and raise ArgumentError for invalid programmer input. Image, audio, and blob arguments are already Base64-encoded wire values; only canonical padded Base64 is accepted. Constructors use the secure 2,000,000-byte default; pass max_json_bytes: server_budget when the supervised server explicitly uses a larger finite JSON budget.

Raw maps remain supported by AttestoMCP.Server for hosts that need custom extension members.

Summary

Types

budget_option()

common_option()

prompt_message()

resource_content()

resource_content_option()

resource_link_option()

role()

t()

Functions

audio(data, mime_type, opts \\ [])

Builds an audio content block from canonical padded Base64 data.

embedded_resource(resource, opts \\ [])

Builds an embedded-resource content block from one resource content entry.

image(data, mime_type, opts \\ [])

Builds an image content block from canonical padded Base64 data.

prompt_message(role, content, opts \\ [])

Builds one user or assistant prompt message.

resource_blob(uri, blob, opts \\ [])

Builds a blob resource-content entry from canonical padded Base64 data.

resource_link(uri, name, opts \\ [])

Builds a resource-link content block.

resource_text(uri, text, opts \\ [])

Builds a text resource-content entry.

text(text, opts \\ [])

Builds a text content block.

Types

budget_option()

@type budget_option() :: {:max_json_bytes, pos_integer()}

common_option()

@type common_option() :: {:annotations, map()} | {:meta, map()} | budget_option()

prompt_message()

@type prompt_message() :: %{required(String.t()) => term()}

resource_content()

@type resource_content() :: %{required(String.t()) => term()}

resource_content_option()

@type resource_content_option() ::
  {:mime_type, String.t()}
  | {:meta, map()}
  | {:annotations, map()}
  | {:icons, [map()]}
  | budget_option()

resource_link_option()

@type resource_link_option() ::
  common_option()
  | {:title, String.t()}
  | {:description, String.t()}
  | {:mime_type, String.t()}
  | {:size, non_neg_integer()}
  | {:icons, [map()]}

role()

@type role() :: :user | :assistant | String.t()

t()

@type t() :: %{required(String.t()) => term()}

Functions

audio(data, mime_type, opts \\ [])

@spec audio(String.t(), String.t(), [common_option()]) :: t()

Builds an audio content block from canonical padded Base64 data.

embedded_resource(resource, opts \\ [])

@spec embedded_resource(resource_content(), [common_option()]) :: t()

Builds an embedded-resource content block from one resource content entry.

image(data, mime_type, opts \\ [])

@spec image(String.t(), String.t(), [common_option()]) :: t()

Builds an image content block from canonical padded Base64 data.

prompt_message(role, content, opts \\ [])

@spec prompt_message(role(), t(), [budget_option()]) :: prompt_message()

Builds one user or assistant prompt message.

resource_blob(uri, blob, opts \\ [])

@spec resource_blob(String.t(), String.t(), [resource_content_option()]) ::
  resource_content()

Builds a blob resource-content entry from canonical padded Base64 data.

resource_link(uri, name, opts \\ [])

@spec resource_link(String.t(), String.t(), [resource_link_option()]) :: t()

Builds a resource-link content block.

resource_text(uri, text, opts \\ [])

@spec resource_text(String.t(), String.t(), [resource_content_option()]) ::
  resource_content()

Builds a text resource-content entry.

text(text, opts \\ [])

@spec text(String.t(), [common_option()]) :: t()

Builds a text content block.