OzMcp.Structs.ResourceLink (OzMcp v0.9.0)

Copy Markdown View Source

Helper module used to build ResourceLink structure.

(MCP protocol: 2025-11-25)

Short example:

%ResourceLink{}
  |> ResourceLink.uri("file:///logs/app.log")
  |> ResourceLink.name("app.log")
  |> ResourceLink.build()

Result:

%{name: "app.log", type: "resource_link", uri: "file:///logs/app.log"}

Long example:

%ResourceLink{}
  |> ResourceLink.uri("file:///logs/app.log")
  |> ResourceLink.name("app.log")
  |> ResourceLink.title("Application log")
  |> ResourceLink.description("Main application log file")
  |> ResourceLink.mime_type("text/plain")
  |> ResourceLink.size(1024)
  |> ResourceLink.annotations(
    %Annotations{}
    |> Annotations.audience(["assistant"])
  )
  |> ResourceLink.build()

Result:

%{
  name: "app.log",
  size: 1024,
  type: "resource_link",
  description: "Main application log file",
  title: "Application log",
  uri: "file:///logs/app.log",
  annotations: %{audience: ["assistant"]},
  mimeType: "text/plain"
}

Specification: ResourceLink

Fields

FieldSetterTypeRequired
uriuri/2stringyes
namename/2stringyes
titletitle/2stringno
descriptiondescription/2stringno
mimeTypemime_type/2stringno
_meta_meta/2mapno
iconsicons/2list of OzMcp.Structs.Icon.t/0no
annotationsannotations/2OzMcp.Structs.Annotations.t/0no
sizesize/2non-negative integerno

Summary

Types

t()

@type t() :: %OzMcp.Structs.ResourceLink{
  _meta: map() | nil,
  annotations: OzMcp.Structs.Annotations.t() | nil,
  description: String.t() | nil,
  icons: [OzMcp.Structs.Icon.t()] | nil,
  mimeType: String.t() | nil,
  name: String.t(),
  size: non_neg_integer() | nil,
  title: String.t() | nil,
  uri: String.t()
}

Functions

annotations(struct, value)

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

build(struct)

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

description(struct, value)

@spec description(t(), String.t() | nil) :: t()

icons(struct, value)

@spec icons(t(), [OzMcp.Structs.Icon.t()] | nil) :: t()

mime_type(struct, value)

@spec mime_type(t(), String.t() | nil) :: t()

name(struct, value)

@spec name(t(), String.t()) :: t()

size(struct, value)

@spec size(t(), non_neg_integer() | nil) :: t()

title(struct, value)

@spec title(t(), String.t() | nil) :: t()

uri(struct, value)

@spec uri(t(), String.t()) :: t()