Raxol.AgentClientProtocol.Schema.ContentBlock (Raxol Agent Client Protocol v0.1.0)

Content blocks represent displayable information in ACP: a tagged union discriminated by a "type" wire key (text | image | audio | resource_link | resource). Named ContentBlock both upstream and here (all other structs ported from content.ex -- Role, Annotations, TextContent, ImageContent, AudioContent, TextResourceContents, BlobResourceContents, EmbeddedResourceResource, EmbeddedResource, ResourceLink -- are separate, bare Schema.* modules, not nested under this one).

Ported from the MIT f1729/agent_client_protocol (c) 2025 f1729; see NOTICE.md.

Summary

Types

t()

Functions

audio(audio_content)

from_json(map)

Total: never raises. An unrecognized/missing "type", or a variant body that fails to decode, returns {:error, _} (a content block has no documented default variant, unlike e.g. ToolCall.ToolKind).

from_string(text)

Convenience: create a text content block from a plain string.

image(image_content)

resource(er)

resource_link(rl)

text(text_content)

to_json(arg)

Types

t()

@type t() ::
  {:text, Raxol.AgentClientProtocol.Schema.TextContent.t()}
  | {:image, Raxol.AgentClientProtocol.Schema.ImageContent.t()}
  | {:audio, Raxol.AgentClientProtocol.Schema.AudioContent.t()}
  | {:resource_link, Raxol.AgentClientProtocol.Schema.ResourceLink.t()}
  | {:resource, Raxol.AgentClientProtocol.Schema.EmbeddedResource.t()}

Functions

audio(audio_content)

@spec audio(Raxol.AgentClientProtocol.Schema.AudioContent.t()) :: t()

from_json(map)

@spec from_json(term()) :: {:ok, t()} | {:error, term()}

Total: never raises. An unrecognized/missing "type", or a variant body that fails to decode, returns {:error, _} (a content block has no documented default variant, unlike e.g. ToolCall.ToolKind).

from_string(text)

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

Convenience: create a text content block from a plain string.

image(image_content)

@spec image(Raxol.AgentClientProtocol.Schema.ImageContent.t()) :: t()

resource(er)

@spec resource(Raxol.AgentClientProtocol.Schema.EmbeddedResource.t()) :: t()

resource_link(rl)

@spec resource_link(Raxol.AgentClientProtocol.Schema.ResourceLink.t()) :: t()

text(text_content)

@spec text(Raxol.AgentClientProtocol.Schema.TextContent.t()) :: t()

to_json(arg)

@spec to_json(t()) :: map()