manifest.yaml Reference

manifest.yaml describes a single capability to the Selu orchestrator. It lives in the root of a capability directory alongside the Dockerfile and optional prompt.md.

Minimal example

name: weather-lookup
class: tool
display_name: Weather Lookup
description: Fetches current weather and forecasts for a given location.
version: 1.0.0

Full example

name: weather-lookup
class: tool
display_name: Weather Lookup
description: Fetches current weather and forecasts for a given location.
version: 1.0.0

tools:
  - name: weather_lookup
    description: Get current weather conditions for a location.
    parameters:
      - name: location
        type: string
        required: true
        description: City name or "lat,lon" coordinates.
      - name: units
        type: string
        required: false
        default: metric
        description: "Unit system: metric or imperial."

resources:
  memory: 128Mi
  cpu: 0.25
  timeout: 10s

env:
  - name: WEATHER_API_KEY
    required: true
    description: API key for the weather data provider.

health:
  endpoint: /healthz
  interval: 30s

Schema

Top-level fields

Field	Type	Required	Description
name	string	Yes	Unique identifier (lowercase, hyphens).
class	string	Yes	tool or environment.
display_name	string	Yes	Human-readable name.
description	string	Yes	One-line summary (max 160 chars).
version	string	Yes	Semantic version.
tools	list	Yes	Tool definitions exposed to the LLM.
resources	object	No	Container resource limits.
env	list	No	Environment variable declarations.
health	object	No	Health check configuration.

tools[*]

Each entry in tools describes one callable function that the LLM can invoke.

Field	Type	Required	Description
name	string	Yes	Tool name used in gRPC InvokeRequest.tool_name.
description	string	Yes	Sent to the LLM to explain what the tool does.
parameters	list	No	Input parameter definitions.

tools[*].parameters[*]

Field	Type	Required	Description
name	string	Yes	Parameter name.
type	string	Yes	string, number, boolean, object, array.
required	bool	No	Default false.
default	any	No	Default value when not provided.
description	string	Yes	Explains the parameter to the LLM.

resources

Field	Type	Default	Description
memory	string	256Mi	Memory limit (e.g. 128Mi, 1Gi).
cpu	string	0.5	CPU limit in cores.
timeout	string	30s	Max execution time per invocation.

env[*]

Field	Type	Required	Description
name	string	Yes	Variable name.
required	bool	No	If true, the orchestrator will refuse to start without it.
description	string	No	Displayed in the UI when prompting the user for credentials.