python-agent-harness 1.5.4.5__tar.gz → 1.5.4.6__tar.gz

{python_agent_harness-1.5.4.5/python_agent_harness.egg-info → python_agent_harness-1.5.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-agent-harness
-Version: 1.5.4.5
+Version: 1.5.4.6
 Summary: A lightweight, hackable mini-OpenCode written in Python.
 Author: huming
 License-Expression: MIT
@@ -138,17 +138,15 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "_comment": "Named LLM profiles for /model switching. Partial settings; unset keys inherit the main llm.",
     "deepseek": {
       "base_url": "https://api.deepseek.com/v1",
-      "model": "deepseek-chat"
+      "model": "deepseek-chat",
+      "context_window": 128000
     },
     "qwen": {
       "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
-      "model": "qwen3.5-coder"
+      "model": "qwen3.5-coder",
+      "context_window": 131072
     }
   },
-  "context_windows": {
-    "_comment": "Optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g. deepseek-v4 = 1000000); matched in file order, first match wins. Overrides the built-in CONTEXT_WINDOWS table in config.py.",
-    "deepseek-v4": 1000000
-  },
   "subagent_llm": {
     "profile": null,
     "base_url": null,
@@ -158,7 +156,8 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "max_tokens": null,
     "timeout": null,
     "reasoning_effort": null,
-    "stream": null
+    "stream": null,
+    "context_window": null
   },
   "paths": {
     "context_path": null,
@@ -186,10 +185,9 @@ All LLM settings live in a single JSON configuration file. Environment variables
 
 ### Configuration options
 
-- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `run --no-stream` overrides `stream`.
-- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. `default` restores the main LLM configuration.
-- **`context_windows`** — optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g., `deepseek-v4`); matched in file order, first match wins. Overrides the built-in `CONTEXT_WINDOWS` table in `config.py`.
-- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
+- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, `context_window`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `context_window` (tokens) overrides the built-in table for the active model; when unset, well-known models are matched automatically. `run --no-stream` overrides `stream`.
+- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. Each profile can include `context_window` to set the context window for that model. `default` restores the main LLM configuration.
+- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. `context_window` can also be set here to override the inherited value for sub-agents. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
 - **`paths.context_path` / `paths.skill_path`** — locations from which to load context files and skills. When unset, the project-local `<project>/contexts` and `<project>/skills` directories are used.
 - **`mcp.servers`** — MCP server configuration. Requires the `[mcp]` extra. Each server supports `transport`, `command`, `args`, `env`, `url`, `headers`, `parallel`, `timeout`, and `enabled`.
 - **Configuration precedence** — code defaults < config file < `OPENAI_*` environment variables. Sub-agent settings also support `OPENAI_SUBAGENT_*` (`_BASE_URL`, `_API_KEY`, `_MODEL`).

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/README.md

@@ -115,17 +115,15 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "_comment": "Named LLM profiles for /model switching. Partial settings; unset keys inherit the main llm.",
     "deepseek": {
       "base_url": "https://api.deepseek.com/v1",
-      "model": "deepseek-chat"
+      "model": "deepseek-chat",
+      "context_window": 128000
     },
     "qwen": {
       "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
-      "model": "qwen3.5-coder"
+      "model": "qwen3.5-coder",
+      "context_window": 131072
     }
   },
