# Optional GitHub token for higher GitHub API throughput during discovery and GitHub-backed mirror acquisition.
# Prefer a least-privileged token with public repository read access only.
GITHUB_PERSONAL_ACCESS_TOKEN=
# GITHUB_TOKEN=
# Override the ARD publisher FQDN used for identity and attestation metadata.
# AGENT_HARNESS_ARD_PUBLISHER_FQDN=

# Optional AI-assisted enrichment and bounded recommendation AI review.
# Disabled unless URL and API key are both set.
# Use an OpenAI-compatible chat completions endpoint.
# AGENT_HARNESS_AI_ENRICHMENT_MODE controls automatic enrichment behavior:
# off | manual | after-select | after-workspace | on-ambiguity | on-input-change | ci-only
# AGENT_HARNESS_AI_ENRICHMENT_ALLOWED_ORIGINS extends the built-in public-provider allowlist.
# The configured AGENT_HARNESS_AI_ENRICHMENT_URL origin is also auto-allowed when it is a valid https origin.
AGENT_HARNESS_AI_ENRICHMENT_URL=
AGENT_HARNESS_AI_ENRICHMENT_API_KEY=
AGENT_HARNESS_AI_ENRICHMENT_MODE=manual
AGENT_HARNESS_AI_ENRICHMENT_MODEL=gpt-4o-mini
AGENT_HARNESS_AI_ENRICHMENT_ALLOWED_ORIGINS=
AGENT_HARNESS_AI_ENRICHMENT_TIMEOUT_MS=20000
AGENT_HARNESS_AI_ENRICHMENT_MAX_RESPONSE_BYTES=1000000
# Preferred names for AI enrichment input caps. These only bound the optional AI request payload.
AGENT_HARNESS_AI_ENRICHMENT_MAX_INPUT_CAPABILITIES_PER_ASSET=16
AGENT_HARNESS_AI_ENRICHMENT_MAX_INPUT_EVIDENCE_ITEMS=12
AGENT_HARNESS_AI_ENRICHMENT_MAX_INPUT_SELECTED_ASSETS=50
# Backward-compatible aliases still accepted:
# AGENT_HARNESS_AI_ENRICHMENT_MAX_SELECTED_ASSETS=50
# AGENT_HARNESS_AI_ENRICHMENT_MAX_EVIDENCE_ITEMS=12
# AGENT_HARNESS_AI_ENRICHMENT_MAX_CAPABILITIES_PER_ASSET=16
AGENT_HARNESS_AI_ENRICHMENT_REDACT_FILE_PATHS=false
AGENT_HARNESS_AI_ENRICHMENT_REDACT_SOURCE_IDS=false
AGENT_HARNESS_AI_ENRICHMENT_RETRY_MAX_ATTEMPTS=1
AGENT_HARNESS_AI_ENRICHMENT_RETRY_BACKOFF_MS=1000
AGENT_HARNESS_AI_ENRICHMENT_AUTO_MIN_INTERVAL_MS=300000
AGENT_HARNESS_AI_ENRICHMENT_REQUIRE_SUCCESS_IN_CI=false
AGENT_HARNESS_AI_ENRICHMENT_ALLOW_CACHE_IN_CI=true

# Shared HTTP safeguards.
AGENT_HARNESS_HTTP_TIMEOUT_MS=10000
AGENT_HARNESS_HTTP_MAX_RESPONSE_BYTES=1000000

# GitHub REST API version, retries, and response budgets.
AGENT_HARNESS_GITHUB_FETCH_RETRIES=3
AGENT_HARNESS_GITHUB_FETCH_TIMEOUT_MS=10000
AGENT_HARNESS_GITHUB_JSON_MAX_BYTES=2000000
GITHUB_API_VERSION=2022-11-28

# Registry/discovery fetch budgets.
AGENT_HARNESS_REGISTRY_FETCH_TIMEOUT_MS=5000
AGENT_HARNESS_REGISTRY_METADATA_MAX_BYTES=2000000
AGENT_HARNESS_REGISTRY_SEARCH_MAX_BYTES=500000
AGENT_HARNESS_REFERENCE_SOURCE_MAX_BYTES=600000
AGENT_HARNESS_OFFICIAL_INDEX_PAGE_MAX_BYTES=1000000
AGENT_HARNESS_OFFICIAL_INDEX_CONTENT_MAX_BYTES=1000000

# Discovery recall caps.
AGENT_HARNESS_GENERIC_REFERENCE_MAX_ITEMS=8
AGENT_HARNESS_VSCODE_MARKETPLACE_MAX_QUERIES=4
AGENT_HARNESS_VSCODE_MARKETPLACE_MAX_ITEMS_PER_QUERY=6
AGENT_HARNESS_VSCODE_MARKETPLACE_SYNC_PAGE_SIZE=50
AGENT_HARNESS_SOURCE_SYNC_MAX_PAGES_PER_RUN=10
AGENT_HARNESS_NPM_SEARCH_RESULT_LIMIT=12
AGENT_HARNESS_NPM_MCP_SEARCH_QUERY_LIMIT=8

