TAI42 — the OS for AI tools

Generated from tai config settings-schema — do not edit by hand; regenerate with scripts/generate-settings-reference.py.

Every registered settings group and the environment variables it reads — 265 entries across 51 groups (256 variables and 9 nested-group references). Each variable row lists the variable, its type, its default, the TAI_DEFAULT_* variable it falls back to when set (a — for every field that is not a shared connection identity), whether it is required, its reload class (how a live settings-profile apply treats a change to it — hot re-reads in place, recycle rebuilds the pooled resource behind it, excluded needs a full restart), and a description where one exists; each nested-group reference row carries no variable of its own and links to that sub-group’s section instead. Values shown are code-level defaults; a running server resolves each variable from the environment, then any stored override, then this default.

AccessControlRedisSettings

Module tai42_skeleton.access_control.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`ACCESS_CONTROL_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`ACCESS_CONTROL_REDIS_MAX_CONNECTIONS`	`integer`	`10`	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`ACCESS_CONTROL_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`ACCESS_CONTROL_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`ACCESS_CONTROL_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`ACCESS_CONTROL_RETRY_ON_TIMEOUT`	`boolean`	`true`	—	Optional	`hot`	—
`ACCESS_CONTROL_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

AccessControlSettings

Module tai42_skeleton.access_control.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`ACCESS_CONTROL_ENABLE`	`boolean`	`true`	—	Optional	`hot`	—
`ACCESS_CONTROL_AUTH_PROVIDERS`	`array`	`["redis"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_ADMIN`	`string`	—	—	Optional	`hot`	—
—	`object`	—	—	Optional	—	Grouped settings — see AccessControlRedisSettings.
`ACCESS_CONTROL_CACHE_SIZE`	`integer`	`5000`	—	Optional	`hot`	—
`ACCESS_CONTROL_CACHE_TTL_SECONDS`	`integer`	`60`	—	Optional	`hot`	—
`ACCESS_CONTROL_KEY_PREFIX`	`string`	`"ac:key:"`	—	Optional	`hot`	—
`ACCESS_CONTROL_CONTEXT_PREFIX`	`string`	`"ac:context:"`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_TOKEN`	`string`	—	—	Optional	`hot`	Secret.
`ACCESS_CONTROL_BOOTSTRAP_OPEN`	`boolean`	`false`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_TOKEN_KEY`	`string`	`"ac:bootstrap:token"`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_LOCK_KEY`	`string`	`"ac:bootstrap:lock"`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_LOCK_TTL_SECONDS`	`integer`	`10`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_THROTTLE_FAIL_PREFIX`	`string`	`"ac:bootstrap:fail:"`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_THROTTLE_LOCK_PREFIX`	`string`	`"ac:bootstrap:throttle:"`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_THROTTLE_THRESHOLD`	`integer`	`5`	—	Optional	`hot`	—
`ACCESS_CONTROL_BOOTSTRAP_THROTTLE_CAP_SECONDS`	`integer`	`900`	—	Optional	`hot`	—
`ACCESS_CONTROL_CLAIM_PREFIX`	`string`	`"ac:claim:"`	—	Optional	`hot`	—
`ACCESS_CONTROL_CLAIM_LINK_TTL_SECONDS`	`integer`	`600`	—	Optional	`hot`	—
`ACCESS_CONTROL_CLAIM_LINK_MAX_TTL_SECONDS`	`integer`	`3600`	—	Optional	`hot`	—
`ACCESS_CONTROL_POLICY_VERSION_KEY`	`string`	`"ac:policy_version"`	—	Optional	`hot`	—
`ACCESS_CONTROL_PUBLIC_RESOURCE_ID`	`string`	`"public"`	—	Optional	`hot`	—
`ACCESS_CONTROL_RESERVED_PUBLIC_PIN_PREFIXES`	`array`	`["/api/auth"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_ALWAYS_PUBLIC_PATH_PREFIXES`	`array`	`["/api/login"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_AUTHENTICATED_ALWAYS_ALLOWED_PATHS`	`array`	`["/api/auth/me"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_SPA_SHELL_PUBLIC`	`boolean`	`true`	—	Optional	`hot`	—
`ACCESS_CONTROL_RESERVED_OPERATIONAL_SUPPLEMENT`	`array`	`["/openapi.json"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_ACKNOWLEDGED_PUBLIC_ROUTES`	`array`	`["/health", "/ready", "/universal_webhook/{topic}", "/trigger/{token}", "/{spa_path:path}"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_ALWAYS_PUBLIC_ROUTE_PATTERNS`	`array`	`["/api/plugins/[^/]+/studio/.+"]`	—	Optional	`hot`	—
`ACCESS_CONTROL_PATH_PATTERNS`	`object`	`{}`	—	Optional	`hot`	—
`ACCESS_CONTROL_COMPILED_PATTERNS`	`array`	`[]`	—	Optional	`hot`	—
`ACCESS_CONTROL_COMPILED_ALWAYS_PUBLIC_ROUTE_PATTERNS`	`array`	`[]`	—	Optional	`hot`	—

AppArgsSettings

Module tai42_skeleton.settings.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`APP_ARGS_TRANSPORT`	`string`	`"http"`	—	Optional	`excluded`	—
`APP_ARGS_HOST`	`string`	`"127.0.0.1"`	—	Optional	`excluded`	—
`APP_ARGS_PORT`	`integer`	`8000`	—	Optional	`excluded`	—
`APP_ARGS_UDS`	`string`	—	—	Optional	`excluded`	—
`APP_ARGS_TIMEOUT_GRACEFUL_SHUTDOWN`	`integer`	`10`	—	Optional	`recycle`	—

AuditLogSettings

Module tai42_skeleton.settings.audit_log.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_AUDIT_LOG_ENABLE`	`boolean`	`true`	—	Optional	`hot`	—

BodyLimitSettings

Module tai42_skeleton.settings.body_limit.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_BODY_LIMIT_MAX_BODY_BYTES`	`integer`	`10485760`	—	Optional	`hot`	—

BusRedisSettings

Module tai42_skeleton.app.bus_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_BUS_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`recycle`	—
`TAI_BUS_REDIS_MAX_CONNECTIONS`	`integer`	—	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`recycle`	—
`TAI_BUS_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`recycle`	—
`TAI_BUS_SOCKET_TIMEOUT`	`number`	—	—	Optional	`recycle`	—
`TAI_BUS_SOCKET_CONNECT_TIMEOUT`	`number`	—	—	Optional	`recycle`	—
`TAI_BUS_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`recycle`	—
`TAI_BUS_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`recycle`	—

BusSettings

Module tai42_skeleton.app.bus_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see BusRedisSettings.
`TAI_BUS_NAMESPACE`	`string`	`"tai"`	—	Optional	`recycle`	—
`TAI_BUS_ACK_TIMEOUT`	`number`	`2.0`	—	Optional	`recycle`	—
`TAI_BUS_APPLY_TIMEOUT`	`number`	`30.0`	—	Optional	`recycle`	—
`TAI_BUS_HEARTBEAT_TTL`	`number`	`15.0`	—	Optional	`recycle`	—

ClientTrustSettings

Module tai42_kit.utils.client_address.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_RATE_LIMIT_TRUSTED_PROXIES`	`array`	`[]`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_TRUSTED_HOPS`	`integer`	`0`	—	Optional	`hot`	—

ConfigModeSettings

Module tai42_skeleton.config.config_mode.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_CONFIG_MODE`	`string`	`"file"`	—	Optional	`excluded`	—
`TAI_CONFIG_DIR_PATH`	`string`	—	—	Optional	`excluded`	—

ConnectorAdapterSettings

Module tai42_skeleton.connectors.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONNECTORS_META_TOKEN_KEY`	`string`	`"tai_hub.access_token"`	—	Optional	`hot`	—
`CONNECTORS_ERROR_PREFIX`	`string`	`"tai-hub-err:"`	—	Optional	`hot`	—

ConnectorCryptoSecrets

Module tai42_skeleton.connectors.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONNECTORS_KEK`	`string`	—	—	Optional	`hot`	Secret. Key material — refused in a settings profile; rotate through its own path.
`CONNECTORS_KEK_PREVIOUS`	`string`	—	—	Optional	`hot`	Secret. Key material — refused in a settings profile; rotate through its own path.
`CONNECTORS_STATE_HMAC_KEY`	`string`	—	—	Optional	`hot`	Secret. Key material — refused in a settings profile; rotate through its own path.

ConnectorEngineConfig

Module tai42_skeleton.connectors.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONNECTORS_MAX_SESSION_TTL`	`string`	—	—	Optional	`hot`	—
`CONNECTORS_REDIRECT_URI_ALLOWLIST`	`string`	`""`	—	Optional	`hot`	—
`CONNECTORS_OAUTH_BRIDGE_URL`	`string`	—	—	Optional	`hot`	—

ConnectorStoreRedisSettings

Module tai42_skeleton.connectors.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONNECTOR_STORE_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`CONNECTOR_STORE_REDIS_MAX_CONNECTIONS`	`integer`	`10`	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`CONNECTOR_STORE_DECODE_RESPONSES`	`boolean`	`false`	—	Optional	`hot`	—
`CONNECTOR_STORE_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`CONNECTOR_STORE_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`CONNECTOR_STORE_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`CONNECTOR_STORE_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

ConnectorStoreSettings

Module tai42_skeleton.connectors.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see ConnectorStoreRedisSettings.
`CONNECTOR_STORE_KEY_PREFIX`	`string`	`"connectors:"`	—	Optional	`hot`	—

ContextEditingSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONTEXT_EDITING_TRIGGER_TOKENS`	`integer`	`100000`	—	Optional	`hot`	—
`CONTEXT_EDITING_KEEP_TOOL_RESULTS`	`integer`	`3`	—	Optional	`hot`	—
`CONTEXT_EDITING_CLEAR_AT_LEAST`	`integer`	`0`	—	Optional	`hot`	—
`CONTEXT_EDITING_CLEAR_TOOL_INPUTS`	`boolean`	`false`	—	Optional	`hot`	—
`CONTEXT_EDITING_EXCLUDE_TOOLS`	`array`	`[]`	—	Optional	`hot`	—

ContextOverflowSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONTEXT_OVERFLOW_METHODS`	`array`	`["trimming"]`	—	Optional	`hot`	—

ConversationsRedisSettings

Module tai42_skeleton.conversations.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`CONVERSATIONS_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`CONVERSATIONS_REDIS_MAX_CONNECTIONS`	`integer`	—	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`CONVERSATIONS_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`CONVERSATIONS_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`CONVERSATIONS_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`CONVERSATIONS_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`CONVERSATIONS_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

ConversationsSettings

Module tai42_skeleton.conversations.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see ConversationsRedisSettings.
`CONVERSATIONS_PREFIX`	`string`	`"conversations"`	—	Optional	`hot`	—
`CONVERSATIONS_MAX_CONCURRENT_TURNS`	`integer`	`10`	—	Optional	`hot`	—
`CONVERSATIONS_THREAD_QUEUE_DEPTH`	`integer`	`20`	—	Optional	`hot`	—
`CONVERSATIONS_PER_ADDRESS_TURNS_PER_HOUR`	`integer`	`20`	—	Optional	`hot`	—
`CONVERSATIONS_ADDRESS_BUCKET_MAX_ENTRIES`	`integer`	`50000`	—	Optional	`hot`	—
`CONVERSATIONS_SYNC_WAIT_MAX_SECONDS`	`integer`	`120`	—	Optional	`hot`	—
`CONVERSATIONS_INTAKE_CLAIM_LEASE_SECONDS`	`integer`	`120`	—	Optional	`hot`	—
`CONVERSATIONS_INTAKE_CLAIM_REFRESH_SECONDS`	`integer`	`30`	—	Optional	`hot`	—
`CONVERSATIONS_THREAD_LEASE_SECONDS`	`integer`	`120`	—	Optional	`hot`	—
`CONVERSATIONS_THREAD_LEASE_REFRESH_SECONDS`	`integer`	`30`	—	Optional	`hot`	—
`CONVERSATIONS_THREAD_LEASE_POLL_SECONDS`	`number`	`0.5`	—	Optional	`hot`	—
`CONVERSATIONS_SYNC_DOOR_WAIT_SECONDS`	`number`	`30`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_MAX_ATTEMPTS`	`integer`	`8`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_BACKOFF_BASE_SECONDS`	`number`	`60`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_BACKOFF_MAX_SECONDS`	`number`	`900`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_CLAIM_LEASE_SECONDS`	`integer`	`120`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_SEND_TIMEOUT_SECONDS`	`number`	`60`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_CALLBACK_TIMEOUT_SECONDS`	`number`	`15`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_SWEEP_INTERVAL_SECONDS`	`integer`	`60`	—	Optional	`hot`	—
`CONVERSATIONS_DELIVERY_GRACE_SECONDS`	`integer`	`3600`	—	Optional	`hot`	—
`CONVERSATIONS_MAX_MESSAGE_CHARS`	`object`	`{"twilio": 1600, "telegram": 4096, "slack": 40000, "whatsapp": 4096, "web": 8000}`	—	Optional	`hot`	—
`CONVERSATIONS_MAX_OUTBOUND_CHUNKS`	`integer`	`10`	—	Optional	`hot`	—
`CONVERSATIONS_INBOUND_DEDUPE_TTL_SECONDS`	`integer`	`172800`	—	Optional	`hot`	—
`CONVERSATIONS_ANSWER_RETENTION_TTL_SECONDS`	`integer`	`2592000`	—	Optional	`hot`	—
`CONVERSATIONS_PAIR_CODE_TTL_SECONDS`	`integer`	`900`	—	Optional	`hot`	—
`CONVERSATIONS_REDEEM_BACKOFF_THRESHOLD`	`integer`	`5`	—	Optional	`hot`	—
`CONVERSATIONS_REDEEM_BACKOFF_CAP_SECONDS`	`integer`	`900`	—	Optional	`hot`	—

CoreSettings

Module tai42_skeleton.settings.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_MANIFEST_PATH`	`string`	—	—	Optional	`excluded`	—
`TAI_MCP_BACKEND`	`string`	—	—	Optional	`recycle`	—
`TAI_MCP_TEMPLATE`	`string`	—	—	Optional	`recycle`	—
`TAI_MCP_SANDBOX`	`string`	—	—	Optional	`recycle`	—
`TAI_MCP_SANDBOX_EGRESS`	`string`	`"egress"`	—	Optional	`recycle`	—
`TAI_MCP_SANDBOX_ISOLATION`	`string`	`"container"`	—	Optional	`recycle`	—
`TAI_MCP_SANDBOX_SCRUB_TRANSCRIPT`	`boolean`	`false`	—	Optional	`recycle`	—
`TAI_MCP_SANDBOX_DURABLE`	`boolean`	`true`	—	Optional	`recycle`	—
`TAI_MCP_MCP_PROBE_TIMEOUT`	`number`	`15.0`	—	Optional	`hot`	—
`TAI_MCP_MCP_RELOAD_PROBE_TIMEOUT`	`number`	`3.0`	—	Optional	`hot`	—
`TAI_MCP_MCP_REPROBE_INITIAL_SECONDS`	`number`	`30.0`	—	Optional	`hot`	—
`TAI_MCP_MCP_REPROBE_MAX_SECONDS`	`number`	`600.0`	—	Optional	`hot`	—

EmbeddingSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`EMBEDDING_MODEL`	`string`	`"text-embedding-3-small"`	—	Optional	`hot`	—
`EMBEDDING_BASE_URL`	`string`	—	—	Optional	`hot`	—
`EMBEDDING_API_KEY`	`string`	—	—	Optional	`hot`	Secret.
`EMBEDDING_API_VERSION`	`string`	—	—	Optional	`hot`	—
`EMBEDDING_TIMEOUT`	`integer`	—	—	Optional	`hot`	—
`EMBEDDING_USER_AGENT`	`string`	—	—	Optional	`hot`	—
`EMBEDDING_TASK`	`string`	—	—	Optional	`hot`	—
`EMBEDDING_MODEL_KWARGS`	`object`	—	—	Optional	`hot`	—

EnvSecretMarksSettings

Module tai42_skeleton.settings.env_secret_marks.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_ENV_SECRET_KEYS`	`array`	`[]`	—	Optional	`hot`	—

FileLoadingSettings

Module tai42_skeleton.template.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`FILE_LOADING_MAX_BYTES`	`integer`	`26214400`	—	Optional	`hot`	—

HooksRedisSettings

Module tai42_skeleton.hooks.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`HOOKS_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`HOOKS_REDIS_MAX_CONNECTIONS`	`integer`	—	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`HOOKS_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`HOOKS_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`HOOKS_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`HOOKS_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`HOOKS_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

HooksSettings

Module tai42_skeleton.hooks.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see HooksRedisSettings.
`HOOKS_MAX_WORKERS`	`integer`	`10`	—	Optional	`hot`	—
`HOOKS_PREFIX`	`string`	`"hooks"`	—	Optional	`hot`	—

InteractionsRedisSettings

Module tai42_skeleton.interactions.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`INTERACTIONS_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`INTERACTIONS_REDIS_MAX_CONNECTIONS`	`integer`	`10`	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`INTERACTIONS_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`INTERACTIONS_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`INTERACTIONS_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`INTERACTIONS_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`INTERACTIONS_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

InteractionsSettings

Module tai42_skeleton.interactions.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see InteractionsRedisSettings.
`INTERACTIONS_KEY_PREFIX`	`string`	`"interactions:"`	—	Optional	`hot`	—
`INTERACTIONS_NOTIFICATIONS_FEED_MAX`	`integer`	`1000`	—	Optional	`hot`	—
`INTERACTIONS_NOTIFICATIONS_FEED_TTL_SECONDS`	`integer`	`2592000`	—	Optional	`hot`	—
`INTERACTIONS_ANSWER_TIMEOUT_SECONDS`	`integer`	`3600`	—	Optional	`hot`	—
`INTERACTIONS_IDLE_TTL_SECONDS`	`integer`	`86400`	—	Optional	`hot`	—
`INTERACTIONS_SEND_RECEIPT_INDEX_TTL_SECONDS`	`integer`	`86400`	—	Optional	`hot`	—
`INTERACTIONS_PUBLIC_BASE_URL`	`string`	—	—	Optional	`hot`	—
`INTERACTIONS_CALLBACK_MAX_BODY_BYTES`	`integer`	`65536`	—	Optional	`hot`	—
`INTERACTIONS_MAX_CONCURRENT`	`integer`	`1000`	—	Optional	`hot`	—
`INTERACTIONS_DELIVERY_MAX_ATTEMPTS`	`integer`	`3`	—	Optional	`hot`	—
`INTERACTIONS_DELIVERY_RETRY_BACKOFF_SECONDS`	`number`	`1.0`	—	Optional	`hot`	—
`INTERACTIONS_BLOCKING_GRACE_SECONDS`	`number`	`5`	—	Optional	`hot`	—
`INTERACTIONS_EXPIRY_REAPER_INTERVAL_SECONDS`	`number`	`30`	—	Optional	`hot`	—

JqSettings

Module tai42_kit.utils.data.jq_util.

Env var	Type	Default	Fallback	Required	Reload	Description
`JQ_TIMEOUT_SECONDS`	`number`	`10`	—	Optional	`hot`	—

LLMProviderSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`LLM_PROVIDER_LLM`	`string`	`"openai"`	—	Optional	`hot`	—
`LLM_PROVIDER_EMBEDDING`	`string`	`"openai"`	—	Optional	`hot`	—
`LLM_PROVIDER_CHECKPOINT`	`string`	`"redis"`	—	Optional	`hot`	—
`LLM_PROVIDER_CHECKPOINT_CONN_STRING`	`string`	—	—	Optional	`hot`	—
`LLM_PROVIDER_CHECKPOINT_TTL_MINUTES`	`integer`	—	—	Optional	`hot`	—
`LLM_PROVIDER_STORE`	`string`	`"redis"`	—	Optional	`hot`	—
`LLM_PROVIDER_STORE_CONN_STRING`	`string`	—	—	Optional	`hot`	—

LLMSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`LLM_MODEL`	`string`	`"gpt-4o"`	—	Optional	`hot`	—
`LLM_TEMPERATURE`	`number`	—	—	Optional	`hot`	—
`LLM_MAX_TOKENS`	`integer`	—	—	Optional	`hot`	—
`LLM_TIMEOUT`	`integer`	—	—	Optional	`hot`	—
`LLM_BASE_URL`	`string`	—	—	Optional	`hot`	—
`LLM_API_KEY`	`string`	—	—	Optional	`hot`	Secret.
`LLM_API_VERSION`	`string`	—	—	Optional	`hot`	—
`LLM_TOP_P`	`number`	—	—	Optional	`hot`	—
`LLM_TOP_K`	`integer`	—	—	Optional	`hot`	—
`LLM_N`	`integer`	—	—	Optional	`hot`	—

LoggingSettings

Module tai42_kit.logging.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_LOG_LEVEL`	`string`	`"INFO"`	—	Optional	`hot`	—

MCPClientSettings

Module tai42_kit.clients.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`MCP_CLIENT_CONNECT_TIMEOUT_SECONDS`	`number`	`30`	—	Optional	`hot`	—
`MCP_CLIENT_CALL_TIMEOUT_SECONDS`	`number`	`300`	—	Optional	`hot`	—

MCPDispatchSettings

Module tai42_skeleton.settings.mcp_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_MCP_CALL_TIMEOUT_SECONDS`	`number`	`300`	—	Optional	`hot`	—
`TAI_MCP_SCHEMA_MAX_DEPTH`	`integer`	`50`	—	Optional	`hot`	—

MarketplaceSettings

Module tai42_skeleton.marketplace.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`MARKETPLACE_URL`	`string`	`"https://marketplace.tai42.ai"`	—	Optional	`hot`	—
`MARKETPLACE_ADVISORIES_POLL`	`boolean`	`true`	—	Optional	`hot`	—
`MARKETPLACE_ADVISORIES_INTERVAL_S`	`integer`	`3600`	—	Optional	`hot`	—
`MARKETPLACE_REQUEST_TIMEOUT_S`	`number`	`15`	—	Optional	`hot`	—

MetricsSettings

Module tai42_skeleton.routers.metrics_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`BACKEND_METRICS_HOST`	`string`	`"127.0.0.1"`	—	Optional	`excluded`	—
`BACKEND_METRICS_PORT`	`integer`	`8012`	—	Optional	`excluded`	—
`PROMETHEUS_MULTIPROC_DIR`	`string`	`"/tmp/tai42_prometheus"`	—	Optional	`excluded`	—

PluginPrefixSettings

Module tai42_skeleton.marketplace.prefix.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_PLUGINS_PREFIX`	`string`	—	—	Optional	`excluded`	—

PluginsSettings

Module tai42_skeleton.plugins.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`STUDIO_DIST_PATH`	`string`	—	—	Optional	`hot`	—

RateLimitRedisSettings

Module tai42_skeleton.settings.rate_limit.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_RATE_LIMIT_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`TAI_RATE_LIMIT_REDIS_MAX_CONNECTIONS`	`integer`	`10`	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`TAI_RATE_LIMIT_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

RateLimitSettings

Module tai42_skeleton.settings.rate_limit.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see RateLimitRedisSettings.
`TAI_RATE_LIMIT_KEY_PREFIX`	`string`	`"ratelimit:"`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_DEFAULT_ENABLED`	`boolean`	`true`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_DEFAULT_LIMIT`	`integer`	`600`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_DEFAULT_BURST`	`integer`	`120`	—	Optional	`hot`	—
`TAI_RATE_LIMIT_FAMILIES`	`object`	`{}`	—	Optional	`hot`	—

RunIndexSettings

Module tai42_skeleton.runs.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_RUNS_INDEX_RETENTION_DAYS`	`integer`	—	—	Optional	`hot`	—
`TAI_RUNS_INDEX_MAX_PAGE_SIZE`	`integer`	`200`	—	Optional	`hot`	—

SamplingSettings

Module tai42_skeleton.tools.sampling_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_SAMPLING_MAX_TOKENS_PER_CALL`	`integer`	`32768`	—	Optional	`hot`	—
`TAI_SAMPLING_MAX_CALLS_PER_INVOCATION`	`integer`	`20`	—	Optional	`hot`	—

StatesSettings

Module tai42_skeleton.states.db.

Env var	Type	Default	Fallback	Required	Reload	Description
`STATES_OP_RETENTION_DAYS`	`integer`	`30`	—	Optional	`hot`	—
`STATES_DEFAULT_RETENTION_DAYS`	`integer`	—	—	Optional	`hot`	—

SubMcpRedisSettings

Module tai42_skeleton.sub_mcp.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`SUB_MCP_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`SUB_MCP_REDIS_MAX_CONNECTIONS`	`integer`	—	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`SUB_MCP_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`SUB_MCP_SOCKET_TIMEOUT`	`number`	—	—	Optional	`hot`	—
`SUB_MCP_SOCKET_CONNECT_TIMEOUT`	`number`	—	—	Optional	`hot`	—
`SUB_MCP_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`SUB_MCP_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

SubMcpSettings

Module tai42_skeleton.sub_mcp.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see SubMcpRedisSettings.
`SUB_MCP_PREFIX`	`string`	`"sub_mcp"`	—	Optional	`hot`	—

SummarizationMiddlewareSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`SUMMARIZATION_MIDDLEWARE_TRIGGER_TOKENS`	`integer`	`5000`	—	Optional	`hot`	—
`SUMMARIZATION_MIDDLEWARE_KEEP_MESSAGES`	`integer`	`20`	—	Optional	`hot`	—
`SUMMARIZATION_MIDDLEWARE_TRIM_TOKENS_TO_SUMMARIZE`	`integer`	`4000`	—	Optional	`hot`	—
`SUMMARIZATION_MIDDLEWARE_SUMMARY_PROMPT`	`object`	—	—	Optional	`hot`	—

TemplateCacheSettings

Module tai42_skeleton.template.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TEMPLATE_CACHE_TTL`	`integer`	`300`	—	Optional	`hot`	—
`TEMPLATE_CACHE_MAX_SIZE`	`integer`	`256`	—	Optional	`hot`	—

ToolRunsRedisSettings

Module tai42_skeleton.routers.tool_runs_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_TOOL_RUNS_REDIS_URL`	`string`	—	`TAI_DEFAULT_REDIS_URL`	Optional	`hot`	—
`TAI_TOOL_RUNS_REDIS_MAX_CONNECTIONS`	`integer`	`10`	`TAI_DEFAULT_REDIS_MAX_CONNECTIONS`	Optional	`hot`	—
`TAI_TOOL_RUNS_DECODE_RESPONSES`	`boolean`	`true`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_SOCKET_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_SOCKET_CONNECT_TIMEOUT`	`number`	`5`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_RETRY_ON_TIMEOUT`	`boolean`	`false`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_RETRY_ATTEMPTS`	`integer`	`0`	—	Optional	`hot`	—

ToolRunsSettings

Module tai42_skeleton.routers.tool_runs_settings.

Env var	Type	Default	Fallback	Required	Reload	Description
—	`object`	—	—	Optional	—	Grouped settings — see ToolRunsRedisSettings.
`TAI_TOOL_RUNS_KEY_PREFIX`	`string`	`"tool_runs:"`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_RECENT_RUNS_LIMIT`	`integer`	`50`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_RESULT_TTL_SECONDS`	`integer`	`86400`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_LIVENESS_TTL_SECONDS`	`integer`	`30`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_MAX_CONCURRENT_RUNS`	`integer`	`32`	—	Optional	`hot`	—
`TAI_TOOL_RUNS_SHUTDOWN_DRAIN_SECONDS`	`number`	`10`	—	Optional	`hot`	—

TrimmingMiddlewareSettings

Module tai42_kit.llm.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`TRIMMING_MIDDLEWARE_STRATEGY`	`string`	`"last"`	—	Optional	`hot`	—
`TRIMMING_MIDDLEWARE_MAX_TOKENS`	`integer`	`5000`	—	Optional	`hot`	—
`TRIMMING_MIDDLEWARE_INCLUDE_SYSTEM`	`boolean`	`true`	—	Optional	`hot`	—
`TRIMMING_MIDDLEWARE_ALLOW_PARTIAL`	`boolean`	`false`	—	Optional	`hot`	—
`TRIMMING_MIDDLEWARE_END_ON`	`string`	—	—	Optional	`hot`	—
`TRIMMING_MIDDLEWARE_START_ON`	`string`	—	—	Optional	`hot`	—

TurnSettings

Module tai42_skeleton.settings.turn.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_TURN_TIMEOUT_SECONDS`	`number`	—	—	Optional	`hot`	Wall-clock budget in seconds for one synchronous turn; unset = unbounded. On expiry the turn is cancelled with a typed turn-exceeded error; a turn killed while parked on an unanswered question names that question in the error.

UrlGuardSettings

Module tai42_kit.net.url_guard.

Env var	Type	Default	Fallback	Required	Reload	Description
`TAI_URL_GUARD_ENABLED`	`boolean`	`true`	—	Optional	`hot`	—
`TAI_URL_GUARD_ALLOW_CIDRS`	`array`	`[]`	—	Optional	`hot`	—
`TAI_URL_GUARD_MAX_RESPONSE_BYTES`	`integer`	`104857600`	—	Optional	`hot`	—
`TAI_URL_GUARD_MAX_REDIRECTS`	`integer`	`20`	—	Optional	`hot`	—

WebhookIngressSettings

Module tai42_skeleton.webhooks.settings.

Env var	Type	Default	Fallback	Required	Reload	Description
`WEBHOOK_INGRESS_MAX_BODY_BYTES`	`integer`	`65536`	—	Optional	`hot`	—

​AccessControlRedisSettings

​AccessControlSettings

​AppArgsSettings

​AuditLogSettings

​BodyLimitSettings

​BusRedisSettings

​BusSettings

​ClientTrustSettings

​ConfigModeSettings

​ConnectorAdapterSettings

​ConnectorCryptoSecrets

​ConnectorEngineConfig

​ConnectorStoreRedisSettings

​ConnectorStoreSettings

​ContextEditingSettings

​ContextOverflowSettings

​ConversationsRedisSettings

​ConversationsSettings

​CoreSettings

​EmbeddingSettings

​EnvSecretMarksSettings

​FileLoadingSettings

​HooksRedisSettings

​HooksSettings

​InteractionsRedisSettings

​InteractionsSettings

​JqSettings

​LLMProviderSettings

​LLMSettings

​LoggingSettings

​MCPClientSettings

​MCPDispatchSettings

​MarketplaceSettings

​MetricsSettings

​PluginPrefixSettings

​PluginsSettings

​RateLimitRedisSettings

​RateLimitSettings

​RunIndexSettings

​SamplingSettings

​StatesSettings

​SubMcpRedisSettings

​SubMcpSettings

​SummarizationMiddlewareSettings

​TemplateCacheSettings

​ToolRunsRedisSettings

​ToolRunsSettings

​TrimmingMiddlewareSettings

​TurnSettings

​UrlGuardSettings

​WebhookIngressSettings

AccessControlRedisSettings

AccessControlSettings

AppArgsSettings

AuditLogSettings

BodyLimitSettings

BusRedisSettings

BusSettings

ClientTrustSettings

ConfigModeSettings

ConnectorAdapterSettings

ConnectorCryptoSecrets

ConnectorEngineConfig

ConnectorStoreRedisSettings

ConnectorStoreSettings

ContextEditingSettings

ContextOverflowSettings

ConversationsRedisSettings

ConversationsSettings

CoreSettings

EmbeddingSettings

EnvSecretMarksSettings

FileLoadingSettings

HooksRedisSettings

HooksSettings

InteractionsRedisSettings

InteractionsSettings

JqSettings

LLMProviderSettings

LLMSettings

LoggingSettings

MCPClientSettings

MCPDispatchSettings

MarketplaceSettings

MetricsSettings

PluginPrefixSettings

PluginsSettings

RateLimitRedisSettings

RateLimitSettings

RunIndexSettings

SamplingSettings

StatesSettings

SubMcpRedisSettings

SubMcpSettings

SummarizationMiddlewareSettings

TemplateCacheSettings

ToolRunsRedisSettings

ToolRunsSettings

TrimmingMiddlewareSettings

TurnSettings

UrlGuardSettings

WebhookIngressSettings