$schema: https://json-schema.org/draft/2020-12/schema
title: Facet frontmatter
type: object
properties:
  name:
    description: Display name of the facet.
    type: string
  polytoken:
    anyOf:
    - const: true
    - $ref: '#/$defs/FacetPolytokenFrontMatter'
required:
- name
$defs:
  FacetPolytokenFrontMatter:
    description: Polytoken-specific facet controls.
    type: object
    properties:
      model:
        description: Model this facet uses, overriding the session default.
        type:
        - string
        - 'null'
      autonomous_hint:
        description: Hint text Polytoken shows when suggesting this facet for autonomous use.
        type:
        - string
        - 'null'
      auto_facet_hint:
        description: Backwards-compatible alias of `autonomous_hint`.
        type:
        - string
        - 'null'
      compaction_hint:
        description: |-
          Guidance Polytoken uses when summarizing the conversation during
          compaction. When set, this text helps the summarization preserve the
          context most relevant to this facet's purpose, so the compacted
          summary retains what matters for the facet's work.
        type:
        - string
        - 'null'
      color:
        description: Accent color for the facet, used in the sidebar and indicators.
        type:
        - string
        - 'null'
      color_light:
        description: Accent color for the facet on light backgrounds.
        type:
        - string
        - 'null'
      color_dark:
        description: Accent color for the facet on dark backgrounds.
        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 facet exposes, as tool names or `tag!` groups (for example
          `tag!ALL`).
        type:
        - array
        - 'null'
        items:
          type: string
      tools_deny:
        description: Tools to exclude after `tools` expands. Applied last.
        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
      facet_transitions:
        description: |-
          Rules for switching to other facets from this one, keyed by target facet
          name.
        type:
        - object
        - 'null'
        additionalProperties:
          $ref: '#/$defs/FacetTransitionFrontMatter'
      skills_allow:
        description: Skills this facet 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
  FacetTransitionFrontMatter:
    type: object
    properties:
      allowed:
        description: Whether switching to the target facet is permitted.
        type: boolean
      condition:
        description: |-
          Condition that must hold for the switch. Omit for an unconditional
          switch.
        type:
        - string
        - 'null'
    required:
    - allowed