-  "context_windows": {
-    "_comment": "Optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g. deepseek-v4 = 1000000); matched in file order, first match wins. Overrides the built-in CONTEXT_WINDOWS table in config.py.",
-    "deepseek-v4": 1000000
-  },
   "subagent_llm": {
     "profile": null,
     "base_url": null,
@@ -135,7 +133,8 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "max_tokens": null,
     "timeout": null,
     "reasoning_effort": null,
-    "stream": null
+    "stream": null,
+    "context_window": null
   },
   "paths": {
     "context_path": null,
@@ -163,10 +162,9 @@ All LLM settings live in a single JSON configuration file. Environment variables
 
 ### Configuration options
 
-- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `run --no-stream` overrides `stream`.
-- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. `default` restores the main LLM configuration.
-- **`context_windows`** — optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g., `deepseek-v4`); matched in file order, first match wins. Overrides the built-in `CONTEXT_WINDOWS` table in `config.py`.
-- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
+- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, `context_window`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `context_window` (tokens) overrides the built-in table for the active model; when unset, well-known models are matched automatically. `run --no-stream` overrides `stream`.
+- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. Each profile can include `context_window` to set the context window for that model. `default` restores the main LLM configuration.
+- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. `context_window` can also be set here to override the inherited value for sub-agents. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
 - **`paths.context_path` / `paths.skill_path`** — locations from which to load context files and skills. When unset, the project-local `<project>/contexts` and `<project>/skills` directories are used.
 - **`mcp.servers`** — MCP server configuration. Requires the `[mcp]` extra. Each server supports `transport`, `command`, `args`, `env`, `url`, `headers`, `parallel`, `timeout`, and `enabled`.
 - **Configuration precedence** — code defaults < config file < `OPENAI_*` environment variables. Sub-agent settings also support `OPENAI_SUBAGENT_*` (`_BASE_URL`, `_API_KEY`, `_MODEL`).

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-agent-harness"
-version = "1.5.4.5"
+version = "1.5.4.6"
 description = "A lightweight, hackable mini-OpenCode written in Python."
 readme = "README.md"
 requires-python = ">=3.11"

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/__init__.py

@@ -5,7 +5,7 @@ from .mcp.manager import MCPManager
 from .models import AgentMode, Message, ToolCall, ToolSpec
 from .session import Session
 
