# `OzMcp.Structs.EmbeddedResource`
[🔗](https://github.com/oz-elixir/oz_mcp/blob/v0.9.0/lib/oz_mcp/structs/embedded_resource.ex#L1)

Helper module used to build `EmbeddedResource` structure.

_(MCP protocol: 2025-11-25)_

## Short example:

```elixir
%EmbeddedResource{}
  |> EmbeddedResource.resource(
    %TextResourceContents{}
    |> TextResourceContents.uri("file:///logs/app.log")
    |> TextResourceContents.text("INFO App started")
  )
  |> EmbeddedResource.build()
```

Result:

```elixir
%{
  type: "resource",
  resource: %{text: "INFO App started", uri: "file:///logs/app.log"}
}
```

## Long example:

```elixir
%EmbeddedResource{}
  |> EmbeddedResource.resource(
    %BlobResourceContents{}
    |> BlobResourceContents.uri("file:///assets/logo.png")
    |> BlobResourceContents.blob("iVBORw0KGgoAAAANSUhEUg==")
    |> BlobResourceContents.mime_type("image/png")
  )
  |> EmbeddedResource.annotations(
    %Annotations{}
    |> Annotations.audience(["assistant"])
  )
  |> EmbeddedResource._meta(%{"key" => "value"})
  |> EmbeddedResource.build()
```

Result:

```elixir
%{
  type: "resource",
  resource: %{
    uri: "file:///assets/logo.png",
    blob: "iVBORw0KGgoAAAANSUhEUg==",
    mimeType: "image/png"
  },
  annotations: %{audience: ["assistant"]},
  _meta: %{"key" => "value"}
}
```

Specification: [EmbeddedResource](https://modelcontextprotocol.io/specification/2025-11-25/schema#embeddedresource)

## Fields

| Field | Setter | Type | Required |
|---|---|---|---|
| `resource` | `resource/2` | resource() | no |
| `annotations` | `annotations/2` | `t:OzMcp.Structs.Annotations.t/0` | no |
| `_meta` | `_meta/2` | map | no |

# `resource`

```elixir
@type resource() :: OzMcp.Structs.ResourceContents.t()
```

# `t`

```elixir
@type t() :: %OzMcp.Structs.EmbeddedResource{
  _meta: map() | nil,
  annotations: OzMcp.Structs.Annotations.t() | nil,
  resource: resource()
}
```

# `annotations`

```elixir
@spec annotations(t(), OzMcp.Structs.Annotations.t() | nil) :: t()
```

# `build`

```elixir
@spec build(t()) :: map()
```

# `resource`

```elixir
@spec resource(t(), resource()) :: t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
