agent-afk 5.286.2 → 5.287.0

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

@@ -0,0 +1,136 @@
+export declare const MISC_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_WRITE_DENYLIST";
+    readonly description: "Comma-separated list of additional path globs that the write_file tool refuses to write to.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "**/.env,**/secrets/**";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_READ_DENYLIST";
+    readonly description: "Colon-separated list of additional absolute paths the read_file/grep/glob/list_directory tools refuse to read, and that the bash-restriction hook refuses to let a shell command reference on interactive surfaces (REPL, Telegram) — on headless surfaces (afk chat, daemon) bash fails open regardless of this list. A leading ~/ is expanded (~user/ is not — spell those absolutely). Built-in credential entries (~/.ssh, ~/.aws, ~/.afk/config, …) always apply on top and cannot be removed. One built-in exception exists: ~/.afk/config/mcp.json (the MCP registry) IS readable — paths listed here outrank that carve-out, so set this to ~/.afk/config/mcp.json if your registry holds inline secrets rather than ${VAR} placeholders.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "/Users/me/project/.env:/Users/me/secrets";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_WRITE_DIFF";
+    readonly description: "Show a diff preview before each write_file tool call. Defaults provider-controlled when unset.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_RATE_LIMIT_ADMISSION_DISABLED";
+    readonly description: "Bypass the process-wide rate-limit admission gate (issue #941). Set to 1 to skip pre-request capacity checks. Default 0 (gate active). OAuth subscription accounts already pass through automatically when no per-minute headers are returned.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_RATE_LIMIT_STAGGER_MAX_MS";
+    readonly description: "Jitter ceiling (ms) for the rate-limit admission bucket: each waiter at a window boundary wakes at reset + random(0..ceiling) to avoid re-storming the API. Default 500. Set to 0 in tests for deterministic timing.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "500";
+    readonly example: "0";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_WEB_ALLOW_PRIVATE_HOSTS";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_DEMO_CLEAN";
+    readonly description: "Explicit opt-in to capture-mode. When set to 1, suppresses high-frequency repaint drivers (spinner ticker, live thinking-preview) so recorded artifacts contain each state once instead of once per timer tick.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "SCRIPT";
+    readonly description: "Set by script(1) on BSD/macOS/Linux to the typescript filename while a terminal session is being recorded. Presence of a non-empty value triggers capture-mode.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "/tmp/typescript";
+    readonly category: "process";
+}, {
+    readonly name: "ASCIINEMA_REC";
+    readonly description: "Set to 1 by asciinema rec while a session is being recorded. Triggers capture-mode.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_SESSION_ID";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "default";
+    readonly example: "session-abc123";
+    readonly category: "browser";
+}, {
+    readonly name: "SHELL";
+    readonly description: "Standard POSIX env var pointing to the user's login shell binary. Used by shell-init and worktree commands to auto-detect the correct shell syntax for emitted wrapper code.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "/bin/zsh";
+    readonly category: "process";
+}, {
+    readonly name: "PAGER";
+    readonly description: "Standard POSIX env var naming the user's preferred pager (with optional flags). Used by /transcript to render the full session in a scrollable viewer; falls back to `less -R` when unset.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "less -R";
+    readonly category: "process";
+}, {
+    readonly name: "VISUAL";
+    readonly description: "Standard POSIX env var naming the user's preferred full-screen editor (with optional flags). Consulted FIRST by the /editor slash command (and its key chord) to compose a long prompt externally; takes precedence over EDITOR. No fallback editor is assumed — if neither VISUAL nor EDITOR is set, /editor prints a hint instead of guessing.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "nvim";
+    readonly category: "process";
+}, {
+    readonly name: "EDITOR";
+    readonly description: "Standard POSIX env var naming the user's preferred editor (with optional flags). Consulted by the /editor slash command AFTER VISUAL, as the standard fallback. No default editor is assumed when both are unset — /editor prints a hint telling the user to set one.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "vim";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_DIFF_LINES";
+    readonly description: "Maximum number of diff lines shown in the inline diff render during write_file tool calls. Set to 0 for no cap. Non-integer values are silently ignored and the default applies.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "50";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_SHELL_WRAPPER";
+    readonly description: "Set to 1 or true by the optional afk shell wrapper function (installed via `afk shell-init`). Signals that the parent shell has the wrapper active so the post-exit cd can fire.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_USER_CARD_MAX_ROWS";
+    readonly description: "Maximum number of visual rows emitted by renderUserCard before collapsing the remainder into a dim \"…(N lines collapsed)\" summary row. Defaults to 24. Non-integer or non-positive values are silently ignored and the default applies.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "24";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_LEASE_TTL_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "600000";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_PREEXISTING_LEDGER_DISABLE";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}];

package/dist/config/env.model-tiers.d.ts

@@ -0,0 +1,230 @@
+export declare const MODEL_TIERS_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_MODEL";
+    readonly description: "Default model for agent turns. Accepts slot names (local, small, medium, large), fixed-identity aliases (opus, sonnet, haiku, fable), or full model IDs. Migration: AFK_MODEL=sonnet now pins the fixed Sonnet identity rather than following a rebound medium tier.";
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "medium";
+    readonly example: "claude-opus-5-5";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_TTFB_TIMEOUT_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "180000";
+    readonly example: "120000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_STALL_TIMEOUT_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "1200000";
+    readonly example: "600000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUBAGENT_TIMEOUT_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "2700000";
+    readonly example: "3600000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUBAGENT_IDLE_TIMEOUT_MS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "480000";
+    readonly example: "300000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_VISION_MODELS";
+    readonly description: "Comma-separated override for image (vision) capability detection on the openai-compatible provider. Each token force-enables a model id by exact or substring match (e.g. \"qwen2.5-vl\" matches a local VL id); prefix a token with \"!\" to force-disable. Use to send images to a local vision-language model AFK does not recognise by name, or to blacklist a mis-detected id. Built-in detection already covers gpt-4o/4.1/5.x, o1/o3/o4-mini, Claude, and common VL families.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "qwen2.5-vl,!gpt-4o-mini";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_LOCAL";
+    readonly description: "Bind the \"local\" capability tier (cheapest/fastest, user-configured) to a model id. Overrides afk.config.json models.local. Point at a local Ollama, LM Studio, or any OpenAI-compatible shim.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "llama3.2:3b";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_LOCAL_API_KEY";
+    readonly description: "Per-slot API key for the \"local\" tier. Overrides global credentials for this tier only.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "model";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_MODEL_LOCAL_BASE_URL";
+    readonly description: "Per-slot endpoint base URL for the \"local\" tier. Anthropic Messages base or OpenAI-compatible base per the tier provider.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://localhost:11434/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_LARGE";
+    readonly description: "Bind the \"large\" capability tier (most capable) to a model id/alias. Overrides afk.config.json models.large.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "claude-opus-5-5";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_LARGE_API_KEY";
+    readonly description: "Per-slot API key for the \"large\" tier (Stage 2). Overrides global credentials for this tier only.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "model";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_MODEL_LARGE_BASE_URL";
+    readonly description: "Per-slot endpoint base URL for the \"large\" tier (Stage 2). Anthropic Messages base or OpenAI-compatible base per the tier provider.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://localhost:8080/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_MEDIUM";
+    readonly description: "Bind the \"medium\" capability tier (general-use) to a model id/alias. Overrides afk.config.json models.medium.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "claude-sonnet-5";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_MEDIUM_API_KEY";
+    readonly description: "Per-slot API key for the \"medium\" tier (Stage 2). Overrides global credentials for this tier only.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "model";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_MODEL_MEDIUM_BASE_URL";
+    readonly description: "Per-slot endpoint base URL for the \"medium\" tier (Stage 2). Anthropic Messages base or OpenAI-compatible base per the tier provider.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://localhost:8080/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_SMALL";
+    readonly description: "Bind the \"small\" capability tier (cheap/fast) to a model id/alias. Overrides afk.config.json models.small.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "gpt-4o-mini";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MODEL_SMALL_API_KEY";
+    readonly description: "Per-slot API key for the \"small\" tier (Stage 2). Overrides global credentials for this tier only.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "model";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_MODEL_SMALL_BASE_URL";
+    readonly description: "Per-slot endpoint base URL for the \"small\" tier (Stage 2). Anthropic Messages base or OpenAI-compatible base per the tier provider.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "http://localhost:8080/v1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_OVERLOAD_PAUSE_MS";
+    readonly description: "Wall-clock ceiling (ms) for the bounded pause after a mid-stream overload (529) exhausts its retry budget. Overrides the per-surface default for ALL surfaces: 0 disables the pause (fail fast). Interactive surfaces (cli/repl/telegram) default to 600000; daemon/cron default to 0 so an always-on runner never silently parks on upstream capacity.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "600000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_PROMPT_CACHE_TTL";
+    readonly description: "TTL for Anthropic prompt-cache blocks. Accepts 5m or 1h.";
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "1h";
+    readonly example: "1h";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUGGEST_ENABLED";
+    readonly description: "Enable the LLM-backed ghost-text suggestion tier in the interactive REPL. On by default. Set to 0/false/no/off to disable.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUGGEST_PROMPT";
+    readonly description: "Enable LLM-generated empty-prompt suggestions — a proposed next action shown as ghost text when the prompt is blank, accepted with Tab or Right-arrow. Fires only after a turn has completed in the session: the startup prompt (and the prompt right after /clear) is left clean because there is no session context to ground a proposal in. On by default. Set to 0/false/no/off to disable. Requires AFK_SUGGEST_ENABLED (it reuses the same suggestion model and provider).";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUGGEST_GHOST";
+    readonly description: "Enable REPL ghost-text inline suggestions (Tier-1 history/dropdown + optional Tier-2 LLM). 1 = on (default), 0 = off. Set 0/false/off/no to disable all ghost text. Tier-2 LLM is separately gated by AFK_SUGGEST_ENABLED.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_SUGGEST_MODEL";
+    readonly description: "Override the small model used for REPL ghost-text suggestions. Falls back to AFK_COMPACT_MODEL or haiku-class for anthropic, or the session model for other providers.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "model";
+}, {
+    readonly name: "AFK_TASK_BUDGET";
+    readonly description: "Per-task token budget ceiling. Aborts when cumulative usage would exceed it.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "100000";
+    readonly example: "200000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_TEMPERATURE";
+    readonly description: "Numeric temperature override for model sampling. Provider default if unset.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "0.7";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_THINKING";
+    readonly description: "Extended-thinking mode. Accepts adaptive | disabled | max | enabled:<N> | enabled:max. Defaults to the model-appropriate mode when unset (adaptive on current models).";
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "adaptive";
+    readonly example: "adaptive";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_THINKING_UI";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "live";
+    readonly example: "digest";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_TIMEOUT_MS";
+    readonly description: "Per-turn timeout in milliseconds. Provider/SDK default if unset.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "120000";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_WORKSPACE_DISABLED";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "model";
+}, {
+    readonly name: "CLAUDE_MODEL";
+    readonly description: "Legacy alias for AFK_MODEL — supported for back-compat with pre-AFK_* deployments.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "sonnet";
+    readonly category: "model";
+}];

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

@@ -0,0 +1,199 @@
+export declare const MODEL_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_COMPACT_KEEP_LAST_TURNS";
+    readonly description: "Number of recent turns the compactor keeps verbatim during /compact. Default tuned in compact-handler.ts.";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "6";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_COMPACT_MODEL";
+    readonly description: "Model id or slot alias used by the /compact summarizer and auto-compaction. Accepts any model on any supported provider (anthropic, openai, xai). Cross-provider compaction is supported: set to a gpt-* id on a Claude session (or a claude-* id on an OpenAI session) and AFK will route the summarize call to that provider using its own credentials. The transcript is sent to the target provider — a one-time privacy warning is emitted on first cross-provider use. Requires that provider's credentials to be available (ANTHROPIC_API_KEY / OPENAI_API_KEY / XAI_API_KEY, or ChatGPT-subscription OAuth via AFK_OPENAI_CHATGPT_OAUTH). Falls back to a cheap haiku-class default when unset. Also drives ghost-text suggestions on Claude sessions (see AFK_SUGGEST_MODEL to override that independently).";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "gpt-6-luna";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_COMPACT_SHRINK_FRACTION";
+    readonly description: "Context-fullness fraction (0–1, exclusive) at/above which /compact and auto-compaction relax the keep-window so a short-but-full session (few turns, huge tool exchanges) can still be summarized instead of no-oping on turn count. Default 0.7 (see shared/compaction.ts DEFAULT_COMPACT_SHRINK_THRESHOLD).";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "0.8";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_DEFAULT_SUBAGENT_MODEL";
+    readonly description: "Override the default model used when a subagent is dispatched without an explicit model.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "sonnet";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_DISABLE_PROMPT_CACHE";
+    readonly description: "Disable Anthropic prompt caching when set to 1/true/yes/on. Unset = caching enabled.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_DISABLE_BASH_INTERPRETER_GUARD";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_DISABLE_PATH_APPROVAL";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_DISABLE_SPINE_UPDATE";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_FORCE_BASH_INTERPRETER_GUARD";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_EFFORT";
+    readonly description: "Effort hint guiding adaptive-thinking depth, forwarded as Anthropic output_config.effort (model-gated; ignored where unsupported). Accepts low | medium | high | xhigh | max.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "medium";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_EVAL_STALENESS_DAYS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "7";
+    readonly example: "14";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_MAX_BUDGET_USD";
+    readonly description: "Opt-in cumulative USD budget ceiling for the session. Aborts the turn when the running cost crosses this. Unset by default (no cap applied).";
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "5.00";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_CONCURRENT_SAFE_TOOL_CALLS";
+    readonly description: "Maximum concurrency-safe tool calls run simultaneously within one dispatcher batch. Default 8; accepted range 1-32; out-of-range or unparseable input falls back to the default.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "8";
+    readonly example: "4";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_MAX_CONCURRENT_SUBAGENT_CALLS";
+    readonly description: "Maximum subagent calls run simultaneously from one compose/DAG layer or skill wave. Default 8; accepted range 1-32; out-of-range or unparseable input falls back to the default.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "8";
+    readonly example: "2";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_MAX_CONCURRENT_BACKGROUND_JOBS";
+    readonly description: "Maximum background subagent jobs running simultaneously in one registry. Default 10; accepted range 1-64; out-of-range or unparseable input falls back to the default.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "10";
+    readonly example: "5";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_MAX_NESTING_DEPTH";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "3";
+    readonly example: "2";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_CONCURRENT_CHILDREN_PER_AGENT";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "4";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_CONCURRENT_AGENTS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "16";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_TOTAL_AGENTS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "48";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_OUTPUT_TOKENS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly example: "8192";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_TOKENS";
+    readonly description: "Deprecated and inert: not read by the generation path. Use AFK_MAX_OUTPUT_TOKENS (or --max-output-tokens) to cap per-response output tokens; falls back to the model output ceiling when unset.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "4096";
+    readonly example: "8192";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MAX_TOOL_USE_ITERATIONS";
+    readonly description: string;
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "150";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MEMORY_EVIDENCE_GATE";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly default: "1";
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_MICROCOMPACT_KEEP_LAST";
+    readonly description: "Number of the most-recent tool_result blocks that tool-result microcompaction keeps intact regardless of size, so the agent does not lose the tool output it is actively reasoning over. Older results are the safe ones to trim. Default 4 (see shared/compaction.ts DEFAULT_MICROCOMPACT_KEEP_LAST). Values <= 0 protect nothing.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "4";
+    readonly example: "3";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MICROCOMPACT_TOOL_RESULT_BYTES";
+    readonly description: "Byte threshold (tool_result content length) at/above which a tool_result block becomes a microcompaction candidate. When /compact and auto-compaction would otherwise no-op on a short-but-full session, microcompaction clears large/old tool_result CONTENT in place (largest first) — replacing it with a short placeholder, never removing the block — to reclaim context deterministically (no LLM call). Blocks below this size are left intact. Default 2048 (see shared/compaction.ts DEFAULT_MICROCOMPACT_TOOL_RESULT_BYTES).";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "2048";
+    readonly example: "4096";
+    readonly category: "model";
+}, {
+    readonly name: "AFK_MICROCOMPACT_DELEGATION_BYTES";
+    readonly description: "Byte threshold for delegation tool results (agent/compose/skill). These results carry pre-compressed subagent findings that are expensive to re-derive -- clearing them destroys irreplaceable synthesized knowledge. A delegation tool result must be at least this large before microcompaction considers clearing it. Default 16384 (16KB, vs 2KB for ordinary tools). Set to match AFK_MICROCOMPACT_TOOL_RESULT_BYTES to disable the elevated threshold.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "16384";
+    readonly example: "32768";
+    readonly category: "model";
+}];

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

@@ -31,4 +31,46 @@ export declare const PATHS_ENV_REGISTRY: readonly [{
     readonly required: false;
     readonly example: "/Users/me/Projects/afk-companion/PRIMER.md";
     readonly category: "paths";
+}, {
+    readonly name: "HOME";
+    readonly description: "Standard Unix home directory. Used as the fallback when AFK_HOME is unset.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "PATH";
+    readonly description: "System PATH. Read for executable resolution (git, gh, etc.) in tool handlers.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "APPDATA";
+    readonly description: "Windows %APPDATA% (Roaming). Used for VS Code/Cursor settings discovery and credential denylist paths.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "LOCALAPPDATA";
+    readonly description: "Windows %LOCALAPPDATA%. Used for browser credential denylist paths (Chrome, Firefox, Edge, etc.).";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "USERPROFILE";
+    readonly description: "Windows %USERPROFILE%. Used for credential denylist paths (.ssh, .aws, .gnupg) on win32.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "USER";
+    readonly description: "Unix login name of the current user. Used as a default approver identity in improve/approve.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
+}, {
+    readonly name: "USERNAME";
+    readonly description: "Windows login name of the current user. Fallback after USER when identifying the approver.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "process";
 }];

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

@@ -0,0 +1,31 @@
+export declare const PEER_ENV_REGISTRY: readonly [{
+    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";
+}];