# Discovery demand and adjacent-tooling controls.
AGENT_HARNESS_DISCOVERY_ADJACENT_TOOLING_ENABLED=true
AGENT_HARNESS_DISCOVERY_REGISTRY_SEARCH_MAX_TERMS=10
AGENT_HARNESS_DISCOVERY_REGISTRY_SEARCH_MAX_RESULTS_PER_TERM=50
AGENT_HARNESS_DISCOVERY_SEMANTIC_SCORING=false
AGENT_HARNESS_DISCOVERY_MIN_SIMILARITY=0.35
AGENT_HARNESS_OFFICIAL_INDEX_MAX_ITEMS_PER_INDEX=0
AGENT_HARNESS_VSCODE_MARKETPLACE_CATEGORY_SWEEP_ENABLED=true

# Optional per-host final recommendation limits. These override checked-in host policy caps at runtime.
# *_MODE=preserve keeps the default behavior and changes only recommendationLimit.
# Set *_MODE=scale to explicitly scale related host caps and minimums with the limit override.
# AGENT_HARNESS_SHARED_RECOMMENDATION_LIMIT=12
# AGENT_HARNESS_SHARED_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_COPILOT_VSCODE_RECOMMENDATION_LIMIT=240
# AGENT_HARNESS_COPILOT_VSCODE_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_OPENCODE_RECOMMENDATION_LIMIT=80
# AGENT_HARNESS_OPENCODE_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_CURSOR_RECOMMENDATION_LIMIT=240
# AGENT_HARNESS_CURSOR_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_ZED_RECOMMENDATION_LIMIT=80
# AGENT_HARNESS_ZED_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_CLAUDE_CODE_RECOMMENDATION_LIMIT=80
# AGENT_HARNESS_CLAUDE_CODE_RECOMMENDATION_LIMIT_MODE=preserve
# AGENT_HARNESS_PI_RECOMMENDATION_LIMIT=80
# AGENT_HARNESS_PI_RECOMMENDATION_LIMIT_MODE=preserve

# Mirror safety limits.
AGENT_HARNESS_MAX_OFFICIAL_INDEX_PACKAGE_FILES=1000
AGENT_HARNESS_MAX_OFFICIAL_INDEX_FILE_SIZE_BYTES=1000000
AGENT_HARNESS_MAX_OFFICIAL_INDEX_PACKAGE_TOTAL_BYTES=20000000
AGENT_HARNESS_MAX_GITHUB_MIRROR_FILE_SIZE_BYTES=1000000

# Host command budgets.
AGENT_HARNESS_NATIVE_COMMAND_TIMEOUT_MS=30000
AGENT_HARNESS_NATIVE_COMMAND_MAX_BUFFER_BYTES=2000000
AGENT_HARNESS_PREFLIGHT_COMMAND_TIMEOUT_MS=15000
# Cumulative wall-clock budget for `setup doctor` host preflight checks (ms).
# Defaults to the per-adapter timeout plus headroom for worst-case sequential preflights.
# AGENT_HARNESS_SETUP_DOCTOR_TIMEOUT_MS=

# Diagnostic logging.
AGENT_HARNESS_DEBUG=false

# Force CI-mode behavior (ephemeral state-root heuristics, enrichment CI
# semantics) without a real CI runner. A bare CI=true is also recognized as
# CI mode for external CI runners.
# AGENT_HARNESS_CI=true

# Discovery and lifecycle batch sizes.
AGENT_HARNESS_INSTALL_BATCH_SIZE=250
AGENT_HARNESS_MIRROR_BATCH_SIZE=120
AGENT_HARNESS_REMOTE_BATCH_SIZE=15

# Install refresh policy and due-check cadence.
AGENT_HARNESS_INSTALL_REFRESH_INTERVAL_MS=21600000
# manual | report-only | apply-safe
AGENT_HARNESS_INSTALL_REFRESH_POLICY=manual

# Recursive scan budgets used by demand profiling.
AGENT_HARNESS_SCAN_MAX_DEPTH=14
AGENT_HARNESS_SCAN_MAX_FILES=20000
AGENT_HARNESS_SCAN_MAX_BYTES=50000000

# Optional mutable lifecycle state root. Defaults to the repository root when
# developing in this repo and workspace-local .agent-harness/ for packaged CLI use.
AGENT_HARNESS_STATE_ROOT=

# Optional deadline for long-running operations (discover catalog, recommend report).
# Clamped to 10–3,600 seconds. Also settable via --timeout-seconds <n> on the CLI.
AGENT_HARNESS_TIMEOUT_SECONDS=

# Discovery source-sync budgets and caps.
AGENT_HARNESS_SOURCE_SYNC_MAX_PAGES_FOR_INDEX_BUILD=500
AGENT_HARNESS_DISCOVERY_INDEX_MAX_AGE_DAYS=7
AGENT_HARNESS_MAX_ENTRIES_PER_SOURCE=200
AGENT_HARNESS_VSCODE_MARKETPLACE_POPULARITY_SWEEP_PAGES=50

# Per-adapter timeout for setup doctor (ms).
AGENT_HARNESS_SETUP_DOCTOR_HOST_TIMEOUT_MS=5000

# Optional platform path overrides. Most users should leave these unset.
# AGENT_HARNESS_HOME=
# XDG_CONFIG_HOME=
# APPDATA=