kimi-cli 0.41__tar.gz → 0.43__tar.gz

{kimi_cli-0.41 → kimi_cli-0.43}/PKG-INFO

@@ -1,24 +1,25 @@
 Metadata-Version: 2.3
 Name: kimi-cli
-Version: 0.41
+Version: 0.43
 Summary: Kimi CLI is your next CLI agent.
-Requires-Dist: agent-client-protocol>=0.4.9
-Requires-Dist: aiofiles>=25.1.0
-Requires-Dist: aiohttp>=3.13.1
-Requires-Dist: click>=8.3.0
-Requires-Dist: kosong>=0.15.0
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: patch-ng>=1.19.0
-Requires-Dist: prompt-toolkit>=3.0.52
-Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: rich>=14.2.0
-Requires-Dist: ripgrepy>=2.2.0
-Requires-Dist: streamingjson>=0.0.5
-Requires-Dist: trafilatura>=2.0.0
-Requires-Dist: tenacity>=9.1.2
-Requires-Dist: fastmcp>=2.12.5
-Requires-Dist: pydantic>=2.12.3
-Requires-Dist: httpx[socks]>=0.28.0
+Requires-Dist: agent-client-protocol==0.6.2
+Requires-Dist: aiofiles==25.1.0
+Requires-Dist: aiohttp==3.13.2
+Requires-Dist: click==8.3.0
+Requires-Dist: kosong==0.16.1
+Requires-Dist: loguru==0.7.3
+Requires-Dist: patch-ng==1.19.0
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: pillow==12.0.0
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==14.2.0
+Requires-Dist: ripgrepy==2.2.0
+Requires-Dist: streamingjson==0.0.5
+Requires-Dist: trafilatura==2.0.0
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: fastmcp==2.12.5
+Requires-Dist: pydantic==2.12.3
+Requires-Dist: httpx[socks]==0.28.1
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 
@@ -84,7 +85,7 @@ After setup, Kimi CLI will be ready to use. You can send `/help` to get more inf
 
 ### Shell mode
 
-Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-K`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
+Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-X`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
 
 > [!NOTE]
 > Built-in shell commands like `cd` are not supported yet.
@@ -109,7 +110,7 @@ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
 plugins=(... kimi-cli)
 ```
 
-After restarting Zsh, you can switch to agent mode by pressing `Ctrl-K`.
+After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
 
 ### ACP support
 

{kimi_cli-0.41 → kimi_cli-0.43}/README.md

@@ -60,7 +60,7 @@ After setup, Kimi CLI will be ready to use. You can send `/help` to get more inf
 
 ### Shell mode
 
-Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-K`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
+Kimi CLI is not only a coding agent, but also a shell. You can switch the mode by pressing `Ctrl-X`. In shell mode, you can directly run shell commands without leaving Kimi CLI.
 
 > [!NOTE]
 > Built-in shell commands like `cd` are not supported yet.
