$schema: https://json-schema.org/draft/2020-12/schema
title: Subagent frontmatter
type: object
properties:
  name:
    description: Display name of the subagent.
    type: string
  description:
    description: Short summary of what the subagent does.
    type:
    - string
    - 'null'
  polytoken:
    anyOf:
    - const: true
    - $ref: '#/$defs/SubagentPolytokenFrontMatter'
required:
- name
$defs:
  SubagentPolytokenFrontMatter:
    description: Polytoken-specific subagent controls.
    type: object
    properties:
      model:
        description: Model this subagent uses, overriding the session default.
        type:
        - string
        - 'null'
      autonomous_hint:
        description: Hint text Polytoken shows when suggesting this subagent.
        type:
        - string
        - 'null'
      auto_facet_hint:
        description: Backwards-compatible alias of `autonomous_hint`.
        type:
        - string
        - 'null'
      fallback_models:
        description: Models Polytoken tries, in order, if the primary model is unavailable.
        type:
        - array
        - 'null'
        items:
          type: string
      tools:
        description: Tools this subagent can use, as tool names or `tag!` groups.
        type:
        - array
        - 'null'
        items:
          type: string
      tools_deny:
        description: Tools to exclude after `tools` expands.
        type:
        - array
        - 'null'
        items:
          type: string
      undeferred_tools:
        description: Tools to always send in full, even under native-deferred tool loading.
        type:
        - array
        - 'null'
        items:
          type: string
      allow_subagent_spawn:
        description: Whether this subagent may spawn its own subagents.
        type:
        - boolean
        - 'null'
      exit_tool_schema:
        description: Custom schema for the subagent's exit tool, replacing the default.
      skills_allow:
        description: Skills this subagent can invoke, as skill names or `tag!` groups.
        type:
        - array
        - 'null'
        items:
          type: string
      skills_deny:
        description: Skills to exclude from `skills_allow`.
        type:
        - array
        - 'null'
        items:
          type: string
      inherit_tools:
        description: |-
          Whether this subagent inherits the caller's tools instead of using
          `tools`.
        type:
        - boolean
        - 'null'