Contribution kind: search-type. Ingestion: biome-host parser (SearchTypeParser).

A result-type is the (objectKind, docType) facet a biome makes searchable. It is declarative and boot-time. Document INSTANCES are a separate, runtime, event-fed path — contributing a result-type does not index anything by itself; it teaches the platform how to render, deep-link, and authorize hits of that facet.

Contributing render hints is what makes a new biome fully renderable in search without anyone adding a per-kind branch to the frontend.

manifest

renderHints

authz

The routeTemplate grammar

A routeTemplate is a site-relative path with {placeholder} segments. The placeholder vocabulary is CLOSED, and both the syntax and the SATISFIABILITY are validated at contribution-parse time — a broken deep link is rejected at boot, never discovered in production.

Placeholder syntax: \{([A-Za-z0-9_]+)\}.

Variables

Each variable has exactly one supply route. scope and identity variables are derived by the platform from the hit or object ref and are never declared. projected variables can only come from the owning source, so a template that references one MUST declare it in renderHints.routeParams — and the producer must stamp it on the indexed document.

Rejected at parse time — syntax

Rejected at parse time — supply contract

Enforced in both directions: a template may not reference a projected variable the result-type does not declare, and a declared variable the template never references is a dead declaration.

Worked example

1{
2  "renderHints": {
3    "label": "Runbook",
4    "routeTemplate": "/projects/{projectId}/documents/{containerSlug}/{slug}",
5    "routeParams": ["containerSlug","slug"]
6  }
7}

Expanding it for a hit in project proj_42, container runbooks, slug incident response yields:

Every substituted value occupies a single path segment and is URL-encoded, so a value containing /, ?, #, or a space can never change the shape of the path. Expansion is all-or-nothing: a missing value throws rather than emitting a half-substituted URL.

Related concepts

• contribution-kind — the full catalog
• object-kind — the identity backbone every result addresses through
• permission — how the authz mapping is enforced