klaude-code 2.23.0__tar.gz → 2.24.0__tar.gz

{klaude_code-2.23.0 → klaude_code-2.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 2.23.0
+Version: 2.24.0
 Summary: Minimal code agent CLI
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: chardet>=5.2.0,<6
@@ -19,6 +19,7 @@ Requires-Dist: sse-starlette
 Requires-Dist: trafilatura>=2.0.0
 Requires-Dist: typer>=0.17.3
 Requires-Dist: uvicorn
+Requires-Dist: readability-lxml>=0.8.4.1
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 
@@ -59,6 +60,25 @@ Or use the built-in command:
 klaude upgrade
 ```
 
+### Development Install
+
+```bash
+git clone https://github.com/inspirepan/klaude-code.git
+cd klaude-code
+make install    # init submodules, build web frontend, install as editable
+```
+
+Or step by step:
+
+```bash
+git submodule update --init --recursive
+uv sync                              # install Python deps
+uv run python scripts/build_web.py   # build web frontend
+uv tool install -e .                 # install CLI globally (editable)
+```
+
+Requires `pnpm` or `npm` for the web frontend build (`pnpm` preferred).
+
 ## Usage
 
 ```bash

{klaude_code-2.23.0 → klaude_code-2.24.0}/README.md

@@ -35,6 +35,25 @@ Or use the built-in command:
 klaude upgrade
 ```
 
+### Development Install
+
+```bash
+git clone https://github.com/inspirepan/klaude-code.git
+cd klaude-code
+make install    # init submodules, build web frontend, install as editable
+```
+
+Or step by step:
+
+```bash
+git submodule update --init --recursive
+uv sync                              # install Python deps
+uv run python scripts/build_web.py   # build web frontend
+uv tool install -e .                 # install CLI globally (editable)
+```
+
+Requires `pnpm` or `npm` for the web frontend build (`pnpm` preferred).
+
 ## Usage
 
 ```bash

{klaude_code-2.23.0 → klaude_code-2.24.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "klaude-code"
-version = "2.23.0"
+version = "2.24.0"
 description = "Minimal code agent CLI"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -26,6 +26,7 @@ dependencies = [
     "trafilatura>=2.0.0",
     "typer>=0.17.3",
     "uvicorn",
+    "readability-lxml>=0.8.4.1",
 ]
 
 [project.scripts]
@@ -34,6 +35,9 @@ klaude-code = "klaude_code.cli.main:app"
 
 [tool.uv.build-backend]
 module-name = "klaude_code"
+# web/dist is gitignored by the generic `dist/` pattern; force-include so
+# sdist (and wheels built from sdist) still contain the pre-built frontend.
+source-include = ["src/klaude_code/web/dist/**"]
 
 [dependency-groups]
 dev = [
@@ -42,6 +46,7 @@ dev = [
     "pyright>=1.1.407",
     "pytest>=8.4.1",
     "pytest-cov>=7.0.0",
+    "pytest-timeout>=2.4.0",
     "ruff==0.14.3",
     "ty>=0.0.8",
 ]
@@ -49,6 +54,7 @@ dev = [
 
 
 [tool.pytest.ini_options]
+timeout = 30
 markers = [
     "network: marks tests as requiring network access (deselect with '-m \"not network\"')",
 ]
@@ -56,6 +62,7 @@ markers = [
 [tool.ruff]
 line-length = 120
 src = ["src"]
+exclude = ["src/klaude_code/skill/assets"]
 
 [tool.ruff.lint]
 select = ["E", "F", "B", "I", "UP", "SIM", "RUF"]
@@ -76,7 +83,7 @@ exclude = [
     ".venv/",
     ".pnpm-store/",
     "web/node_modules/",
-    "src/klaude_code/skill/assets/**/scripts/",
+    "src/klaude_code/skill/assets/",
 ]
 
 [[tool.pyright.executionEnvironments]]

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/app/runtime.py

@@ -20,9 +20,11 @@ from klaude_code.core.agent_profile import (
 from klaude_code.core.control.event_bus import EventBus, EventSubscription
 from klaude_code.core.control.event_relay import EventRelayPublisher, event_relay_socket_path
 from klaude_code.core.control.runtime_facade import RuntimeFacade
-from klaude_code.log import log, set_debug_logging
+from klaude_code.core.control.session_meta_relay import SessionMetaRelayPublisher, session_meta_relay_socket_path
+from klaude_code.log import DebugType, log, log_debug, set_debug_logging
 from klaude_code.protocol import events, op, user_interaction
 from klaude_code.session.session import Session, close_default_store
+from klaude_code.session.store import register_session_meta_observer
 
 SESSION_IDLE_TTL_SECONDS = 30 * 60
 SESSION_IDLE_RECLAIM_INTERVAL_SECONDS = 60
@@ -48,6 +50,8 @@ class AppComponents:
     runtime: RuntimeFacade
     event_bus: EventBus
     event_relay_publisher: EventRelayPublisher | None
+    session_meta_relay_publisher: SessionMetaRelayPublisher | None
+    unregister_session_meta_relay_observer: Callable[[], None] | None
     event_bus_subscription: EventSubscription
     display: DisplayABC
     display_task: asyncio.Task[None]
@@ -156,8 +160,14 @@ async def initialize_app_components(
         model_profile_provider = DefaultModelProfileProvider(config=config)
 
     event_relay_publisher: EventRelayPublisher | None = None
+    session_meta_relay_publisher: SessionMetaRelayPublisher | None = None
+    unregister_session_meta_relay_observer: Callable[[], None] | None = None
     if init_config.enable_event_relay_client:
         event_relay_publisher = EventRelayPublisher(socket_path=event_relay_socket_path())
+        session_meta_relay_publisher = SessionMetaRelayPublisher(socket_path=session_meta_relay_socket_path())
+        unregister_session_meta_relay_observer = register_session_meta_observer(
+            lambda session_id, meta: session_meta_relay_publisher.publish_upsert(session_id, meta)
+        )
 
     event_bus = EventBus(publish_hook=event_relay_publisher.publish if event_relay_publisher is not None else None)
     event_bus_subscription = event_bus.subscribe(None)
@@ -207,6 +217,8 @@ async def initialize_app_components(
         runtime=runtime,
         event_bus=event_bus,
         event_relay_publisher=event_relay_publisher,
+        session_meta_relay_publisher=session_meta_relay_publisher,
+        unregister_session_meta_relay_observer=unregister_session_meta_relay_observer,
         event_bus_subscription=event_bus_subscription,
         display=display,
         display_task=display_task,
@@ -261,32 +273,58 @@ def backfill_session_model_config(
 async def cleanup_app_components(components: AppComponents) -> None:
     """Clean up all runtime components."""
     try:
+        if components.unregister_session_meta_relay_observer is not None:
+            log_debug("[app] cleanup: unregister session meta relay observer", debug_type=DebugType.EXECUTION)
+            components.unregister_session_meta_relay_observer()
+
+        log_debug("[app] cleanup: cancel idle reclaim task", debug_type=DebugType.EXECUTION)
         components.idle_reclaim_task.cancel()
         with contextlib.suppress(asyncio.CancelledError):
             await components.idle_reclaim_task
 
+        log_debug("[app] cleanup: cancel owner heartbeat task", debug_type=DebugType.EXECUTION)
         components.owner_heartbeat_task.cancel()
         with contextlib.suppress(asyncio.CancelledError):
             await components.owner_heartbeat_task
 
+        log_debug("[app] cleanup: runtime.stop start", debug_type=DebugType.EXECUTION)
         await components.runtime.stop()
+        log_debug("[app] cleanup: runtime.stop done", debug_type=DebugType.EXECUTION)
         with contextlib.suppress(Exception):
+            log_debug("[app] cleanup: close_default_store start", debug_type=DebugType.EXECUTION)
             await close_default_store()
+            log_debug("[app] cleanup: close_default_store done", debug_type=DebugType.EXECUTION)
 
         with contextlib.suppress(Exception):
+            log_debug("[app] cleanup: wait_for_display_idle start", debug_type=DebugType.EXECUTION)
             await components.wait_for_display_idle()
+            log_debug("[app] cleanup: wait_for_display_idle done", debug_type=DebugType.EXECUTION)
 
         with contextlib.suppress(Exception):
+            log_debug("[app] cleanup: publish EndEvent start", debug_type=DebugType.EXECUTION)
             await components.event_bus.publish(events.EndEvent())
+            log_debug("[app] cleanup: publish EndEvent done", debug_type=DebugType.EXECUTION)
 
         if components.event_relay_publisher is not None:
             with contextlib.suppress(Exception):
+                log_debug("[app] cleanup: event relay publisher close start", debug_type=DebugType.EXECUTION)
                 await components.event_relay_publisher.aclose()
+                log_debug("[app] cleanup: event relay publisher close done", debug_type=DebugType.EXECUTION)
+
+        if components.session_meta_relay_publisher is not None:
+            with contextlib.suppress(Exception):
+                log_debug("[app] cleanup: session meta relay publisher close start", debug_type=DebugType.EXECUTION)
+                components.session_meta_relay_publisher.close()
+                log_debug("[app] cleanup: session meta relay publisher close done", debug_type=DebugType.EXECUTION)
 
         if components.interaction_task is not None:
             with contextlib.suppress(Exception):
+                log_debug("[app] cleanup: interaction task await start", debug_type=DebugType.EXECUTION)
                 await components.interaction_task
+                log_debug("[app] cleanup: interaction task await done", debug_type=DebugType.EXECUTION)
+        log_debug("[app] cleanup: display task await start", debug_type=DebugType.EXECUTION)
         await components.display_task
+        log_debug("[app] cleanup: display task await done", debug_type=DebugType.EXECUTION)
     finally:
         # Ensure the terminal cursor is visible even if Rich's spinner did not stop cleanly.
         with contextlib.suppress(Exception):

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/cli/auth_cmd.py

@@ -1,22 +1,37 @@
 """Authentication commands for CLI."""
 
+from typing import Any, cast
+
 import typer
 
-from klaude_code.app.auth_flow import execute_login, execute_logout
-from klaude_code.tui.command.auth_selector import select_provider
 
+class _LazyProviderHelp:
+    _value: str | None = None
+
+    def _resolve(self) -> str:
+        if self._value is None:
+            from klaude_code.config.builtin_config import SUPPORTED_API_KEYS
+
+            names = ["codex", "claude", "github-copilot", "copilot"] + [
+                k.name.split()[0].lower() for k in SUPPORTED_API_KEYS
+            ]
+            self._value = f"Provider name ({', '.join(names)})"
+        return self._value
 
-def _build_provider_help() -> str:
-    from klaude_code.config.builtin_config import SUPPORTED_API_KEYS
+    def __str__(self) -> str:
+        return self._resolve()
 
-    names = ["codex", "claude", "github-copilot", "copilot"] + [k.name.split()[0].lower() for k in SUPPORTED_API_KEYS]
-    return f"Provider name ({', '.join(names)})"
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._resolve(), name)
 
 
 def login_command(
-    provider: str | None = typer.Argument(None, help=_build_provider_help()),
+    provider: str | None = typer.Argument(None, help=cast(str, _LazyProviderHelp())),
 ) -> None:
     """Login to a provider or configure API keys."""
+    from klaude_code.app.auth_flow import execute_login
+    from klaude_code.tui.command.auth_selector import select_provider
+
     if provider is None:
         provider = select_provider()
         if provider is None:
@@ -29,6 +44,9 @@ def logout_command(
     provider: str | None = typer.Argument(None, help="Provider to logout (codex|claude|github-copilot|copilot)"),
 ) -> None:
     """Logout from a provider."""
+    from klaude_code.app.auth_flow import execute_logout
+    from klaude_code.tui.command.auth_selector import select_provider
+
     if provider is None:
         provider = select_provider(include_api_keys=False, prompt="Select provider to logout:")
         if provider is None:

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/cli/config_cmd.py

@@ -6,15 +6,13 @@ import sys
 
 import typer
 
-from klaude_code.config import config_path, create_example_config, example_config_path, load_config
-from klaude_code.log import log
-
 
 def list_models(
     show_all: bool = typer.Option(False, "--all", "-a", help="Include unavailable providers"),
 ) -> None:
     """List available models"""
     from klaude_code.cli.list_model import display_models_and_providers
+    from klaude_code.config import load_config
     from klaude_code.tui.terminal.color import is_light_terminal_background
 
     config = load_config()
@@ -32,6 +30,9 @@ def list_models(
 
 def edit_config() -> None:
     """Edit config file"""
+    from klaude_code.config import config_path, create_example_config, example_config_path
+    from klaude_code.log import log
+
     editor = os.environ.get("EDITOR")
 
     # If no EDITOR is set, prioritize TextEdit on macOS

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/cli/cost_cmd.py

@@ -594,8 +594,3 @@ def cost_command(
     table = render_cost_table(daily_stats)
     console = Console()
     console.print(table)
-
-
-def register_cost_commands(app: typer.Typer) -> None:
-    """Register cost command to the given Typer app."""
-    app.command("cost")(cost_command)

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/cli/list_model.py

@@ -9,7 +9,7 @@ from klaude_code.cli.oauth_usage import (
     resolve_oauth_usage_protocol,
 )
 from klaude_code.config import Config
-from klaude_code.config.config import ModelConfig, ProviderConfig, parse_env_var_syntax
+from klaude_code.config.config import ModelConfig, ModelPreference, ProviderConfig, parse_env_var_syntax
 from klaude_code.config.formatters import format_model_params
 from klaude_code.protocol.llm_param import LLMClientProtocol
 from klaude_code.tui.components.rich.theme import ThemeKey, get_theme
@@ -106,7 +106,7 @@ def _build_model_lines(
     provider_disabled = provider.disabled
     provider_available = (not provider_disabled) and (not provider.is_api_key_missing())
 
-    def _resolve_selector(value: str | None) -> str | None:
+    def _resolve_selector(value: str) -> str | None:
         if not value:
             return None
         try:
@@ -117,12 +117,23 @@ def _build_model_lines(
             return None
         return f"{resolved[0]}@{resolved[1]}"
 
-    default_selector = _resolve_selector(config.main_model)
+    def _resolve_model_preference(value: ModelPreference) -> str | None:
+        if value is None:
+            return None
+        if isinstance(value, str):
+            return _resolve_selector(value)
+        for candidate in value:
+            result = _resolve_selector(candidate)
+            if result is not None:
+                return result
+        return None
+
+    default_selector = _resolve_model_preference(config.main_model)
 
     # Build reverse mapping: model_name -> list of agent roles using it
     model_to_agents: dict[str, list[str]] = {}
     for agent_role, model_name in (config.sub_agent_models or {}).items():
-        selector = _resolve_selector(model_name)
+        selector = _resolve_model_preference(model_name)
         if selector is None:
             continue
         if selector not in model_to_agents:

{klaude_code-2.23.0 → klaude_code-2.24.0}/src/klaude_code/cli/main.py

@@ -2,47 +2,54 @@ import asyncio
 import sys
 from collections.abc import Sequence
 from pathlib import Path
-from typing import Any
+from typing import Any, cast
 
 import typer
 from typer.core import TyperGroup
 
 from klaude_code.cli.auth_cmd import register_auth_commands
 from klaude_code.cli.config_cmd import register_config_commands
-from klaude_code.cli.cost_cmd import register_cost_commands
-from klaude_code.cli.debug import prepare_debug_logging
 from klaude_code.cli.self_update import register_self_upgrade_commands, version_option_callback
-from klaude_code.cli.web_cmd import register_web_commands
-from klaude_code.session import Session
-from klaude_code.tui.terminal.session_selector import select_session_sync
-from klaude_code.tui.terminal.title import update_terminal_title
-
-
-def _build_env_help() -> str:
-    from klaude_code.config.builtin_config import SUPPORTED_API_KEYS
-
-    lines = [
-        "Environment Variables:",
-        "",
-        "Provider API keys (built-in config):",
-    ]
-    # Calculate max env_var length for alignment
-    max_len = max(len(k.env_var) for k in SUPPORTED_API_KEYS)
-    for k in SUPPORTED_API_KEYS:
-        lines.append(f"  {k.env_var:<{max_len}}  {k.description}")
-    lines.extend(
-        [
-            "",
-            "Tool limits (Read):",
-            "  KLAUDE_READ_GLOBAL_LINE_CAP    Max lines to read (default: 2000)",
-            "  KLAUDE_READ_MAX_CHARS          Max total chars to read (default: 50000)",
-            "  KLAUDE_READ_MAX_IMAGE_BYTES    Max image bytes to read (default: 64MB)",
-        ]
-    )
-    return "\n\n".join(lines)
-
-
-ENV_HELP = _build_env_help()
+
+
+class _LazyEnvHelp:
+    """Lazy proxy that defers heavy config imports until --help is shown.
+
+    Typer/Click calls .split() and str() on the epilog, so we materialise
+    the real string on first attribute access.
+    """
+
+    _value: str | None = None
+
+    def _resolve(self) -> str:
+        if self._value is None:
+            from klaude_code.config.builtin_config import SUPPORTED_API_KEYS
+
+            lines = [
+                "Environment Variables:",
+                "",
+                "Provider API keys (built-in config):",
+            ]
+            max_len = max(len(k.env_var) for k in SUPPORTED_API_KEYS)
+            for k in SUPPORTED_API_KEYS:
+                lines.append(f"  {k.env_var:<{max_len}}  {k.description}")
+            lines.extend(
+                [
+                    "",
+                    "Tool limits (Read):",
+                    "  KLAUDE_READ_GLOBAL_LINE_CAP    Max lines to read (default: 2000)",
+                    "  KLAUDE_READ_MAX_CHARS          Max total chars to read (default: 50000)",
+                    "  KLAUDE_READ_MAX_IMAGE_BYTES    Max image bytes to read (default: 64MB)",
+                ]
+            )
+            self._value = "\n\n".join(lines)
+        return self._value
+
+    def __str__(self) -> str:
+        return self._resolve()
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._resolve(), name)
 
 
 def _looks_like_flag(token: str) -> bool:
@@ -124,24 +131,56 @@ class _PreprocessingTyperGroup(TyperGroup):
         )
 
 
+def prepare_debug_logging(debug: bool) -> tuple[bool, Path | None]:
+    from klaude_code.cli.debug import prepare_debug_logging as _prepare_debug_logging
+
+    return _prepare_debug_logging(debug)
+
+
+def run_web_server_command(*, host: str, port: int, no_open: bool, debug: bool) -> None:
+    from klaude_code.cli.web_cmd import run_web_server_command as _run_web_server_command
+
+    _run_web_server_command(host=host, port=port, no_open=no_open, debug=debug)
+
+
 app = typer.Typer(
     cls=_PreprocessingTyperGroup,
     add_completion=False,
     pretty_exceptions_enable=False,
     no_args_is_help=False,
     rich_markup_mode="rich",
-    epilog=ENV_HELP,
+    epilog=cast(str, _LazyEnvHelp()),
     context_settings={"help_option_names": ["-h", "--help"]},
 )
 
 # Register subcommands from modules
 register_auth_commands(app)
 register_config_commands(app)
-register_cost_commands(app)
-register_web_commands(app)
 register_self_upgrade_commands(app)
 
 
+@app.command("web")
+def _web_command_wrapper(  # pyright: ignore[reportUnusedFunction]
+    host: str = typer.Option("127.0.0.1", "--host", help="Host to bind web server"),
+    port: int = typer.Option(8765, "--port", help="Port to bind web server"),
+    no_open: bool = typer.Option(False, "--no-open", help="Do not open browser automatically"),
+    debug: bool = typer.Option(False, "--debug", help="Enable debug logs for web server"),
+) -> None:
+    run_web_server_command(host=host, port=port, no_open=no_open, debug=debug)
+
+
+# cost command is registered via a lazy wrapper to avoid pulling in
+# klaude_code.protocol at import time (~200ms).
+@app.command("cost")
+def _cost_command_wrapper(  # pyright: ignore[reportUnusedFunction]
+    days: int | None = typer.Option(None, "--days", "-d", "--recent", help="Limit to last N days"),
+) -> None:
+    """Show usage stats"""
+    from klaude_code.cli.cost_cmd import cost_command
+
+    cost_command(days=days)
+
+
 @app.command("help", hidden=True)
 def help_command(ctx: typer.Context) -> None:
     """Show help message."""
@@ -203,6 +242,9 @@ def main_callback(
     # Only run interactive mode when no subcommand is invoked
     if ctx.invoked_subcommand is None:
         from klaude_code.log import log
+        from klaude_code.session import Session
+        from klaude_code.tui.terminal.session_selector import select_session_sync
+        from klaude_code.tui.terminal.title import update_terminal_title
 
         resume_by_id_value = resume_by_id.strip() if resume_by_id is not None else None
         if resume_by_id_value == "":
@@ -332,9 +374,16 @@ def main_callback(
             viewer_url = start_log_viewer(log_path)
             log(f"Log viewer: {viewer_url}")
 
-        asyncio.run(
+        web_mode_request = asyncio.run(
             run_interactive(
                 init_config=init_config,
                 session_id=session_id,
             )
         )
+        if web_mode_request is not None:
+            run_web_server_command(
+                host=web_mode_request.host,
+                port=web_mode_request.port,
+                no_open=web_mode_request.no_open,
+                debug=web_mode_request.debug if web_mode_request.debug is not None else debug_enabled,
+            )