YOU

System configuration schema

Reference for the operator and system configuration schema.

This is a reference for the system configuration schema. The config declares operator-wide settings for the factory runtime: default worker models, worker presets, runtime artifact handling, and the backend scope a machine runs against.

It lives at ~/.you-agent-factory/config.json. Create that file with you config init, or open and edit it on disk.

Core configuration

The root object of ~/.you-agent-factory/config.json. Every field below is declared directly on it; the definitions that follow describe the objects it references.

System configuration

object

The shared .you-agent-factory/config.json contract owned by the Operator Settings service.

  • additionalPropertiesfalse (closed)

Examples

  • Operator config defaultsAuthored examplejson
    {
  "defaults": {
    "workerModelProvider": "codex",
    "workerModel": "gpt-5-codex"
  }
}

Fields

  • backendScopeIDOptionalstring

    Stable identifier for the local provider-backed runtime boundary owned by operator_settings.

  • defaultsOptionalobject

    Operator defaults parsed by operator_settings from file before env/flag resolution.

    • additionalPropertiesfalse (closed)
  • runtimeOptionalobject

    Runtime observability settings loaded from operator configuration before command-line overrides.

    • additionalPropertiesfalse (closed)
  • workerPresetsOptionalworkerPreset[]

    Named worker model presets parsed from file only.

Definitions

The objects operator configuration references — worker presets, runtime artifact settings, and the file-ownership rules that govern them.

fieldContract

object
  • additionalPropertiesfalse (closed)

Fields

  • inventoryIdRequiredstring
    • minLength1
  • jsonPathRequiredstring
    • minLength1
  • documentationRequireddocumentation.schema.json(unresolved)Unresolved $ref: /https://schemas.portpowered.com/you/contracts/common/documentation.schema.json is not in the schema catalog.
  • lifecycleRequireddeprecations.schema.json(unresolved)Unresolved $ref: /https://schemas.portpowered.com/you/contracts/common/deprecations.schema.json is not in the schema catalog.
  • precedenceRequiredprecedence.schema.json(unresolved)Unresolved $ref: /https://schemas.portpowered.com/you/contracts/common/precedence.schema.json is not in the schema catalog.
  • sensitivityRequiredsensitivity.schema.json(unresolved)Unresolved $ref: /https://schemas.portpowered.com/you/contracts/common/sensitivity.schema.json is not in the schema catalog.
  • defaultEmptyBehaviorRequiredstring
    • minLength1
  • parseOwnerRequired
    • const"operator_settings"
  • persistenceOwnerRequired
    • enum"none" | "operator_settings"
  • strictnessRequiredstring
    • minLength1
  • notesOptionalstring
    • minLength1

fileOwner

object
  • additionalPropertiesfalse (closed)

Fields

  • packageRequired
    • const"operator_settings"
  • ownsRequiredarray
    • minItems1
  • toleratesOptionalarray
  • doesNotOwnOptionalarray

operatorWorkerModelProvider

string

Required model provider canonicalized to a supported provider after surrounding whitespace is trimmed. Symbolic DEFAULT is rejected in presets.

  • pattern^[\t-\r …   - 

  　]*(?:AGY|ANTHROPIC|CLAUDE|CODEX|GEMINI|KIRO|OPENAI|OPENCODE|PI|agy|anthropic|antigravity|claude|codex|gemini|kiro|kiro-cli|openai|opencode|pi)[\t-\r …   - 

  　]*$

runtimeArtifactSettings

object

Rolling-file storage settings for one runtime observability artifact.

  • additionalPropertiesfalse (closed)

Fields

  • directoryOptionalstring

    Optional artifact root. Omission uses the runtime-owned directory below the operator home.

    • pattern.*\S.*
    • minLength1
  • maxSizeMBOptionalinteger

    Maximum artifact file size in megabytes before rotation.

    Default100
    • minimum1
  • maxBackupsOptionalinteger

    Maximum number of rotated artifact files to retain.

    Default20
    • minimum1
  • maxAgeDaysOptionalinteger

    Maximum age in days for rotated artifact files.

    Default30
    • minimum1
  • compressOptionalboolean

    Whether rotated artifact files are gzip-compressed.

    Defaultfalse

sharedFileSplit

object
  • additionalPropertiesfalse (closed)

Fields

  • summaryRequiredstring
    • minLength1
  • ownersRequiredfileOwner[]
    • minItems1
    • maxItems1

unknownFieldPolicyEntry

object
  • additionalPropertiesfalse (closed)

Fields

  • packageRequired
    • const"operator_settings"
  • policyRequiredstring
    • minLength1

workerPreset

object
  • additionalPropertiesfalse (closed)

Fields

  • idRequiredstring

    Required non-empty preset identifier after trim.

    • pattern.*[^\t-\r …   - 

  　].*
    • minLength1
  • modelProviderRequiredoperatorWorkerModelProvider

    Required non-empty model provider canonicalized to supported providers.

  • modelOptionalstring

    Optional model name trimmed when present.

  • reasoningEffortOptionalstring

    Optional reasoning effort level. Surrounding whitespace and letter case are normalized; an empty value is accepted.

    • pattern^[\t-\r …   - 

  　]*(?:[mM][iI][nN][iI][mM][aA][lL]|[lL][oO][wW]|[mM][eE][dD][iI][uU][mM]|[hH][iI][gG][hH]|[xX][hH][iI][gG][hH]|[mM][aA][xX])?[\t-\r …   - 

  　]*$

On this page

Core configurationYou operator and system configurationDefinitionsfieldContractfileOwneroperatorWorkerModelProviderruntimeArtifactSettingssharedFileSplitunknownFieldPolicyEntryworkerPreset