agent-afk 5.286.2 → 5.287.1

package/dist/config/env.auth.d.ts

@@ -0,0 +1,141 @@
+export declare const AUTH_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_SYSTEM_PROMPT";
+    readonly description: "Raw operator-overlay prompt. Highest-priority overlay (over afk.config.json and AFK.md). Appended on top of the framework base (system-prompt.md) under an \"# Operator configuration\" header — it augments, never replaces, the base.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "You are a helpful agent.";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_DUMP_PROMPT";
+    readonly description: "Write the resolved system prompt to a file at startup. Accepts a path or 1 for default location.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "/tmp/afk-prompt.txt";
+    readonly category: "debug";
+}, {
+    readonly name: "ANTHROPIC_API_KEY";
+    readonly description: "Anthropic API key. Tier-1 credential — overrides keychain OAuth and CLAUDE_CODE_OAUTH_TOKEN.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "CLAUDE_CODE_OAUTH_TOKEN";
+    readonly description: "Claude Code OAuth token. Tier-2 credential — used when ANTHROPIC_API_KEY is unset; falls back to keychain.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "OPENAI_API_KEY";
+    readonly description: "OpenAI API key for the openai-compatible provider (gpt-*, o1*, o3*, o4* models).";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "CODEX_API_KEY";
+    readonly description: "Fallback OpenAI API key for the openai-compatible provider, read after OPENAI_API_KEY. Legacy name from the removed @openai/codex-sdk integration — prefer OPENAI_API_KEY.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "XAI_API_KEY";
+    readonly description: "xAI API key for the xai provider (Grok models) in API-key mode. Metered; distinct from SuperGrok / SuperGrok Heavy / X Premium+ OAuth.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_XAI_BASE_URL";
+    readonly description: "Base URL for xAI API-key mode. Default https://api.x.ai/v1. The OpenAI SDK appends /chat/completions.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "https://api.x.ai/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_XAI_OAUTH_BASE_URL";
+    readonly description: "Base URL for xAI SuperGrok / SuperGrok Heavy / X Premium+ OAuth inference. Default https://cli-chat-proxy.grok.com/v1 (subscription path). Some accounts work on https://api.x.ai/v1 with OAuth — override if needed. Distinct from AFK_XAI_BASE_URL (API-key mode).";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "https://cli-chat-proxy.grok.com/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_XAI_GROK_CLIENT_VERSION";
+    readonly description: "Override the semver sent as x-grok-client-version to the xAI OAuth CLI chat proxy. Use only if the proxy raises its required Grok CLI version before agent-afk is updated; invalid values fall back to the official Grok Build version file or built-in compatible default.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "1.0.6";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_LOCAL_API_KEY";
+    readonly description: "Placeholder API key for local Anthropic-compatible servers (vllm-mlx, etc.). Set when AFK_LOCAL_BASE_URL is configured.";
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "local";
+    readonly example: "local";
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_LOCAL_BASE_URL";
+    readonly description: "Base URL for a self-hosted Anthropic-compatible server. When set, routes traffic away from api.anthropic.com.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://127.0.0.1:8080";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_OPENAI_BASE_URL";
+    readonly description: "Base URL override for the OpenAI-compatible provider. Used for local shims (mlx_lm.server, Ollama, vLLM, LM Studio). The OpenAI SDK appends `/chat/completions` itself — a value ending in `/chat/completions` will be stripped at config-load time with a one-shot warning.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://127.0.0.1:8000/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_OPENAI_USE_RESPONSES";
+    readonly description: "Opt the OpenAI-compatible provider into the OpenAI Responses API instead of Chat Completions for API-key sessions. Truthy values: 1, true, yes, on. The ChatGPT-subscription OAuth path uses Responses automatically regardless of this flag.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_OPENAI_CHATGPT_OAUTH";
+    readonly description: "Use ChatGPT-subscription OAuth credentials from ~/.codex/auth.json (auth_mode: chatgpt) as OpenAI provider auth. Off by default. Set to 1/true/yes/on to enable. READ-ONLY: AFK never refreshes these tokens — re-run codex when the access token expires. Routes requests over the Responses API to the private ChatGPT backend (chatgpt.com/backend-api).";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_PROVIDER";
+    readonly description: "Force provider selection (anthropic | anthropic-direct | openai | openai-compatible | openai-codex | xai | xai-oauth). Overrides the model-name heuristic. Same surface as the --provider CLI flag; CLI flag wins when both are set.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "openai-compatible";
+    readonly category: "model";
+}, {
+    readonly name: "EXA_API_KEY";
+    readonly description: "Exa (exa.ai) search API key, enabling web_scrape search mode. Free tier (20k requests/month) available at https://exa.ai. When unset, search mode returns an actionable error; markdown and raw modes are unaffected.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_IMAGE_API_KEY";
+    readonly description: "Dedicated OpenAI API key for the image_generate tool. Checked before OPENAI_API_KEY to keep image billing separate from chat completions. When unset, OPENAI_API_KEY is used as a fallback. Get a key from https://platform.openai.com/api-keys.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "auth";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_IMAGE_SESSION_LIMIT";
+    readonly description: "Maximum number of images the image_generate tool may produce per session. Prevents runaway spend in autonomous loops. Default: 10.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_IMAGE_ALLOW_DAEMON";
+    readonly description: "Set to \"1\" to allow image_generate in daemon/cron sessions. Blocked by default to prevent unattended API spend.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "misc";
+}];

