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

name

string

required

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

version

string

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

root

string

default:"app"

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

tools

object

Tool discovery and global tool cache defaults.

Show properties

directory

string

default:"tools"

Tools directory relative to root.

cache

object

Global cache defaults for DB-backed tools.

Show properties

enabled

boolean

default:"false"

Enable in-memory tool result caching globally.

ttl

integer

default:"120"

Default TTL in seconds for cached tool results.

object

Global search defaults for MCP search results.

Show properties

limit

integer

default:"10"

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

adapters

object

Adapter discovery settings.

Show properties

directory

string

default:"adapters"

Adapters directory relative to root.

prompts

object | array

Prompt configuration:

Show object mode (discovery)

directory

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

resources

object | array

Resource configuration:

Show object mode (discovery)

directory

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

resource_templates

array

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

agents

object

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

Show properties

directory

string

default:"agents"

Agents directory relative to root.

tool_access

object

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

Show properties

mode

string

default:"allow_none"

One of allow_all, allow_none, allow_list.

tools

string[]

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

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

server

object

Server runtime settings.

Show properties

port

integer | string

default:"8080"

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

log_level

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

build

object

Build output settings.

Show properties

out

string

default:"dist"

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

clean_dir

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