Hyperterse — Agentic server framework.

The root configuration file (.hyperterse) defines service-level settings and discovery settings. Adapter and tool definitions are discovered from the filesystem, and prompts/resources can be configured through discovery directories or optional inline lists.

Full schema

.hyperterse

name: my-service
version: 1.0.0

root: app

tools:
  directory: tools
  search:
    limit: 10
  cache:
    enabled: true
    ttl: 60

adapters:
  directory: adapters

prompts:
  directory: prompts

resources:
  directory: resources

resource_templates: []

agents:
  directory: agents
  tool_access:
    mode: allow_none

server:
  port: 8080
  log_level: 3

build:
  out: dist
  clean_dir: false

Field reference

string

required

Service identifier. Used in logging, tracing, and manifest metadata. Must match ^[a-z][a-z0-9_-]*$.

string

Service version. Informational. Included in manifest metadata and startup logs.

string

default:"app"

Base directory for adapter/tool discovery. Relative to the root config path.

object

Tool discovery and global tool cache defaults.

Show properties

string

default:"tools"

Tools directory relative to root.

object

Global cache defaults for DB-backed tools.

Show properties

boolean

default:"false"

Enable in-memory tool result caching globally.

integer

default:"120"

Default TTL in seconds for cached tool results.

object

Global search defaults for MCP search results.

Show properties

integer

default:"10"

Maximum number of ranked tools returned from a single MCP search call.

object

Adapter discovery settings.

Show properties

string

default:"adapters"

Adapters directory relative to root.

object | array

Prompt configuration:

Show object mode (discovery)

string

default:"prompts"

Prompts directory relative to root.

Show array mode (inline definitions)

Inline prompt definitions as an array of prompt objects (name, optional arguments, and required messages).

object | array

Resource configuration:

Show object mode (discovery)

string

default:"resources"

Resources directory relative to root.

Show array mode (inline concrete resources)

Inline concrete resources as an array of objects (uri, metadata, and one of text or file).

array

Optional inline URI-template resources. Each item defines uri_template, metadata, template content (text_template or file_template), and optional arguments.

object

Agent discovery settings and project-level default tool access policy.

Show properties

string

default:"agents"

Agents directory relative to root.

object

Default tool access policy for agents. Individual agents can override this in config.terse.

Show properties

string

default:"allow_none"

One of allow_all, allow_none, allow_list.

string[]

Required when mode=allow_list. Contains the allowed project tool names.

For file-based prompt/resource configs, see Prompt configuration and Resource configuration.

object

Server runtime settings.

Show properties

integer | string

default:"8080"

TCP port for the HTTP/MCP server.Resolution order: --port flag → server.port config → PORT env → 8080

integer

default:"3"

Log verbosity. 1 = error, 2 = warn, 3 = info, 4 = debug.Resolution order: --verbose (4) → --log-level flag → server.log_level config → 3

object

Build output settings.

Show properties

string

default:"dist"

Output directory for build artifacts. out_dir is an equivalent alias.Resolution order: --out flag → build.out config → dist

boolean

default:"false"

Remove output directory before building.

Environment variable substitution

String values support {{ env.VAR_NAME }} placeholders, resolved at runtime:

server:
  port: '{{ env.PORT }}'

Missing variables cause a startup failure. Verify all referenced variables are set before deploying.

JSON Schema

Editor validation: schema/root.terse.schema.json. See Configuration schemas.

Examples

Minimal
Production

.hyperterse

name: my-service

All other fields use defaults: port 8080, log level 3, caching disabled.

.hyperterse

name: production-service
version: 2.1.0

server:
  port: "{{ env.PORT }}"
  log_level: 2

tools:
  cache:
    enabled: true
    ttl: 300

build:
  out: release
  clean_dir: true

CLI

Configuration

Root

Full schema

Field reference

Environment variable substitution

JSON Schema

Examples

​Full schema

​Field reference

​Environment variable substitution

​JSON Schema

​Examples

Full schema

Field reference

Environment variable substitution

JSON Schema

Examples