package/dist/config/env.d.ts

@@ -633,13 +633,6 @@ export declare const ENV_REGISTRY: readonly [{
     readonly required: false;
     readonly example: "true";
     readonly category: "telegram";
-}, {
-    readonly name: "TMUX";
-    readonly description: string;
-    readonly type: "string";
-    readonly required: false;
-    readonly example: "/tmp/tmux-501/default,12345,0";
-    readonly category: "process";
 }, {
     readonly name: "AFK_TELEGRAM_TRACE";
     readonly description: "Set to 1 to dump raw bridge traffic between the agent and the Telegram bot — debugging only.";
@@ -661,6 +654,36 @@ export declare const ENV_REGISTRY: readonly [{
     readonly default: "14400000";
     readonly example: "3600000";
     readonly category: "telegram";
+}, {
+    readonly name: "TMUX";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "/tmp/tmux-501/default,12345,0";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_PEER_INBOUND";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "accept";
+    readonly example: "hold";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_PEER_POLL_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "1000";
+    readonly example: "2000";
+    readonly category: "misc";
+}, {
+    readonly name: "TMUX_PANE";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "%0";
+    readonly category: "process";
 }, {
     readonly name: "CODEX_HOME";
     readonly description: "Codex configuration, plugin, and skill directory used for imports. Defaults to ~/.codex.";
@@ -855,20 +878,6 @@ export declare const ENV_REGISTRY: readonly [{
     readonly type: "string";
     readonly required: false;
     readonly category: "worktree";
-}, {
-    readonly name: "AFK_MCP_HEALTHCHECK";
-    readonly description: string;
-    readonly type: "boolean";
-    readonly required: false;
-    readonly example: "1";
-    readonly category: "mcp";
-}, {
-    readonly name: "AFK_ALLOW_PROJECT_MCP";
-    readonly description: "Opt-in to loading + spawning MCP servers declared in <cwd>/.mcp.json. Fail-closed: when unset (or 0), project-local servers are NOT spawned; set to a truthy value (1/true/yes/on) to load them. A project-local .mcp.json spawns arbitrary commands on session start, so it is off by default to prevent code execution when entering an untrusted repo (issue #571). Skipped servers are listed in a startup warning with the opt-in instruction.";
-    readonly type: "boolean";
-    readonly required: false;
-    readonly example: "1";
-    readonly category: "mcp";
 }, {
     readonly name: "AFK_AUTO_ROUTING";
     readonly description: "Auto-route bare slash inputs to matching skills. Applies to interactive, chat, telegram, and daemon surfaces.";
@@ -915,6 +924,20 @@ export declare const ENV_REGISTRY: readonly [{
     readonly default: "7";
     readonly example: "10";
     readonly category: "misc";
+}, {
+    readonly name: "AFK_MCP_HEALTHCHECK";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "mcp";
+}, {
+    readonly name: "AFK_ALLOW_PROJECT_MCP";
+    readonly description: "Opt-in to loading + spawning MCP servers declared in <cwd>/.mcp.json. Fail-closed: when unset (or 0), project-local servers are NOT spawned; set to a truthy value (1/true/yes/on) to load them. A project-local .mcp.json spawns arbitrary commands on session start, so it is off by default to prevent code execution when entering an untrusted repo (issue #571). Skipped servers are listed in a startup warning with the opt-in instruction.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "mcp";
 }, {
     readonly name: "AFK_BANNER_PLAIN";
     readonly description: "Suppress the ANSI-colored banner at REPL startup. Useful for non-TTY captures and CI logs.";
@@ -1012,6 +1035,20 @@ export declare const ENV_REGISTRY: readonly [{
     readonly default: "dark";
     readonly example: "light";
     readonly category: "misc";
+}, {
+    readonly name: "COLORFGBG";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "15;0";
+    readonly category: "process";
+}, {
+    readonly name: "COLORTERM";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "truecolor";
+    readonly category: "process";
 }, {
     readonly name: "AFK_TEXT_MEASURE";
     readonly description: string;
@@ -1044,20 +1081,6 @@ export declare const ENV_REGISTRY: readonly [{
     readonly default: "";
     readonly example: "1";
     readonly category: "display";
-}, {
-    readonly name: "COLORFGBG";
-    readonly description: string;
-    readonly type: "string";
-    readonly required: false;
-    readonly example: "15;0";
-    readonly category: "process";
-}, {
-    readonly name: "COLORTERM";
-    readonly description: string;
-    readonly type: "string";
-    readonly required: false;
-    readonly example: "truecolor";
-    readonly category: "process";
 }, {
     readonly name: "AFK_DEBUG";
     readonly description: "Enable verbose debug logging across the codebase. Accepts 1 to enable.";
@@ -1150,20 +1173,6 @@ export declare const ENV_REGISTRY: readonly [{
     readonly default: "0";
     readonly example: "1";
     readonly category: "misc";
-}, {
-    readonly name: "AFK_MESSAGE_JOURNAL_DISABLED";
-    readonly description: string;
-    readonly type: "boolean";
-    readonly required: false;
-    readonly example: "1";
-    readonly category: "debug";
-}, {
-    readonly name: "AFK_SESSION_LEDGER_DISABLED";
-    readonly description: string;
-    readonly type: "boolean";
-    readonly required: false;
-    readonly example: "1";
-    readonly category: "debug";
 }, {
     readonly name: "AFK_RUN_RECEIPT_DISABLED";
     readonly description: string;
@@ -1233,6 +1242,20 @@ export declare const ENV_REGISTRY: readonly [{
     readonly type: "boolean";
     readonly required: false;
     readonly category: "process";
+}, {
+    readonly name: "AFK_MESSAGE_JOURNAL_DISABLED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_SESSION_LEDGER_DISABLED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
 }, {
     readonly name: "AFK_BROWSER_HEADLESS";
     readonly description: string;

package/dist/config/env.daemon.d.ts

@@ -0,0 +1,166 @@
+export declare const DAEMON_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_DAEMON_CWD";
+    readonly description: "Working directory used by the daemon process for spawned agent sessions.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_DAEMON_TASK";
+    readonly description: "Default task description for the daemon. Falls back to afk.config.json daemon.task.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_DAEMON_TASK_ID";
+    readonly description: "Task identifier the daemon uses to scope its state directory and telemetry.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_DAEMON_HOST";
+    readonly description: "Bind address for the daemon control HTTP surface. Defaults to 127.0.0.1 (loopback only). The control surface is unauthenticated, so bind a non-loopback address such as 0.0.0.0 only on a trusted or firewalled network. Overridden by the --host flag.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_SESSIONSTART_COOLDOWN_MS";
+    readonly description: "Cooldown in milliseconds between SessionStart trigger fires in the daemon. Prevents thundering-herd on rapid restarts.";
+    readonly type: "number";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_DAEMON_SHELL_TIMEOUT_MS";
+    readonly description: "Wall-clock timeout in milliseconds for executor:shell scheduled tasks. Defaults to 2700000 (45 minutes), matching the agent executor budget (AFK_SUBAGENT_TIMEOUT_MS). The child process is killed on timeout; the telemetry errorMessage will read \"daemon shell timeout after NNNs\" to distinguish a daemon-imposed kill from a process or network failure.";
+    readonly type: "number";
+    readonly required: false;
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_WEB_PORT";
+    readonly description: "Port for the `afk web` browser surface. Defaults to 4141; falls back to an ephemeral port when taken. Overridden by --port.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "4141";
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_WEB_HOST";
+    readonly description: "Bind address for the `afk web` browser surface. Defaults to 127.0.0.1. Unlike the daemon control surface, a non-loopback bind is REFUSED unless AFK_WEB_TOKEN (or --token) is also set, because this surface can submit prompts and approve tool use. Overridden by --host.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "127.0.0.1";
+    readonly category: "daemon";
+}, {
+    readonly name: "AFK_WEB_TOKEN";
+    readonly description: "Bearer token for the `afk web` surface. When unset, a random per-run token is minted and printed in the startup URL. Setting this explicitly is also what permits a non-loopback bind.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "daemon";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_WORKTREE_AUTONAME";
+    readonly description: "Auto-rename worktree branches based on the first user message in interactive mode. 1 = on (default), 0 = off.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_BRANCH_PREFIX";
+    readonly description: "Branch-name prefix for AFK-managed worktrees. Default afk/. Set to empty string to drop the prefix.";
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "afk/";
+    readonly example: "wt/";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_BASE";
+    readonly description: "Override the base git ref for worktrees created with --worktree. By default AFK bases worktrees on the remote's default branch (e.g. origin/main), fetched fresh. Set this to pin a different ref, or to HEAD to base on the local checkout. Overridden per-session by --worktree-base.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "origin/main";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_ON_EXIT";
+    readonly description: "Clean-worktree quit policy for interactive --worktree sessions: ask, keep, or remove.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "ask";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_BOOT_PRUNE";
+    readonly description: "When set, the daemon prunes stale worktrees at boot in addition to the cron-driven sweep.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_PRUNE_DISABLE";
+    readonly description: "Disable the worktree prune job entirely. Useful for long-running tests.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_MAX_AGE_CLEAN";
+    readonly description: "Maximum age (in days) before a clean worktree is auto-pruned. Default 14.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "14";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_MAX_AGE_DIRTY";
+    readonly description: "Maximum age (in days) before a dirty worktree is auto-pruned. Default 30.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "30";
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_WORKTREE_SWEEP_ROOT";
+    readonly description: "Override the root directory under which AFK worktrees are tracked for pruning.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "worktree";
+}, {
+    readonly name: "AFK_AUTO_ROUTING";
+    readonly description: "Auto-route bare slash inputs to matching skills. Applies to interactive, chat, telegram, and daemon surfaces.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "true";
+    readonly category: "routing";
+}, {
+    readonly name: "AFK_INTERNAL";
+    readonly description: "Tier gate. Set to exactly `1` to unlock — only the literal string \"1\" unlocks (other truthy values like \"true\"/\"yes\" leave the tier locked). When unlocked, skills tagged `audience: 'internal'` (e.g. /audit-fit, harvest/distill plugins) become visible at end-user surfaces (slash-command list, --help, tab-complete, system-prompt skill manifest). Default unset = public tier — internal skills are hidden. Not an access-control boundary; it gates surfacing, not the underlying registry.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "routing";
+}, {
+    readonly name: "AFK_SHELL_PASSTHROUGH";
+    readonly description: "Enable the interactive REPL `!cmd` / `!&cmd` shell-passthrough feature. On by default. Set to 0, false, off, or no (case-insensitive) to disable, so inputs beginning with ! are sent to the model as literal text instead of being executed as shell commands. Equivalent to the --no-shell-passthrough flag.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_BG_AUTO_DELIVER";
+    readonly description: "Auto-deliver background subagent results into the model context on the next user turn (interactive REPL). On by default. Set to 0, false, off, or no (case-insensitive) to disable, restoring the manual /bgsub:join retrieval flow.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_BASH_PREVIEW_HEAD_LINES";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "3";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_BASH_PREVIEW_TAIL_LINES";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "7";
+    readonly example: "10";
+    readonly category: "misc";
+}];

package/dist/config/env.debug.d.ts

@@ -0,0 +1,162 @@
+export declare const DEBUG_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_DEBUG";
+    readonly description: "Enable verbose debug logging across the codebase. Accepts 1 to enable.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_DEBUG_CLIPBOARD";
+    readonly description: "Debug bracketed-paste and image-paste handling in the interactive REPL.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_DEBUG_COMPOSITOR";
+    readonly description: "Gate compositor phase-boundary traces to stderr; any truthy value enables.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_TRACE_DISABLED";
+    readonly description: "Disable the agent trace subsystem entirely. Set to 1 to skip trace file writes.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_WITNESS_RETENTION_DISABLE";
+    readonly description: "Disable the witness-tree retention sweep entirely, so no session directory is ever evicted.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_WITNESS_MAX_AGE_DAYS";
+    readonly description: "Evict a witness session directory once its newest content is older than this many days. Default 30.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "30";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_WITNESS_MAX_BYTES";
+    readonly description: "Aggregate byte cap for the witness tree; oldest session directories are evicted first once exceeded. Default 2147483648 (2 GiB).";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "2147483648";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_SESSION_RETENTION_DISABLE";
+    readonly description: "Disable the session sidecar retention sweep entirely, so no state/sessions/*.json file is ever evicted.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_SESSION_MAX_AGE_DAYS";
+    readonly description: "Evict a session sidecar file once it is older than this many days (based on savedAt). Default 30.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "30";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_SESSION_MAX_COUNT";
+    readonly description: "Count-based safety valve: evict oldest session sidecars first once the total exceeds this number. Default 1000.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "1000";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_WAVE_MANIFEST_DISABLED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_WAVE_MANIFEST_TTL_HOURS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "48";
+    readonly example: "24";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_WAVE_RESUME_UNATTENDED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_RUN_RECEIPT_DISABLED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_SUBAGENT_RESULT_CAP_BYTES";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "32768";
+    readonly example: "16384";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUBAGENT_LOG";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "DEBUG";
+    readonly description: "Standard Node `debug`-package convention. When set to 1, enables verbose logging in several modules alongside AFK_DEBUG.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "debug";
+}, {
+    readonly name: "AGENT_AFK_ASCII";
+    readonly description: "Force the interactive REPL tool-lane renderer to ASCII-only glyphs instead of the default Unicode box-drawing set. Accepts 1/true/yes (case-insensitive). Useful for terminals whose font lacks ┃├╰├ glyphs.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AGENT_SURFACE";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "afk";
+    readonly example: "afk";
+    readonly category: "process";
+}, {
+    readonly name: "CI";
+    readonly description: "Standard CI-detection convention. Auto-set by GitHub Actions, CircleCI, etc. Used to switch off TTY-only UX.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "true";
+    readonly category: "process";
+}, {
+    readonly name: "NODE_ENV";
+    readonly description: "Standard Node environment marker. test | development | production. Used by routing-telemetry.ts to suppress test-time writes.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "production";
+    readonly category: "process";
+}, {
+    readonly name: "VITEST";
+    readonly description: "Set automatically by Vitest. Used at runtime to short-circuit code paths that should not fire in tests.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "NO_UPDATE_NOTIFIER";
+    readonly description: "Disable the update-available notifier on CLI startup. Standard convention shared with many Node CLIs.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "process";
+}];