-__version__ = "1.5.4.5"
+__version__ = "1.5.4.6"
 
 __all__ = [
     "Session",

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/cli.py

@@ -217,17 +217,11 @@ def cmd_config(args: argparse.Namespace) -> int:
         for name, profile in sorted(model_profiles.items()):
             model_name = profile.get("model", "(inherited)")
             base_url = profile.get("base_url", "(inherited)")
-            print(f"  {name}: model={model_name}, base_url={base_url}")
+            cw = profile.get("context_window")
+            cw_str = f", context_window={cw}" if cw is not None else ""
+            print(f"  {name}: model={model_name}, base_url={base_url}{cw_str}")
     else:
         print("models: (none configured — add a 'models' section to use /model)")
-    # Show context-window overrides
-    context_windows = config.load_context_windows_config(args.path)
-    if context_windows:
-        print("context_windows:")
-        for pattern, size in context_windows:
-            print(f"  {pattern}: {size}")
-    else:
-        print("context_windows: (none configured — built-in table in config.py applies)")
     return 0
 
 

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/client.py

@@ -217,6 +217,10 @@ class Client:
         # the user asked to stop.  Cleared at the start of each chat()
         # so a fresh turn may retry normally.
         self._aborted = False
+        # Per-model context-window override: set by the session when
+        # switching to a model profile that carries its own
+        # context_window.  None means "resolve from config / table".
+        self._context_window: int | None = None
         # an explicit log file is inherited by clones so every request
         # of one session (main + all sub-agents) lands in a single log
         self.log_path = (
@@ -229,18 +233,21 @@ class Client:
     def context_window(self) -> int:
         """Get the context window for this model.
 
-        Resolution order: config-file ``context_windows`` overrides
-        (via ``config.get_context_window_for_model``) -> CONTEXT_WINDOWS
-        pattern match -> DEFAULT_CONTEXT_WINDOW.  Resolved on every
-        access (no caching), so a runtime model switch or config-file
-        edit takes effect immediately; a malformed config falls back to
-        the default for that access and recovers once the file is fixed.
+        Resolution order: explicit ``_context_window`` override (set by
+        the session on model switch) → ``llm.context_window`` from the
+        config file → built-in CONTEXT_WINDOWS table (substring match)
+        → DEFAULT_CONTEXT_WINDOW.  Resolved on every access (no
+        caching), so a runtime model switch or config-file edit takes
+        effect immediately; a malformed config falls back to the default
+        for that access and recovers once the file is fixed.
         """
+        if self._context_window is not None:
+            return self._context_window
         try:
             return config.get_context_window_for_model(self.model, config_path=self._config_path)
         except Exception:
-            # a malformed context_windows section must not break the
-            # loop: use the safe default, retry on the next access
+            # a malformed config must not break the loop: use the safe
+            # default, retry on the next access
             return config.DEFAULT_CONTEXT_WINDOW
 
     def close(self) -> None:
@@ -259,7 +266,7 @@ class Client:
         flag strictly per-request.  The log file is shared so one
         session's LLM interactions stay in one log.
         """
-        return Client(
+        c = Client(
             base_url=self.base_url,
             api_key=self.api_key,
             model=self.model,
@@ -271,6 +278,8 @@ class Client:
             config_path=self._config_path,
             log_path=self.log_path,
         )
+        c._context_window = self._context_window
+        return c
 
     def abort(self) -> None:
         """Abort the in-flight request (called on cancel).

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/config.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 
 import json
 import os
+import warnings
 from pathlib import Path
 
 from .mcp.config import MCPConfig
@@ -173,6 +174,7 @@ DEFAULT_LLM: dict = {
     "timeout": 600.0,
     "reasoning_effort": None,
     "stream": True,
+    "context_window": None,
 }
 
 DEFAULT_PATHS: dict = {
@@ -196,6 +198,7 @@ DEFAULT_SUBAGENT_LLM: dict = {
     "timeout": None,
     "reasoning_effort": None,
     "stream": None,
+    "context_window": None,
 }
 
 CONFIG_TEMPLATE = """\
@@ -208,20 +211,18 @@ CONFIG_TEMPLATE = """\
     "stream": true
   }},
   "models": {{
-    "_comment": "Named LLM profiles for /model switching. Each entry is a full set of LLM settings (base_url, api_key, model, etc.). Use /model in the TUI to switch at runtime.",
+    "_comment": "Named LLM profiles for /model switching. Each entry is a full set of LLM settings (base_url, api_key, model, context_window, etc.). Use /model in the TUI to switch at runtime. Unset keys inherit the main llm settings.",
     "deepseek": {{
       "base_url": "https://api.deepseek.com/v1",
-      "model": "deepseek-chat"
+      "model": "deepseek-chat",
+      "context_window": 128000
     }},
     "openai": {{
       "base_url": "https://api.openai.com/v1",
-      "model": "gpt-5-mini"
+      "model": "gpt-5-mini",
+      "context_window": 128000
     }}
   }},
-  "context_windows": {{
-    "_comment": "Optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g. deepseek-v4 = 1000000); matched in file order, first match wins. Overrides the built-in CONTEXT_WINDOWS table in config.py. Remove this section to use the built-in table.",
-    "deepseek-v4": 1000000
-  }},
   "subagent_llm": {{
     "_comment": "Optional overrides for sub-agent (Agent tool) requests, e.g. a cheaper model. Every key is optional; unset keys inherit the main llm settings above. Set 'profile' to a name from the 'models' section to reuse a model profile (profile settings win over explicit keys below).",
     "profile": null,
@@ -232,7 +233,8 @@ CONFIG_TEMPLATE = """\
     "max_tokens": null,
     "timeout": null,
     "reasoning_effort": null,
-    "stream": null
+    "stream": null,
+    "context_window": null
   }},
   "paths": {{
     "_comment": "Optional overrides for context and skill directories. Absolute paths or ~ expansion supported.",
@@ -270,6 +272,22 @@ _SUBAGENT_ENV_OVERRIDES = {
 }
 
 
+def _validate_context_window(
+    value: object, section: str, path: str | os.PathLike | None = None
+) -> None:
+    """Raise ValueError if *value* is set but not a positive integer."""
+    if value is None:
+        return
+    if isinstance(value, bool) or not isinstance(value, int):
+        raise ValueError(
+            f"config file {_config_path(path)}: {section}.context_window must be an integer"
+        )
+    if value <= 0:
+        raise ValueError(
+            f"config file {_config_path(path)}: {section}.context_window must be positive"
+        )
+
+
 def _config_path(path: str | os.PathLike | None = None) -> Path:
     """Resolve the config file path: explicit arg > $PYTHON_AGENT_HARNESS_CONFIG > default."""
     if path:
@@ -305,6 +323,9 @@ def load_llm_config(path: str | os.PathLike | None = None) -> dict:
 
     The config file is JSON with an ``llm`` object (see `CONFIG_TEMPLATE`).
     Environment variables still win if set, so existing setups keep working.
+    ``context_window`` is an optional integer (tokens); when unset it
+    defaults to None, meaning "resolve from the built-in table at
+    runtime".
     """
     settings = dict(DEFAULT_LLM)
     data = _read_config(path)
@@ -320,9 +341,19 @@ def load_llm_config(path: str | os.PathLike | None = None) -> dict:
         "timeout",
         "reasoning_effort",
         "stream",
+        "context_window",
     ):
         if key in llm and llm[key] is not None:
             settings[key] = llm[key]
+    _validate_context_window(settings.get("context_window"), "llm", path)
+    # Warn if the old top-level context_windows section is still present.
+    if data.get("context_windows"):
+        warnings.warn(
+            "The top-level 'context_windows' section in config.json is deprecated and ignored. "
+            "Set 'context_window' inside 'llm' or each model profile in 'models' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
     for key, env in _ENV_OVERRIDES.items():
         val = os.environ.get(env)
         if val:
@@ -378,6 +409,7 @@ def load_subagent_llm_config(
             "timeout",
             "reasoning_effort",
             "stream",
+            "context_window",
         ):
             if key in profile and profile[key] is not None:
                 overrides[key] = profile[key]
@@ -473,65 +505,62 @@ def _match_context_window(model: str) -> int | None:
     return None
 
 
-def load_context_windows_config(
-    path: str | os.PathLike | None = None,
-) -> list[tuple[str, int]]:
-    """Load per-model context-window overrides from the config file.
-
-    Reads the ``context_windows`` object: a mapping of model names or
-    substrings (matched in file order, first match wins) to token
-    counts.  Keys starting with ``_`` are comments and skipped.  A
-    missing file, missing section, or unreadable JSON yields ``[]``
-    (callers fall back to the built-in table); a malformed section or
-    non-integer size raises ValueError so config errors surface.
+def get_context_window_for_model(
+    model: str,
+    config_path: str | os.PathLike | None = None,
+) -> int:
+    """Get the context window for MODEL.
+
+    Resolution order:
+    1. ``llm.context_window`` from the config file (when the active
+       model matches — this is already baked into the settings dict
+       returned by ``load_llm_config``; callers that use a resolved
+       settings dict should prefer ``resolve_context_window`` instead).
+    2. Built-in CONTEXT_WINDOWS table (substring match, first wins).
+    3. DEFAULT_CONTEXT_WINDOW.
+
+    This function is the fallback for callers that only have a model
+    name and no resolved settings dict (e.g. ``token_estimator``
+    or ``FakeClient``).
     """
+    # Try the llm.context_window from the config file first.
     try:
-        data = _read_config(path)
+        data = _read_config(config_path)
     except ValueError:
-        return []
-    section = data.get("context_windows") or {}
-    if not isinstance(section, dict):
-        raise ValueError(f"config file {_config_path(path)}: context_windows must be an object")
-    entries: list[tuple[str, int]] = []
-    for pattern, size in section.items():
-        if pattern.startswith("_"):
-            continue
-        if isinstance(size, bool) or not isinstance(size, int):
-            raise ValueError(
-                f"config file {_config_path(path)}: context_windows.{pattern} must be an integer"
-            )
-        if size <= 0:
-            raise ValueError(
-                f"config file {_config_path(path)}: context_windows.{pattern} must be positive"
-            )
-        entries.append((pattern, size))
-    return entries
+        data = {}
+    llm = data.get("llm") or {}
+    if isinstance(llm, dict):
+        cw = llm.get("context_window")
+        if cw is not None and isinstance(cw, int) and not isinstance(cw, bool) and cw > 0:
+            return cw
+    # Fall back to the built-in table, then the default.
+    matched = _match_context_window(model)
+    if matched is not None:
+        return matched
+    return DEFAULT_CONTEXT_WINDOW
 
 
-def get_context_window_for_model(
-    model: str,
-    config_path: str | os.PathLike | None = None,
-) -> int:
-    """Get the context window for MODEL: config-file overrides, then
-    the built-in table, then the default.
+def resolve_context_window(settings: dict, model: str | None = None) -> int:
+    """Resolve the context window from a fully-merged settings dict.
 
-    The config file's ``context_windows`` object (user overrides) is
-    consulted first (substring match over its keys, first match wins,
-    case-insensitive); then the CONTEXT_WINDOWS table in config.py;
-    then DEFAULT_CONTEXT_WINDOW.
+    Precedence:
+    1. ``settings["context_window"]`` — set by the active profile,
+       ``llm`` section, or ``subagent_llm`` section (already merged
+       by the load functions).
+    2. Built-in CONTEXT_WINDOWS table (substring match on *model*).
+    3. DEFAULT_CONTEXT_WINDOW.
 
     Args:
-        model: The model ID to look up (e.g. "deepseek-v4-flash")
-        config_path: Optional path to the config file; defaults to the
-            standard config location (config.json).
-
-    Returns:
-        The context window size as an integer.
+        settings: A resolved LLM settings dict (from ``load_llm_config``,
+            ``load_subagent_llm_config``, or a merged profile).
+        model: The model ID to match against the built-in table when
+            ``context_window`` is not set.  Defaults to
+            ``settings["model"]`` when omitted.
     """
-    lowered = model.lower()
-    for pattern, size in load_context_windows_config(config_path):
-        if pattern.lower() in lowered:
-            return size
+    cw = settings.get("context_window")
+    if cw is not None and isinstance(cw, int) and not isinstance(cw, bool) and cw > 0:
+        return cw
+    model = model or settings.get("model") or ""
     matched = _match_context_window(model)
     if matched is not None:
         return matched

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/session.py

@@ -661,6 +661,7 @@ class Session:
             "timeout": self.client.timeout,
             "reasoning_effort": self.reasoning_effort,
             "stream": self.stream,
+            "context_window": getattr(self.client, "_context_window", None),
         }
         for key, val in current.items():
             merged.setdefault(key, val)
@@ -674,6 +675,7 @@ class Session:
                 "timeout",
                 "reasoning_effort",
                 "stream",
+                "context_window",
             ):
                 if key in profile and profile[key] is not None:
                     merged[key] = profile[key]
@@ -693,6 +695,10 @@ class Session:
             self.client.timeout = merged["timeout"]
         self.reasoning_effort = merged["reasoning_effort"]
         self.stream = merged["stream"]
+        # context_window: set the client override so subsequent
+        # client.context_window accesses use the profile's value
+        # (None means "resolve from config / built-in table").
+        self.client._context_window = merged.get("context_window")
         return True, f"switched to {name} ({self.model})"
 
     # ------------------------------------------------------------------

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6}/python_agent_harness/token_estimator.py

