Complete field reference for declarative agent definition files.
Each app/agents/*/config.terse defines one declarative agent exposed at /agent/{name}.
Full schema
app/agents/support/config.terse
name: supportdescription: '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.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Hyperterse","description":"Agentic server framework: declarative agents, MCP tools, prompts, and resources with adapters, auth, caching, and observability.","colors":{"primary":"#0D4A36","light":"#86efac","dark":"#0D4A36"},"logo":{"light":"https://mintcdn.com/hyperterse/rDBPaAB64_vAuGMi/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=rDBPaAB64_vAuGMi\u0026q=85\u0026s=a4c182ba8d2ca7518a3482252f5a3d99","dark":"https://mintcdn.com/hyperterse/rDBPaAB64_vAuGMi/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=rDBPaAB64_vAuGMi\u0026q=85\u0026s=9c66f6d0b81a354b5dec122096d4bad4"},"favicon":"https://mintcdn.com/hyperterse/rDBPaAB64_vAuGMi/assets/favicon.svg?fit=max\u0026auto=format\u0026n=rDBPaAB64_vAuGMi\u0026q=85\u0026s=a995d4fd8a97908f0991301c7d037937","footer":{"socials":{"x":"https://x.com/hyperterse","github":"https://github.com/hyperterse/hyperterse","bluesky":"https://bsky.app/profile/hyperterse.com"}},"seo":{"metatags":{"og:title":"Hyperterse — Agentic server framework.","twitter:title":"Hyperterse — Agentic server framework.","og:description":"One build for agents, tools, prompts, resources, data planes, auth, cache, and telemetry—MCP and A2A from a single engine.","twitter:description":"One build for agents, tools, prompts, resources, data planes, auth, cache, and telemetry—MCP and A2A from a single engine.","og:image":"assets/og.png"}},"icons":{"library":"tabler"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hyperterse","hasAudioNarration":false,"actualSubdomain":"hyperterse","customDomains":["docs.hyperterse.com"],"gitSource":{"type":"github","owner":"hyperterse","repo":"hyperterse","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae9479b062df11037fb51c6:success","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Guides","count":38},{"language":"default","tag":"Deployment","count":11},{"language":"default","tag":"Reference","count":9},{"language":"default","tag":"Configuration","count":8},{"language":"default","tag":"Providers","count":7},{"language":"default","tag":"Agents","count":5},{"language":"default","tag":"Databases","count":5},{"language":"default","tag":"Runtime","count":5},{"language":"default","tag":"Tools","count":3},{"language":"default","tag":"Methods","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/agent-config","slug":"/reference/agent-config","pageMetadata":{"title":"Agent","description":"Complete field reference for declarative agent definition files.","href":"/reference/agent-config"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Complete field reference for declarative agent definition files.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Each `,_jsx(_components.code,{children:`app/agents/*/config.terse`}),` defines one declarative agent exposed at `,_jsx(_components.code,{children:`/agent/{name}`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`full-schema`,children:`Full schema`}),`\n`,_jsx(CodeBlock,{filename:`app/agents/support/config.terse`,numberOfLines:`11`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`support`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`description`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Support assistant'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`instruction`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Resolve user support requests and call tools when needed.'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`model`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` provider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`openai_compatible`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` model`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`gpt-4o-mini`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` options`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` base_url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.openai.com/v1'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` api_key`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{{ env.OPENAI_API_KEY }}'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`tool_access`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`inherit`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`field-reference`,children:`Field reference`}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsxs(_components.p,{children:[`Agent name. Must be unique across all discovered agents and match\n`,_jsx(_components.code,{children:`^[a-z][a-z0-9_-]*$`}),`.`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Optional agent summary used in app listings and diagnostics.`})}),`\n`,_jsx(ParamField,{body:`instruction`,type:`string`,required:true,id:`param-instruction`,children:_jsx(_components.p,{children:`Primary system instruction passed to the model runtime.`})}),`\n`,_jsxs(ParamField,{body:`model`,type:`object`,required:true,id:`param-model`,children:[_jsx(_components.p,{children:`Model provider configuration for this agent.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`provider`,type:`string`,required:true,id:`param-provider`,children:[_jsx(_components.p,{children:`Model provider identifier.`}),_jsx(_components.p,{children:`Supported values:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`gemini`}),`, `,_jsx(_components.code,{children:`google_ai_studio`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`vertex`}),`, `,_jsx(_components.code,{children:`vertex_ai`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`openai_compatible`}),`, `,_jsx(_components.code,{children:`openai`})]}),`\n`]}),_jsxs(_components.p,{children:[`Provider names are normalized when the agent loads (lowercased, `,_jsx(_components.code,{children:`-`}),` converted to `,_jsx(_components.code,{children:`_`}),`).`]})]}),_jsx(ParamField,{body:`model`,type:`string`,required:true,id:`param-model-1`,children:_jsx(_components.p,{children:`Provider-specific model name.`})}),_jsxs(ParamField,{body:`options`,type:`object`,id:`param-options`,children:[_jsx(_components.p,{children:`Provider-specific options map.`}),_jsxs(_components.p,{children:[`In config, option values may be scalar (`,_jsx(_components.code,{children:`string`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`boolean`}),`). At\nbuild time, values are stringified for use by the agent.`]}),_jsxs(_components.p,{children:[`Model option values support `,_jsx(_components.code,{children:`{{ env.VAR_NAME }}`}),` substitution when the agent\nmodel starts. Missing variables fail startup.`]}),_jsxs(_components.p,{children:[`For secrets, use provider default env vars (for example `,_jsx(_components.code,{children:`OPENAI_API_KEY`}),`,\n`,_jsx(_components.code,{children:`GOOGLE_API_KEY`}),`) or `,_jsx(_components.code,{children:`api_key: \"{{ env.YOUR_SECRET_VAR }}\"`}),`.`]}),_jsxs(_components.p,{children:[`For provider-specific keys and env fallbacks, see\n`,_jsx(_components.a,{href:`/agents/model-providers`,children:`Model providers`}),`.`]})]})]})]}),`\n`,_jsxs(ParamField,{body:`tool_access`,type:`object`,id:`param-tool-access`,children:[_jsxs(_components.p,{children:[`Tool access policy for this agent. Optional — defaults to `,_jsx(_components.code,{children:`inherit`}),` when omitted,\nwhich uses the root-level defaults from `,_jsx(_components.code,{children:`.hyperterse`}),` (`,_jsx(_components.code,{children:`agents.tool_access`}),`).\nIf no root-level default is set either, the effective mode is `,_jsx(_components.code,{children:`allow_all`}),`.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`mode`,type:`string`,default:`inherit`,id:`param-mode`,children:[_jsx(_components.p,{children:`One of:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`inherit`}),` — use root-level defaults from `,_jsx(_components.code,{children:`.hyperterse`}),` (`,_jsx(_components.code,{children:`agents.tool_access`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allow_all`}),` — agent can call every discovered tool.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allow_none`}),` — agent cannot call any project tools.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allow_list`}),` — agent can call only the listed tools.`]}),`\n`]})]}),_jsx(ParamField,{body:`tools`,type:`string[]`,id:`param-tools`,children:_jsxs(_components.p,{children:[`Required when `,_jsx(_components.code,{children:`mode=allow_list`}),`. Every tool name must exist in the project.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`json-schema`,children:`JSON Schema`}),`\n`,_jsxs(_components.p,{children:[`Editor validation: `,_jsx(_components.code,{children:`schema/agent.terse.schema.json`}),`. Associate with\n`,_jsx(_components.code,{children:`**/agents/**/config.terse`}),`. See `,_jsx(_components.a,{href:`/reference/configuration-schemas`,children:`Configuration schemas`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent","description":"Complete field reference for declarative agent definition files.","href":"/reference/agent-config"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Full schema","slug":"full-schema","depth":2,"children":[]},{"title":"Field reference","slug":"field-reference","depth":2,"children":[]},{"title":"JSON Schema","slug":"json-schema","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"hyperterse","siteName":"Hyperterse","title":"Hyperterse — Agentic server framework.","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-22T06:10:19.852Z","originalFileLocation":"reference/agent-config.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Complete field reference for declarative agent definition files.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hyperterse\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Hyperterse — Agentic server framework.\">\u003cmeta data-mint-head property=\"og:description\" content=\"One build for agents, tools, prompts, resources, data planes, auth, cache, and telemetry—MCP and A2A from a single engine.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Hyperterse\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.hyperterse.com/reference/agent-config\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hyperterse.mintlify.site/assets/og.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Hyperterse — Agentic server framework.\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One build for agents, tools, prompts, resources, data planes, auth, cache, and telemetry—MCP and A2A from a single engine.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hyperterse.mintlify.site/assets/og.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/hyperterse/8Cbzg10P6fb308Jz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Hyperterse\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D4A36\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.hyperterse.com/reference/agent-config\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/agent-config.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.hyperterse.com/#organization\",\"name\":\"Hyperterse\",\"url\":\"https://docs.hyperterse.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hyperterse/rDBPaAB64_vAuGMi/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=rDBPaAB64_vAuGMi\u0026q=85\u0026s=a4c182ba8d2ca7518a3482252f5a3d99\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.hyperterse.com#website\",\"name\":\"Hyperterse\",\"url\":\"https://docs.hyperterse.com\",\"publisher\":{\"@id\":\"https://docs.hyperterse.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.hyperterse.com/reference/agent-config#webpage\",\"url\":\"https://docs.hyperterse.com/reference/agent-config\",\"name\":\"Agent\",\"description\":\"Complete field reference for declarative agent definition files.\",\"dateModified\":\"2026-04-22T06:10:19.852Z\",\"isPartOf\":{\"@id\":\"https://docs.hyperterse.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.hyperterse.com/reference/agent-config#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.hyperterse.com/reference/agent-config#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://docs.hyperterse.com/reference/root-config\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent\",\"item\":\"https://docs.hyperterse.com/reference/agent-config\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.hyperterse.com/reference/agent-config#article\",\"headline\":\"Agent\",\"name\":\"Agent\",\"description\":\"Complete field reference for declarative agent definition files.\",\"url\":\"https://docs.hyperterse.com/reference/agent-config\",\"mainEntityOfPage\":{\"@id\":\"https://docs.hyperterse.com/reference/agent-config#webpage\"},\"image\":\"https://docs.hyperterse.com/assets/og.png\",\"dateModified\":\"2026-04-22T06:10:19.852Z\",\"publisher\":{\"@id\":\"https://docs.hyperterse.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.hyperterse.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Hyperterse\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Hyperterse\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/agent-config.md","siteName":"Hyperterse","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Reference","icon":"terminal","groups":[{"group":"CLI","icon":"terminal","pages":[{"title":"Command line reference","href":"/reference/cli"}]},{"group":"Configuration","icon":"braces","pages":[{"title":"Root","href":"/reference/root-config"},{"title":"Adapter","href":"/reference/adapter-config"},{"title":"Tool","description":"Complete field reference for tool definition files.","href":"/reference/tool-config"},{"title":"Agent","href":"/reference/agent-config"},{"title":"Prompt","description":"Complete field reference for prompt definition files.","href":"/reference/prompt-config"},{"title":"Resource","href":"/reference/resource-config"},{"title":"Environment variables","href":"/reference/environment-variables"},{"title":"Configuration schemas","href":"/reference/configuration-schemas"}]}]}]},"basePath":"","title":"Hyperterse — Agentic server framework.","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}