@@ -85,7 +85,7 @@ Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
 plugins=(... kimi-cli)
 ```
 
-After restarting Zsh, you can switch to agent mode by pressing `Ctrl-K`.
+After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
 
 ### ACP support
 

{kimi_cli-0.41 → kimi_cli-0.43}/pyproject.toml

@@ -1,34 +1,35 @@
 [project]
 name = "kimi-cli"
-version = "0.41"
+version = "0.43"
 description = "Kimi CLI is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "agent-client-protocol>=0.4.9",
-    "aiofiles>=25.1.0",
-    "aiohttp>=3.13.1",
-    "click>=8.3.0",
-    "kosong>=0.15.0",
-    "loguru>=0.7.3",
-    "patch-ng>=1.19.0",
-    "prompt-toolkit>=3.0.52",
-    "pyyaml>=6.0.3",
-    "rich>=14.2.0",
-    "ripgrepy>=2.2.0",
-    "streamingjson>=0.0.5",
-    "trafilatura>=2.0.0",
-    "tenacity>=9.1.2",
-    "fastmcp>=2.12.5",
-    "pydantic>=2.12.3",
-    "httpx[socks]>=0.28.0",
+    "agent-client-protocol==0.6.2",
+    "aiofiles==25.1.0",
+    "aiohttp==3.13.2",
+    "click==8.3.0",
+    "kosong==0.16.1",
+    "loguru==0.7.3",
+    "patch-ng==1.19.0",
+    "prompt-toolkit==3.0.52",
+    "pillow==12.0.0",
+    "pyyaml==6.0.3",
+    "rich==14.2.0",
+    "ripgrepy==2.2.0",
+    "streamingjson==0.0.5",
+    "trafilatura==2.0.0",
+    "tenacity==9.1.2",
+    "fastmcp==2.12.5",
+    "pydantic==2.12.3",
+    "httpx[socks]==0.28.1",
 ]
 
 [dependency-groups]
 dev = [
-    "inline-snapshot[black]>=0.30.1",
+    "inline-snapshot[black]>=0.31.0",
     "pyinstaller>=6.16.0",
-    "pyright>=1.1.406",
+    "pyright>=1.1.407",
     "pytest>=8.4.2",
     "pytest-asyncio>=1.2.0",
     "ruff>=0.14.1",

{kimi_cli-0.41 → kimi_cli-0.43}/src/kimi_cli/CHANGELOG.md

@@ -9,6 +9,34 @@ Internal builds may append content to the Unreleased section.
 Only write entries that are worth mentioning to users.
 -->
 
+## [0.43] - 2025-10-30
+
+### Added
+
+- Basic Windows support (experimental)
+- Display warnings when base URL or API key is overridden in environment variables
+- Support image input if the LLM model supports it
+- Replay recent context history when continuing a session
+
+### Fixed
+
+- Ensure new line after executing shell commands
+
+## [0.42] - 2025-10-28
+
+### Added
+
+- Support Ctrl-J or Alt-Enter to insert a new line
+
+### Changed
+
+- Change mode switch shortcut from Ctrl-K to Ctrl-X
+- Improve overall robustness
+
+### Fixed
+
+- Fix ACP server `no attribute` error
+
 ## [0.41] - 2025-10-26
 
 ### Fixed

kimi_cli-0.43/src/kimi_cli/__init__.py

@@ -0,0 +1,192 @@
+import contextlib
+import os
+import warnings
+from collections.abc import Generator
+from pathlib import Path
+from typing import Any
+
+from pydantic import SecretStr
+
+from kimi_cli.agentspec import DEFAULT_AGENT_FILE
+from kimi_cli.config import LLMModel, LLMProvider, load_config
+from kimi_cli.llm import augment_provider_with_env_vars, create_llm
+from kimi_cli.session import Session
+from kimi_cli.soul.agent import load_agent
+from kimi_cli.soul.context import Context
+from kimi_cli.soul.kimisoul import KimiSoul
+from kimi_cli.soul.runtime import Runtime
+from kimi_cli.ui.acp import ACPServer
+from kimi_cli.ui.print import InputFormat, OutputFormat, PrintApp
+from kimi_cli.ui.shell import ShellApp, WelcomeInfoItem
+from kimi_cli.utils.logging import StreamToLogger, logger
+
+
+class KimiCLI:
+    @staticmethod
+    async def create(
+        session: Session,
+        *,
+        yolo: bool = False,
+        stream: bool = True,  # TODO: remove this when we have a correct print mode impl
+        mcp_configs: list[dict[str, Any]] | None = None,
+        config_file: Path | None = None,
+        model_name: str | None = None,
+        agent_file: Path | None = None,
+    ) -> "KimiCLI":
+        """
+        Create a KimiCLI instance.
+
+        Args:
+            session (Session): A session created by `Session.create` or `Session.continue_`.
+            yolo (bool, optional): Approve all actions without confirmation. Defaults to False.
+            stream (bool, optional): Use stream mode when calling LLM API. Defaults to True.
+            config_file (Path | None, optional): Path to the configuration file. Defaults to None.
+            model_name (str | None, optional): Name of the model to use. Defaults to None.
+            agent_file (Path | None, optional): Path to the agent file. Defaults to None.
+
+        Raises:
+            FileNotFoundError: When the agent file is not found.
+            ConfigError(KimiCLIException): When the configuration is invalid.
+            AgentSpecError(KimiCLIException): When the agent specification is invalid.
+        """
+        config = load_config(config_file)
+        logger.info("Loaded config: {config}", config=config)
+
+        model: LLMModel | None = None
+        provider: LLMProvider | None = None
+
+        # try to use config file
+        if not model_name and config.default_model:
+            # no --model specified && default model is set in config
+            model = config.models[config.default_model]
+            provider = config.providers[model.provider]
+        if model_name and model_name in config.models:
+            # --model specified && model is set in config
+            model = config.models[model_name]
+            provider = config.providers[model.provider]
+
+        if not model:
+            model = LLMModel(provider="", model="", max_context_size=100_000)
+            provider = LLMProvider(type="kimi", base_url="", api_key=SecretStr(""))
+
+        # try overwrite with environment variables
+        assert provider is not None
+        assert model is not None
+        env_overrides = augment_provider_with_env_vars(provider, model)
+
+        if not provider.base_url or not model.model:
+            llm = None
+        else:
+            logger.info("Using LLM provider: {provider}", provider=provider)
+            logger.info("Using LLM model: {model}", model=model)
+            llm = create_llm(provider, model, stream=stream, session_id=session.id)
+
+        welcome_info = [
+            WelcomeInfoItem(name="Directory", value=str(session.work_dir)),
+            WelcomeInfoItem(name="Session", value=session.id),
+        ]
+        if base_url := env_overrides.get("KIMI_BASE_URL"):
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="API URL",
+                    value=f"{base_url} (from KIMI_BASE_URL)",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        if not llm:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value="not set, send /setup to configure",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        elif "KIMI_MODEL_NAME" in env_overrides:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value=f"{model.model} (from KIMI_MODEL_NAME)",
+                    level=WelcomeInfoItem.Level.WARN,
+                )
+            )
+        else:
+            welcome_info.append(
+                WelcomeInfoItem(
+                    name="Model",
+                    value=model.model,
+                    level=WelcomeInfoItem.Level.INFO,
+                )
+            )
+
+        runtime = await Runtime.create(config, llm, session, yolo)
+
+        if agent_file is None:
+            agent_file = DEFAULT_AGENT_FILE
+        agent = await load_agent(agent_file, runtime, mcp_configs=mcp_configs or [])
+
+        context = Context(session.history_file)
+        await context.restore()
+
+        soul = KimiSoul(
+            agent,
+            runtime,
+            context=context,
+        )
+        return KimiCLI(soul, session, welcome_info)
+
+    def __init__(
+        self,
+        soul: KimiSoul,
+        session: Session,
+        welcome_info: list[WelcomeInfoItem],
+    ) -> None:
+        self._soul = soul
+        self._session = session
+        self._welcome_info = welcome_info
+
+    @property
+    def soul(self) -> KimiSoul:
+        """Get the KimiSoul instance."""
+        return self._soul
+
+    @property
+    def session(self) -> Session:
+        """Get the Session instance."""
+        return self._session
+
+    @contextlib.contextmanager
+    def _app_env(self) -> Generator[None]:
+        original_cwd = Path.cwd()
+        os.chdir(self._session.work_dir)
+        try:
+            # to ignore possible warnings from dateparser
+            warnings.filterwarnings("ignore", category=DeprecationWarning)
+            with contextlib.redirect_stderr(StreamToLogger()):
+                yield
+        finally:
+            os.chdir(original_cwd)
+
+    async def run_shell_mode(self, command: str | None = None) -> bool:
+        with self._app_env():
+            app = ShellApp(self._soul, welcome_info=self._welcome_info)
+            return await app.run(command)
+
+    async def run_print_mode(
+        self,
+        input_format: InputFormat,
+        output_format: OutputFormat,
+        command: str | None = None,
+    ) -> bool:
+        with self._app_env():
+            app = PrintApp(
+                self._soul,
+                input_format,
+                output_format,
+                self._session.history_file,
+            )
+            return await app.run(command)
+
+    async def run_acp_server(self) -> bool:
+        with self._app_env():
+            app = ACPServer(self._soul)
+            return await app.run()

{kimi_cli-0.41/src/kimi_cli/agents/koder → kimi_cli-0.43/src/kimi_cli/agents/default}/agent.yaml

@@ -19,6 +19,6 @@ agent:
     - "kimi_cli.tools.web:SearchWeb"
     - "kimi_cli.tools.web:FetchURL"
   subagents:
-    koder:
+    coder:
       path: ./sub.yaml
       description: "Good at general software engineering tasks."

{kimi_cli-0.41 → kimi_cli-0.43}/src/kimi_cli/agentspec.py

@@ -4,12 +4,14 @@ from typing import Any, NamedTuple
 import yaml
 from pydantic import BaseModel, Field
 
+from kimi_cli.exception import AgentSpecError
+
 
 def get_agents_dir() -> Path:
     return Path(__file__).parent / "agents"
 
 
-DEFAULT_AGENT_FILE = get_agents_dir() / "koder" / "agent.yaml"
+DEFAULT_AGENT_FILE = get_agents_dir() / "default" / "agent.yaml"
 
 
 class AgentSpec(BaseModel):
@@ -47,15 +49,21 @@ class ResolvedAgentSpec(NamedTuple):
 
 
 def load_agent_spec(agent_file: Path) -> ResolvedAgentSpec:
-    """Load agent specification from file."""
+    """
+    Load agent specification from file.
+
+    Raises:
+        FileNotFoundError: If the agent spec file is not found.
+        AgentSpecError: If the agent spec is not valid.
+    """
     agent_spec = _load_agent_spec(agent_file)
     assert agent_spec.extend is None, "agent extension should be recursively resolved"
     if agent_spec.name is None:
-        raise ValueError("Agent name is required")
+        raise AgentSpecError("Agent name is required")
     if agent_spec.system_prompt_path is None:
-        raise ValueError("System prompt path is required")
+        raise AgentSpecError("System prompt path is required")
     if agent_spec.tools is None:
-        raise ValueError("Tools are required")
+        raise AgentSpecError("Tools are required")
     return ResolvedAgentSpec(
         name=agent_spec.name,
         system_prompt_path=agent_spec.system_prompt_path,
@@ -68,12 +76,15 @@ def load_agent_spec(agent_file: Path) -> ResolvedAgentSpec:
 
 def _load_agent_spec(agent_file: Path) -> AgentSpec:
     assert agent_file.is_file(), "expect agent file to exist"
-    with open(agent_file, encoding="utf-8") as f:
-        data: dict[str, Any] = yaml.safe_load(f)
+    try:
+        with open(agent_file, encoding="utf-8") as f:
+            data: dict[str, Any] = yaml.safe_load(f)
+    except yaml.YAMLError as e:
+        raise AgentSpecError(f"Invalid YAML in agent spec file: {e}") from e
 
     version = data.get("version", 1)
     if version != 1:
-        raise ValueError(f"Unsupported agent spec version: {version}")
+        raise AgentSpecError(f"Unsupported agent spec version: {version}")
 
     agent_spec = AgentSpec(**data.get("agent", {}))
     if agent_spec.system_prompt_path is not None:

{kimi_cli-0.41 → kimi_cli-0.43}/src/kimi_cli/cli.py

@@ -1,15 +1,15 @@
 import asyncio
 import json
 import sys
+from collections.abc import Callable
 from pathlib import Path
+from typing import Any, Literal, get_args
 
 import click
 
-from kimi_cli import UIMode, kimi_run
-from kimi_cli.agentspec import DEFAULT_AGENT_FILE
-from kimi_cli.config import ConfigError, load_config
+from kimi_cli import KimiCLI
 from kimi_cli.constant import VERSION
-from kimi_cli.metadata import continue_session, new_session
+from kimi_cli.session import Session
 from kimi_cli.share import get_share_dir
 from kimi_cli.ui.print import InputFormat, OutputFormat
 from kimi_cli.utils.logging import logger
@@ -21,6 +21,9 @@ class Reload(Exception):
     pass
 
 
+UIMode = Literal["shell", "print", "acp"]
+
+
 @click.command(context_settings=dict(help_option_names=["-h", "--help"]))
 @click.version_option(VERSION)
 @click.option(
@@ -38,8 +41,8 @@ class Reload(Exception):
 @click.option(
     "--agent-file",
     type=click.Path(exists=True, file_okay=True, dir_okay=False, path_type=Path),
-    default=DEFAULT_AGENT_FILE,
-    help="Custom agent specification file. Default: builtin Kimi Koder.",
+    default=None,
+    help="Custom agent specification file. Default: builtin default agent.",
 )
 @click.option(
     "--model",
@@ -77,7 +80,7 @@ class Reload(Exception):
 @click.option(
     "--ui",
     "ui",
-    type=click.Choice(["shell", "print", "acp"]),
+    type=click.Choice(get_args(UIMode)),
     default="shell",
     help="UI mode to use. Default: shell.",
 )
@@ -85,7 +88,7 @@ class Reload(Exception):
     "--print",
     "ui",
     flag_value="print",
-    help="Run in print mode. Shortcut for `--ui print`.",
+    help="Run in print mode. Shortcut for `--ui print`. Note: print mode implicitly adds `--yolo`.",
 )
 @click.option(
     "--acp",
@@ -95,7 +98,7 @@ class Reload(Exception):
 )
 @click.option(
     "--input-format",
-    type=click.Choice(["text", "stream-json"]),
+    type=click.Choice(get_args(InputFormat)),
     default=None,
     help=(
         "Input format to use. Must be used with `--print` "
@@ -105,7 +108,7 @@ class Reload(Exception):
 )
 @click.option(
     "--output-format",
-    type=click.Choice(["text", "stream-json"]),
+    type=click.Choice(get_args(OutputFormat)),
     default=None,
     help="Output format to use. Must be used with `--print`. Default: text.",
 )
@@ -140,7 +143,7 @@ class Reload(Exception):
 def kimi(
     verbose: bool,
     debug: bool,
-    agent_file: Path,
+    agent_file: Path | None,
     model_name: str | None,
     work_dir: Path,
     continue_: bool,
@@ -153,7 +156,11 @@ def kimi(
     yolo: bool,
 ):
     """Kimi, your next CLI agent."""
-    echo = click.echo if verbose else lambda *args, **kwargs: None
+
+    def _noop_echo(*args: Any, **kwargs: Any):
+        pass
+
+    echo: Callable[..., None] = click.echo if verbose else _noop_echo
 
     logger.add(
         get_share_dir() / "logs" / "kimi.log",
@@ -163,19 +170,23 @@ def kimi(
     )
 
     work_dir = work_dir.absolute()
-
     if continue_:
-        session = continue_session(work_dir)
+        session = Session.continue_(work_dir)
         if session is None:
             raise click.BadOptionUsage(
                 "--continue", "No previous session found for the working directory"
             )
         echo(f"✓ Continuing previous session: {session.id}")
     else:
-        session = new_session(work_dir)
+        session = Session.create(work_dir)
         echo(f"✓ Created new session: {session.id}")
     echo(f"✓ Session history file: {session.history_file}")
 
+    if command is not None:
+        command = command.strip()
+        if not command:
+            raise click.BadOptionUsage("--command", "Command cannot be empty")
+
     if input_format is not None and ui != "print":
         raise click.BadOptionUsage(
             "--input-format",
@@ -188,7 +199,7 @@ def kimi(
         )
 
     try:
-        mcp_configs = [json.loads(conf.read_text()) for conf in mcp_config_file]
+        mcp_configs = [json.loads(conf.read_text(encoding="utf-8")) for conf in mcp_config_file]
     except json.JSONDecodeError as e:
         raise click.BadOptionUsage("--mcp-config-file", f"Invalid JSON: {e}") from e
 
@@ -197,29 +208,32 @@ def kimi(
     except json.JSONDecodeError as e:
         raise click.BadOptionUsage("--mcp-config", f"Invalid JSON: {e}") from e
 
+    async def _run() -> bool:
+        instance = await KimiCLI.create(
+            session,
+            yolo=yolo or (ui == "print"),  # print mode implies yolo
+            stream=ui != "print",  # use non-streaming mode only for print UI
+            mcp_configs=mcp_configs,
+            model_name=model_name,
+            agent_file=agent_file,
+        )
+        match ui:
+            case "shell":
+                return await instance.run_shell_mode(command)
+            case "print":
+                return await instance.run_print_mode(
+                    input_format or "text",
+                    output_format or "text",
+                    command,
+                )
+            case "acp":
+                if command is not None:
+                    logger.warning("ACP server ignores command argument")
+                return await instance.run_acp_server()
+
     while True:
         try:
-            try:
-                config = load_config()
-            except ConfigError as e:
-                raise click.ClickException(f"Failed to load config: {e}") from e
-            echo(f"✓ Loaded config: {config}")
-
-            succeeded = asyncio.run(
-                kimi_run(
-                    config=config,
-                    model_name=model_name,
-                    work_dir=work_dir,
-                    session=session,
-                    command=command,
-                    agent_file=agent_file,
-                    ui=ui,
-                    input_format=input_format,
-                    output_format=output_format,
-                    mcp_configs=mcp_configs,
-                    yolo=yolo,
-                )
-            )
+            succeeded = asyncio.run(_run())
             if not succeeded:
                 sys.exit(1)
             break