Sake.Schema (Sake v0.1.0)

Copy Markdown View Source

Builds JSON Schema 2020-12 from arg declarations and validates arguments against it.

The validator covers what the declarations emit: object properties, required, additionalProperties, the primitive types, enum, arrays of one type, minimum/maximum, minLength/maxLength, pattern, and default. It never fetches a $ref.

Summary

Types

arg()
type()

Functions

build(args)
header_paths(schema)

Header name → property path for every x-mcp-header reachable through properties only.

valid_header_name?(name)
validate(schema, input)

Validates input (string or atom keys) against schema. Returns the arguments with atom keys for declared properties (undeclared properties keep their string keys when the schema allows them, so client input never creates atoms), defaults applied, and nil for absent optional properties.

Types

arg()

@type arg() :: {atom(), type(), keyword()}

type()

@type type() ::
  :string
  | :integer
  | :number
  | :boolean
  | :any
  | {:array, type()}
  | {:enum, [term()]}
  | {:object, [arg()]}

Functions

build(args)

@spec build([arg()]) :: map()

header_paths(schema)

@spec header_paths(map()) :: %{required(String.t()) => [String.t()]}

Header name → property path for every x-mcp-header reachable through properties only.

valid_header_name?(name)

@spec valid_header_name?(term()) :: boolean()

validate(schema, input)

@spec validate(map(), map()) ::
  {:ok, map()} | {:error, [%{path: [String.t()], message: String.t()}]}

Validates input (string or atom keys) against schema. Returns the arguments with atom keys for declared properties (undeclared properties keep their string keys when the schema allows them, so client input never creates atoms), defaults applied, and nil for absent optional properties.