Hyperterse — Agentic server framework.

Each app/agents/*/config.terse defines one declarative agent exposed at /agent/{name}.

Full schema

app/agents/support/config.terse

name: support
description: 'Support assistant'
instruction: 'Resolve user support requests and call tools when needed.'
model:
  provider: openai_compatible
  model: gpt-4o-mini
  options:
    base_url: 'https://api.openai.com/v1'
    api_key: '{{ env.OPENAI_API_KEY }}'
tool_access:
  mode: inherit

Field reference

name

string

required

Agent name. Must be unique across all discovered agents and match ^[a-z][a-z0-9_-]*$.

description

string

Optional agent summary used in app listings and diagnostics.

instruction

string

required

Primary system instruction passed to the model runtime.

model

object

required

Model provider configuration for this agent.

Show properties

provider

string

required

Model provider identifier.Supported values:

gemini, google_ai_studio
vertex, vertex_ai
openai_compatible, openai

Provider names are normalized when the agent loads (lowercased, - converted to _).

model

string

required

Provider-specific model name.

options

object

Provider-specific options map.In config, option values may be scalar (string, number, boolean). At build time, values are stringified for use by the agent.Model option values support {{ env.VAR_NAME }} substitution when the agent model starts. Missing variables fail startup.For secrets, use provider default env vars (for example OPENAI_API_KEY, GOOGLE_API_KEY) or api_key: "{{ env.YOUR_SECRET_VAR }}".For provider-specific keys and env fallbacks, see Model providers.

tool_access

object

Tool access policy for this agent. Optional — defaults to inherit when omitted, which uses the root-level defaults from .hyperterse (agents.tool_access). If no root-level default is set either, the effective mode is allow_all.

Show properties

mode

string

default:"inherit"

One of:

inherit — use root-level defaults from .hyperterse (agents.tool_access).
allow_all — agent can call every discovered tool.
allow_none — agent cannot call any project tools.
allow_list — agent can call only the listed tools.

tools

string[]

Required when mode=allow_list. Every tool name must exist in the project.

JSON Schema

Editor validation: schema/agent.terse.schema.json. Associate with **/agents/**/config.terse. See Configuration schemas.

CLI

Configuration

Documentation Index

​Full schema

​Field reference

​JSON Schema

Full schema

Field reference

JSON Schema