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

string

required

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

string

Optional agent summary used in app listings and diagnostics.

string

required

Primary system instruction passed to the model runtime.

object

required

Model provider configuration for this agent.

Show properties

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 _).

string

required

Provider-specific model name.

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.

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

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.

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.

​Full schema

​Field reference

​JSON Schema

Full schema

Field reference

JSON Schema