@@ -44,9 +44,9 @@ def context_window_for(model: str, config_path: str | os.PathLike | None = None)
     """Return the context window for MODEL, or a safe fallback.
 
     Delegates to ``config.get_context_window_for_model``: config-file
-    ``context_windows`` overrides (config.json) first, then substring
-    match over CONTEXT_WINDOWS (first match wins, case-insensitive),
-    then DEFAULT_CONTEXT_WINDOW.
+    ``llm.context_window`` first, then substring match over
+    CONTEXT_WINDOWS (first match wins, case-insensitive), then
+    DEFAULT_CONTEXT_WINDOW.
 
     Args:
         model: The model ID to look up.

{python_agent_harness-1.5.4.5 → python_agent_harness-1.5.4.6/python_agent_harness.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-agent-harness
-Version: 1.5.4.5
+Version: 1.5.4.6
 Summary: A lightweight, hackable mini-OpenCode written in Python.
 Author: huming
 License-Expression: MIT
@@ -138,17 +138,15 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "_comment": "Named LLM profiles for /model switching. Partial settings; unset keys inherit the main llm.",
     "deepseek": {
       "base_url": "https://api.deepseek.com/v1",
-      "model": "deepseek-chat"
+      "model": "deepseek-chat",
+      "context_window": 128000
     },
     "qwen": {
       "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
-      "model": "qwen3.5-coder"
+      "model": "qwen3.5-coder",
+      "context_window": 131072
     }
   },
-  "context_windows": {
-    "_comment": "Optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g. deepseek-v4 = 1000000); matched in file order, first match wins. Overrides the built-in CONTEXT_WINDOWS table in config.py.",
-    "deepseek-v4": 1000000
-  },
   "subagent_llm": {
     "profile": null,
     "base_url": null,
@@ -158,7 +156,8 @@ All LLM settings live in a single JSON configuration file. Environment variables
     "max_tokens": null,
     "timeout": null,
     "reasoning_effort": null,
-    "stream": null
+    "stream": null,
+    "context_window": null
   },
   "paths": {
     "context_path": null,
@@ -186,10 +185,9 @@ All LLM settings live in a single JSON configuration file. Environment variables
 
 ### Configuration options
 
-- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `run --no-stream` overrides `stream`.
-- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. `default` restores the main LLM configuration.
-- **`context_windows`** — optional per-model context-window overrides (tokens). Keys are model names or substrings (e.g., `deepseek-v4`); matched in file order, first match wins. Overrides the built-in `CONTEXT_WINDOWS` table in `config.py`.
-- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
+- **`llm`** — main LLM configuration. Optional keys include `temperature`, `max_tokens`, `timeout`, `reasoning_effort`, `context_window`, and `stream`. Values such as `reasoning_effort` are passed to the API as-is when set. `context_window` (tokens) overrides the built-in table for the active model; when unset, well-known models are matched automatically. `run --no-stream` overrides `stream`.
+- **`models`** — named LLM profiles for runtime switching with `/model`. A profile is a partial settings dictionary; unset keys inherit from the main `llm`. Each profile can include `context_window` to set the context window for that model. `default` restores the main LLM configuration.
+- **`subagent_llm`** — LLM configuration for `Agent` tool requests. Unset values inherit from the main `llm`. Set `profile` to reuse a profile from `models`. `context_window` can also be set here to override the inherited value for sub-agents. Precedence is: profile settings > explicit `subagent_llm` settings > main `llm` > environment variables.
 - **`paths.context_path` / `paths.skill_path`** — locations from which to load context files and skills. When unset, the project-local `<project>/contexts` and `<project>/skills` directories are used.
 - **`mcp.servers`** — MCP server configuration. Requires the `[mcp]` extra. Each server supports `transport`, `command`, `args`, `env`, `url`, `headers`, `parallel`, `timeout`, and `enabled`.
 - **Configuration precedence** — code defaults < config file < `OPENAI_*` environment variables. Sub-agent settings also support `OPENAI_SUBAGENT_*` (`_BASE_URL`, `_API_KEY`, `_MODEL`).