kimi-cli 0.35__py3-none-any.whl → 0.52__py3-none-any.whl

kimi_cli-0.52.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.3
+Name: kimi-cli
+Version: 0.52
+Summary: Kimi CLI is your next CLI agent.
+Requires-Dist: agent-client-protocol==0.6.3
+Requires-Dist: aiofiles==25.1.0
+Requires-Dist: aiohttp==3.13.2
+Requires-Dist: typer==0.20.0
+Requires-Dist: kosong==0.22.0
+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.4
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Kimi CLI
+
+[![Commit Activity](https://img.shields.io/github/commit-activity/w/MoonshotAI/kimi-cli)](https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity)
+[![Checks](https://img.shields.io/github/check-runs/MoonshotAI/kimi-cli/main)](https://github.com/MoonshotAI/kimi-cli/actions)
+[![Version](https://img.shields.io/pypi/v/kimi-cli)](https://pypi.org/project/kimi-cli/)
+[![Downloads](https://img.shields.io/pypi/dw/kimi-cli)](https://pypistats.org/packages/kimi-cli)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/MoonshotAI/kimi-cli)
+
+[中文](https://www.kimi.com/coding/docs/kimi-cli.html)
+
+Kimi CLI is a new CLI agent that can help you with your software development tasks and terminal operations.
+
+> [!IMPORTANT]
+> Kimi CLI is currently in technical preview.
+
+## Key features
+
+- Shell-like UI and shell command execution
+- Zsh integration
+- [Agent Client Protocol] support
+- MCP support
+- And more to come...
+
+[Agent Client Protocol]: https://github.com/agentclientprotocol/agent-client-protocol
+
+## Installation
+
+Kimi CLI is published as a Python package on PyPI. We highly recommend installing it with [uv](https://docs.astral.sh/uv/). If you have not installed uv yet, please follow the instructions [here](https://docs.astral.sh/uv/getting-started/installation/) to install it first.
+
+Once uv is installed, you can install Kimi CLI with:
+
+```sh
+uv tool install --python 3.13 kimi-cli
+```
+
+Run `kimi --help` to check if Kimi CLI is installed successfully.
+
+> [!IMPORTANT]
+> Due to the security checks on macOS, the first time you run `kimi` command may take 10 seconds or more depending on your system environment.
+
+## Upgrading
+
+Upgrade Kimi CLI to the latest version with:
+
+```sh
+uv tool upgrade kimi-cli --no-cache
+```
+
+## Usage
+
+Run `kimi` command in the directory you want to work on, then send `/setup` to setup Kimi CLI:
+
+![](./docs/images/setup.png)
+
+After setup, Kimi CLI will be ready to use. You can send `/help` to get more information.
+
+## Features
+
+### Shell mode
+
+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.
+
+### Zsh integration
+
+You can use Kimi CLI together with Zsh, to empower your shell experience with AI agent capabilities.
+
+Install the [zsh-kimi-cli](https://github.com/MoonshotAI/zsh-kimi-cli) plugin via:
+
+```sh
+git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
+  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli
+```
+
+> [!NOTE]
+> If you are using a plugin manager other than Oh My Zsh, you may need to refer to the plugin's README for installation instructions.
+
+Then add `kimi-cli` to your Zsh plugin list in `~/.zshrc`:
+
+```sh
+plugins=(... kimi-cli)
+```
+
+After restarting Zsh, you can switch to agent mode by pressing `Ctrl-X`.
+
+### ACP support
+
+Kimi CLI supports [Agent Client Protocol] out of the box. You can use it together with any ACP-compatible editor or IDE.
+
+For example, to use Kimi CLI with [Zed](https://zed.dev/), add the following configuration to your `~/.config/zed/settings.json`:
+
+```json
+{
+  "agent_servers": {
+    "Kimi CLI": {
+      "command": "kimi",
+      "args": ["--acp"],
+      "env": {}
+    }
+  }
+}
+```
+
+Then you can create Kimi CLI threads in Zed's agent panel.
+
+### Using MCP tools
+
+Kimi CLI supports the well-established MCP config convention. For example:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "YOUR_API_KEY"
+      }
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
+```
+
+Run `kimi` with `--mcp-config-file` option to connect to the specified MCP servers:
+
+```sh
+kimi --mcp-config-file /path/to/mcp.json
+```
+
+## Development
+
+To develop Kimi CLI, run:
+
+```sh
+git clone https://github.com/MoonshotAI/kimi-cli.git
+cd kimi-cli
+
+make prepare  # prepare the development environment
+```
+
+Then you can start working on Kimi CLI.
+
+Refer to the following commands after you make changes:
+
+```sh
+uv run kimi  # run Kimi CLI
+
+make format  # format code
+make check  # run linting and type checking
+make test  # run tests
+make help  # show all make targets
+```
+
+## Contributing
+
+We welcome contributions to Kimi CLI! Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.

kimi_cli-0.52.dist-info/RECORD

@@ -0,0 +1,99 @@
+kimi_cli/CHANGELOG.md,sha256=cc0250bcf4e0ef66c39068a33440df96190cae22b740ce43273cb98f3829b9cc,10268
+kimi_cli/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+kimi_cli/agents/default/agent.yaml,sha256=6e5c51987ef5cfc0c4c4e34cc20b6fc975953ee219623fccae81a19155aab7b3,709
+kimi_cli/agents/default/sub.yaml,sha256=e0c1ea34fdb04b0d6dc635709f0f130aff25d7f9fb97e238470143c8145be251,634
+kimi_cli/agents/default/system.md,sha256=1d8fd4956b2442215396b5e9651771c9da8f9505ccbd3b6d5e91b1ac4ff35418,5001
+kimi_cli/agentspec.py,sha256=1148b5184ca610b2fb261ce365a63eb2fc9d09497330fe0ea4b2567fc98d5657,4307
+kimi_cli/app.py,sha256=f2e5607329ee90636f7ff08876d3be3c3fa5234220586049c89c6172461d6e8a,7495
+kimi_cli/cli.py,sha256=a565cbf6529baa59729c629ab3b8a2e12a3c1e2476733b93859a986a9b4182fd,9094
+kimi_cli/config.py,sha256=db5f038c00920be9e10ad30bdecd4cb6be4b77de22845423a83c974e14f67dfc,4962
+kimi_cli/constant.py,sha256=78e25b9304cca7b6f70bb08bf0e1fee4b066297a05386e56dd6935ba42027cd9,110
+kimi_cli/exception.py,sha256=a3fec07566da7d2d34be8cc454fb825f34109bbde3cddf69e1ece6ab21b4b219,259
+kimi_cli/llm.py,sha256=0502113bc3830cffb4334342c775a5588bfd7323b2b46de3d6a3d526e812f5ea,5283
+kimi_cli/metadata.py,sha256=bde1e7eaa3d9c27a83cdeaf5506fe384290fb1b5d094f0fe9bb182cbbfec6b1f,1573
+kimi_cli/prompts/__init__.py,sha256=6dc5ed2d841f145c09550075f30853cdc51f00d2f5d9aa1097f8edea770536e7,174
+kimi_cli/prompts/compact.md,sha256=6655bd7d8270b24d8f97b51ef7c471cf71d686c56f8ec9a5cc9e47caa3aae87c,1877
+kimi_cli/prompts/init.md,sha256=d271a0df6dd7b330ffec4f645a74c0392dafc1b3bfc1e3f2a77624e96cf6abbe,1380
+kimi_cli/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+kimi_cli/session.py,sha256=a5ec3caa828428dd65fe6cb540cee1768a4def33a84a2f42d4744711e7bf550e,3681
+kimi_cli/share.py,sha256=4292df7f44177419c45c772a933b5f36e2b7533f8cef9842629a438bc7856dc0,204
+kimi_cli/soul/__init__.py,sha256=7183fea252b68dcddf710ec292419fb7c53bb163a30525f0331f43a8541826ca,5792
+kimi_cli/soul/agent.py,sha256=6d44374a884b0f8e5075337188c59be8cd820f635fbb6195c5d4099a65d05206,5025
+kimi_cli/soul/approval.py,sha256=48cd230dff81dfd70bd85f1ad2b99604d5569cf617a4c79c444f9772bbc89ce6,2552
+kimi_cli/soul/compaction.py,sha256=e38e5386fec2c236a1960a3814611cb093bd2e10645759961f2ef47b5d3747d0,3594
+kimi_cli/soul/context.py,sha256=8ae001e6fc0229ccf74c94f1aadfbef90a48d8eb0a78b9113ed720d32b5e543f,5850
+kimi_cli/soul/denwarenji.py,sha256=66b95f052a1fa844e2347972d34e1916a7be24d3e493701b451f5380b0375c9f,1384
+kimi_cli/soul/kimisoul.py,sha256=80b9cbc8bb8d2a017631bc639886f0b2da96f56fb24f0182b0c5e1f76c298a6d,12889
+kimi_cli/soul/message.py,sha256=ed31c9eecfe83a5d363327e0c91c74ef66106faf741c3892a0826d9226faf674,2536
+kimi_cli/soul/runtime.py,sha256=9421a3ce6882587a95ecdf77b3d75f3b7ecab55cf68dc57e3e563b93e5a02e46,2690
+kimi_cli/soul/toolset.py,sha256=9eda995fbbf18a17855ac15a83b28d3af88d34fc64efbac0674a2bf2221b52fc,772
+kimi_cli/tools/__init__.py,sha256=ab932d54793212c7036a29e1fa54b4f763349b450f0ab4da3108a2b2b3646068,3432
+kimi_cli/tools/bash/__init__.py,sha256=6302aad1ca202a633ea68ffa0dfac0de407966b5b3bb4ba5757e15915fd09ca4,3489
+kimi_cli/tools/bash/bash.md,sha256=5d9cc54b3718097951340b0a737c8e1fa308341fd2c4ebd121be94de31dd5f73,2348
+kimi_cli/tools/bash/cmd.md,sha256=af5a0042ba2e2373078427f14f078205a51585f888f3744af5280fb23c0ab45a,2603
+kimi_cli/tools/dmail/__init__.py,sha256=a33270355aee9d8acae93aeb5cf51bcff5018607b8be79ed579619f058e7826c,1326
+kimi_cli/tools/dmail/dmail.md,sha256=0d18cae387dd52127ddc99e296253c09e68ccba5f343153c0adbe77d7586e759,1912
+kimi_cli/tools/file/__init__.py,sha256=1516fb4c71097f9c14b605e7b9a1872af8786bdcb48323d1fa83bb1419436abb,546
+kimi_cli/tools/file/glob.md,sha256=11fbfaf6033f57b69c6f91077ddd90505036937cd7217600d96992b9a48b7ca7,1400
+kimi_cli/tools/file/glob.py,sha256=a95f0f502fe6458f8c21a7aa5f15e27828993b05fed83b83f8a7c0dc9c50a48b,5431
+kimi_cli/tools/file/grep.md,sha256=12353db42cf3b5d9d91ac7c0f0b9c2a732e8b050c23a78f4e668db823cca4d50,245
+kimi_cli/tools/file/grep.py,sha256=269f106bac7a3ab95f395a1e8233b45a104bcc11fc0a90a8f2beac08ef06588b,10710
+kimi_cli/tools/file/patch.md,sha256=f9edbed6c6a03bf7448a51acc1f42622395fd7f1674a814e9a3b2302d3b7b92e,404
+kimi_cli/tools/file/patch.py,sha256=7f96b7735609d183d54136adde8fd05352f20d865c2aebc640173c492d5257ab,6624
+kimi_cli/tools/file/read.md,sha256=4c2d83e557daadc0612fb1a613e252b2c8e4df7ae57e6db094e9e75e994cb23b,1066
+kimi_cli/tools/file/read.py,sha256=76ea260a813a987a4e34706f6cc3c2b77fc3f31a76831883caa91f9ab86df6a6,5109
+kimi_cli/tools/file/replace.md,sha256=f429f263fa580f2f6107907a33ba8800dcdbd4fc1d9ff8dc4f858bd76ec6bbc6,267
+kimi_cli/tools/file/replace.py,sha256=d2dd7381e004d0539a8cc0b6fa294aaed879d6ff18dde81dc0f4837b7c46c220,5206
+kimi_cli/tools/file/write.md,sha256=f37b0f4742da57797ec4dd29fbd4fdc9b6617c6be644724a3b16d651c6129cec,324
+kimi_cli/tools/file/write.py,sha256=ce40a695be5d45fc725545ec7134f0b963c7ddda0084e6ba59a0ac0d6d465d26,4380
+kimi_cli/tools/mcp.py,sha256=68c307e702a61737ec7d761a273abb74261a57925d50ffa59fbd2db1b2037dc4,3731
+kimi_cli/tools/task/__init__.py,sha256=7a57f159bc0775fbc9b2ebb18c2cf8b973a4e0c82eb298225d9f78f4628f0ea9,6927
+kimi_cli/tools/task/task.md,sha256=391cc3553c7d310a323626bae180dd41cb810fb1233583713ebde105f954147a,2280
+kimi_cli/tools/test.py,sha256=c094a91a2d1a5259e192f1147facd5eebd5e5c413787fce167db90e4b41b5119,1442
+kimi_cli/tools/think/__init__.py,sha256=31b06088e2404cb09d42e0acec97c185e4861890bb687f28b41f39cea01b5733,603
+kimi_cli/tools/think/think.md,sha256=ab40d4de1d8adb208384a4ab548e35776283cb0a681c6e208b041fc40ccba724,200
+kimi_cli/tools/todo/__init__.py,sha256=2ea7deb0c06c97e200ccbb4c9b1e8cf0eb440ca8b0e87167204dcd41df0715fc,961
+kimi_cli/tools/todo/set_todo_list.md,sha256=89509503f43ab321d440a04dc133ddc3e29859f68907a42c39e6093f7bfd485c,1654
+kimi_cli/tools/utils.py,sha256=2e00d6f04f91e05a91bfb691e547a76193063fa6769a03f7d3ff992aba9372bf,4596
+kimi_cli/tools/web/__init__.py,sha256=e13108c598828a8a05907a7a821e7ac92f5d63572bb9866dc12ca026094acb42,95
+kimi_cli/tools/web/fetch.md,sha256=56d00bd93b4e379c4f7efe445fce963eb26b8d20f85d4c19097ba6f33bd0019a,67
+kimi_cli/tools/web/fetch.py,sha256=66448121d27d67f75b977c32244c721c2ccff1b2e097c2fe6717e66018d8f747,3183
+kimi_cli/tools/web/search.md,sha256=24049f9e90d37083e0fc78b8b2e3a5f6fadf09bea00f36712b235d1212a2f532,146
+kimi_cli/tools/web/search.py,sha256=8f757f1eb83a878bd2a9d8c3d0c137c244c2a1314b5de8d2a55da5261773b162,4469
+kimi_cli/ui/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+kimi_cli/ui/acp/__init__.py,sha256=bfcdd6e32ed84b710b3c5034edcfdd1cad3141dfee649a29601c8c955968d4ca,18294
+kimi_cli/ui/print/__init__.py,sha256=8c55a2a9ee8382544b24da90a286a7611e0ebd706cdc98aeb42059635f4cc0e6,5541
+kimi_cli/ui/shell/__init__.py,sha256=bc209f41d2c3e5da4a4442e9f84002f34be1c12256182786c99e02cc05a7d0d2,12125
+kimi_cli/ui/shell/console.py,sha256=bcbf7efd214cba3d2259f2a2c1842250cde96d49e4f9f1e0b60273cf1c366be3,842
+kimi_cli/ui/shell/debug.py,sha256=b6d7f5475580814bc3dc34abdc472e5bd2c06368e88cae517de1bacc343af9bf,5557
+kimi_cli/ui/shell/keyboard.py,sha256=23e5fbc4b6acda4c0f3b5297a0ae6eb09a90f4b5b37b2e95b7ce86a2da0d5dca,5160
+kimi_cli/ui/shell/metacmd.py,sha256=85f09997bc40279029ada6a12819d4edb4fb7d0ccac5e535d385257bb7e14347,7649
+kimi_cli/ui/shell/prompt.py,sha256=c078b7071a114e0869f655e90258f78bbffa80c70da7dc36164bde6921a8a76c,26697
+kimi_cli/ui/shell/replay.py,sha256=dfc50d6721dbd43566683f224c6df3b7c6e8f0ea06a726a1e4f3139fdb102227,3762
+kimi_cli/ui/shell/setup.py,sha256=6270ea039ebffbe11834e73a5c6f895d46c76d2460760bc5bec2741062f6a6fb,5258
+kimi_cli/ui/shell/update.py,sha256=56dcb0bd1da82b98c22bfdddca717a2805bd8ac3e93bf23fb3b508549c41fae8,7340
+kimi_cli/ui/shell/visualize.py,sha256=fa425172f252d4bf4b05fa515fff0e87559d9d10590b4a33c6b8b9a72d24cb87,21531
+kimi_cli/ui/wire/README.md,sha256=0d9beaf38d4f4f1777013e85445e615fcacfe3a169d11151c42a141dec6196bd,4849
+kimi_cli/ui/wire/__init__.py,sha256=9252f53cd32b5a114afdbc402817a627818a48897554977908b5c5e64864801e,11932
+kimi_cli/ui/wire/jsonrpc.py,sha256=c093a540e70026cb48eae494cf4c8ad04f1180338eaaad0a23d64798bb679944,995
+kimi_cli/utils/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+kimi_cli/utils/aiohttp.py,sha256=f8f61e3beaf6439e949c33c3a10db3035bf88136e882b09c858ea92a4c888e00,245
+kimi_cli/utils/changelog.py,sha256=8079109bae377c141d8f50b8ea5e5c2f1e44a6a70c0dcfb9987b3b480283ed9b,3536
+kimi_cli/utils/clipboard.py,sha256=81944e1ba313c8784e513b10e2a0bb759ac5acd4ee27cb335c876e5e93bb8fe6,212
+kimi_cli/utils/logging.py,sha256=129298ac214ecd8d913c3431cc05d754f9c4c8c4042c458618bf9e8ddebdb763,399
+kimi_cli/utils/message.py,sha256=e2ed32c5cac8e2c637fc9ea89c6643fd80a06e211b68d126312e4118b94b2d06,727
+kimi_cli/utils/path.py,sha256=fdd4fc08999ddc7c610f884b4ba8d27932248b9ed06b5eb4139519edd00b3f75,687
+kimi_cli/utils/pyinstaller.py,sha256=e5d709d0490ef8645bbed2d2363920c59f25bd17c04f471bf4a8c0fa2ebe1801,581
+kimi_cli/utils/rich/__init__.py,sha256=2cb421c8491bd11aa2360119f88a4788337fc9884aba05d6400761a0e24c4c2b,909
+kimi_cli/utils/rich/markdown.py,sha256=e81efafad7e82d52fab7d0d873d81c829054dd6c147c385b02ae91f9d8de4f92,33863
+kimi_cli/utils/rich/markdown_sample.md,sha256=2b04c7ad3eadca4bff61e5ccf4d9f2bc400110867afbce190e671ef3ff28007c,1792
+kimi_cli/utils/rich/markdown_sample_short.md,sha256=52f9186332bd41e0e84586c7025c3e69df69cf406add8e71d2413735aeb8aa24,17
+kimi_cli/utils/signals.py,sha256=20e0d158a1043189d44815fe3624cd0bfe41e99620a18ac9e12c0eda6db5220f,1387
+kimi_cli/utils/string.py,sha256=0d437d3633199df1051813af8b49a2f808c6525547310cc5c3d427710d2eae06,593
+kimi_cli/utils/term.py,sha256=89dc154e08730c56b2a69c8a2073a76b9736841b56bebc2b30a7bd1d0723c8f5,3049
+kimi_cli/wire/__init__.py,sha256=86e62344d4a56a4979eb08f5b62c74aeb858a4b0ef54bfc2ec8b095eb7fe1b49,2037
+kimi_cli/wire/message.py,sha256=826d21d7c2aca32124449b50d6352b880edbf517e87173441d4d38d6700f915f,5573
+kimi_cli-0.52.dist-info/WHEEL,sha256=70ab3c2925fe316809860cb034f99ba13c4b49819b339959274aab755cc084a8,78
+kimi_cli-0.52.dist-info/entry_points.txt,sha256=4a8d437328d2f5f95fd5b718206f7c249c99542444c452d9b45befef1bd58b62,43
+kimi_cli-0.52.dist-info/METADATA,sha256=ea845873311442b649724a6878df8f3cc87c49d231ee8257c46d8c7139241a2b,5206
+kimi_cli-0.52.dist-info/RECORD,,

kimi_cli-0.52.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+kimi = kimi_cli.cli:cli
+

kimi_cli/agent.py

@@ -1,261 +0,0 @@
-import importlib
-import inspect
-import string
-from pathlib import Path
-from typing import Any, NamedTuple
-
-import fastmcp
-import yaml
-from kosong.tooling import Toolset
-from kosong.tooling.simple import ToolType
-from pydantic import BaseModel, Field
-
-from kimi_cli.config import Config
-from kimi_cli.llm import LLM
-from kimi_cli.metadata import Session
-from kimi_cli.soul.approval import Approval
-from kimi_cli.soul.denwarenji import DenwaRenji
-from kimi_cli.soul.toolset import CustomToolset
-from kimi_cli.tools.mcp import MCPTool
-from kimi_cli.utils.logging import logger
-
-
-class AgentSpec(BaseModel):
-    """Agent specification."""
-
-    extend: str | None = Field(default=None, description="Agent file to extend")
-    name: str | None = Field(default=None, description="Agent name")  # required
-    system_prompt_path: Path | None = Field(
-        default=None, description="System prompt path"
-    )  # required
-    system_prompt_args: dict[str, str] = Field(
-        default_factory=dict, description="System prompt arguments"
-    )
-    tools: list[str] | None = Field(default=None, description="Tools")  # required
-    exclude_tools: list[str] | None = Field(default=None, description="Tools to exclude")
-    subagents: dict[str, "SubagentSpec"] | None = Field(default=None, description="Subagents")
-
-
-class SubagentSpec(BaseModel):
-    """Subagent specification."""
-
-    path: Path = Field(description="Subagent file path")
-    description: str = Field(description="Subagent description")
-
-
-class BuiltinSystemPromptArgs(NamedTuple):
-    """Builtin system prompt arguments."""
-
-    KIMI_NOW: str
-    """The current datetime."""
-    KIMI_WORK_DIR: Path
-    """The current working directory."""
-    KIMI_WORK_DIR_LS: str
-    """The `ls -la` output of current working directory."""
-    KIMI_AGENTS_MD: str  # TODO: move to first message from system prompt
-    """The content of AGENTS.md."""
-
-
-class AgentGlobals(NamedTuple):
-    """Agent globals."""
-
-    config: Config
-    llm: LLM | None
-    builtin_args: BuiltinSystemPromptArgs
-    denwa_renji: DenwaRenji
-    session: Session
-    approval: Approval
-
-
-class Agent(NamedTuple):
-    """The loaded agent."""
-
-    name: str
-    system_prompt: str
-    toolset: Toolset
-
-
-def get_agents_dir() -> Path:
-    return Path(__file__).parent / "agents"
-
-
-DEFAULT_AGENT_FILE = get_agents_dir() / "koder" / "agent.yaml"
-
-
-async def load_agent_with_mcp(
-    agent_file: Path,
-    globals_: AgentGlobals,
-    mcp_configs: list[dict[str, Any]],
-) -> Agent:
-    agent = load_agent(agent_file, globals_)
-    assert isinstance(agent.toolset, CustomToolset)
-    if mcp_configs:
-        await _load_mcp_tools(agent.toolset, mcp_configs)
-    return agent
-
-
-def load_agent(
-    agent_file: Path,
-    globals_: AgentGlobals,
-) -> Agent:
-    """
-    Load agent from specification file.
-
-    Raises:
-        ValueError: 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")
-    if agent_spec.system_prompt_path is None:
-        raise ValueError("System prompt path is required")
-    if agent_spec.tools is None:
-        raise ValueError("Tools are required")
-
-    system_prompt = _load_system_prompt(
-        agent_spec.system_prompt_path, agent_spec.system_prompt_args, globals_.builtin_args
-    )
-
-    tool_deps = {
-        AgentSpec: agent_spec,
-        AgentGlobals: globals_,
-        Config: globals_.config,
-        BuiltinSystemPromptArgs: globals_.builtin_args,
-        Session: globals_.session,
-        DenwaRenji: globals_.denwa_renji,
-        Approval: globals_.approval,
-    }
-    tools = agent_spec.tools
-    if agent_spec.exclude_tools:
-        logger.debug("Excluding tools: {tools}", tools=agent_spec.exclude_tools)
-        tools = [tool for tool in tools if tool not in agent_spec.exclude_tools]
-    toolset = CustomToolset()
-    bad_tools = _load_tools(toolset, tools, tool_deps)
-    if bad_tools:
-        raise ValueError(f"Invalid tools: {bad_tools}")
-
-    return Agent(
-        name=agent_spec.name,
-        system_prompt=system_prompt,
-        toolset=toolset,
-    )
-
-
-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)
-
-    version = data.get("version", 1)
-    if version != 1:
-        raise ValueError(f"Unsupported agent spec version: {version}")
-
-    agent_spec = AgentSpec(**data.get("agent", {}))
-    if agent_spec.system_prompt_path is not None:
-        agent_spec.system_prompt_path = agent_file.parent / agent_spec.system_prompt_path
-    if agent_spec.subagents is not None:
-        for v in agent_spec.subagents.values():
-            v.path = agent_file.parent / v.path
-    if agent_spec.extend:
-        if agent_spec.extend == "default":
-            base_agent_file = DEFAULT_AGENT_FILE
-        else:
-            base_agent_file = agent_file.parent / agent_spec.extend
-        base_agent_spec = _load_agent_spec(base_agent_file)
-        if agent_spec.name is not None:
-            base_agent_spec.name = agent_spec.name
-        if agent_spec.system_prompt_path is not None:
-            base_agent_spec.system_prompt_path = agent_spec.system_prompt_path
-        for k, v in agent_spec.system_prompt_args.items():
-            base_agent_spec.system_prompt_args[k] = v
-        if agent_spec.tools is not None:
-            base_agent_spec.tools = agent_spec.tools
-        if agent_spec.exclude_tools is not None:
-            base_agent_spec.exclude_tools = agent_spec.exclude_tools
-        if agent_spec.subagents is not None:
-            base_agent_spec.subagents = agent_spec.subagents
-        agent_spec = base_agent_spec
-    return agent_spec
-
-
-def _load_system_prompt(
-    path: Path, args: dict[str, str], builtin_args: BuiltinSystemPromptArgs
-) -> str:
-    system_prompt = path.read_text().strip()
-    logger.debug(
-        "Substituting system prompt with builtin args: {builtin_args}, spec args: {spec_args}",
-        builtin_args=builtin_args,
-        spec_args=args,
-    )
-    return string.Template(system_prompt).substitute(builtin_args._asdict(), **args)
-
-
-def _load_tools(
-    toolset: CustomToolset,
-    tool_paths: list[str],
-    dependencies: dict[type[Any], Any],
-) -> list[str]:
-    bad_tools = []
-    for tool_path in tool_paths:
-        tool = _load_tool(tool_path, dependencies)
-        if tool:
-            toolset += tool
-        else:
-            bad_tools.append(tool_path)
-    logger.debug("Loaded tools: {tools}", tools=toolset.tools)
-    if bad_tools:
-        logger.error("Bad tools: {bad_tools}", bad_tools=bad_tools)
-    return bad_tools
-
-
-def _load_tool(tool_path: str, dependencies: dict[type[Any], Any]) -> ToolType | None:
-    logger.debug("Loading tool: {tool_path}", tool_path=tool_path)
-    module_name, class_name = tool_path.rsplit(":", 1)
-    try:
-        module = importlib.import_module(module_name)
-    except ImportError:
-        return None
-    cls = getattr(module, class_name, None)
-    if cls is None:
-        return None
-    args = []
-    for param in inspect.signature(cls).parameters.values():
-        if param.kind == inspect.Parameter.KEYWORD_ONLY:
-            # once we encounter a keyword-only parameter, we stop injecting dependencies
-            break
-        # all positional parameters should be dependencies to be injected
-        if param.annotation not in dependencies:
-            raise ValueError(f"Tool dependency not found: {param.annotation}")
-        args.append(dependencies[param.annotation])
-    return cls(*args)
-
-
-async def _load_mcp_tools(
-    toolset: CustomToolset,
-    mcp_configs: list[dict[str, Any]],
-):
-    """
-    Raises:
-        ValueError: If the MCP config is not valid.
-        RuntimeError: If the MCP server cannot be connected.
-    """
-    for mcp_config in mcp_configs:
-        client = fastmcp.Client(mcp_config)
-        async with client:
-            for tool in await client.list_tools():
-                toolset += MCPTool(tool, client)
-    return toolset
-
-
-def load_agents_md(work_dir: Path) -> str | None:
-    paths = [
-        work_dir / "AGENTS.md",
-        work_dir / "agents.md",
-    ]
-    for path in paths:
-        if path.is_file():
-            logger.debug("Loaded agents.md: {path}", path=path)
-            return path.read_text().strip()
-    logger.debug("No AGENTS.md found")
-    return None

kimi_cli/agents/koder/README.md

@@ -1,3 +0,0 @@
-# Kimi Koder
-
-Kimi Koder is a CLI agent that can help you with your software development tasks.

kimi_cli/prompts/metacmds/__init__.py

@@ -1,4 +0,0 @@
-from pathlib import Path
-
-INIT = (Path(__file__).parent / "init.md").read_text()
-COMPACT = (Path(__file__).parent / "compact.md").read_text()

kimi_cli/soul/wire.py

@@ -1,101 +0,0 @@
-import asyncio
-import uuid
-from contextvars import ContextVar
-from enum import Enum
-from typing import NamedTuple
-
-from kosong.base.message import ContentPart, ToolCall, ToolCallPart
-from kosong.tooling import ToolResult
-
-from kimi_cli.soul import StatusSnapshot
-from kimi_cli.utils.logging import logger
-
-
-class StepBegin(NamedTuple):
-    n: int
-
-
-class StepInterrupted(NamedTuple):
-    pass
-
-
-class StatusUpdate(NamedTuple):
-    status: StatusSnapshot
-
-
-type ControlFlowEvent = StepBegin | StepInterrupted | StatusUpdate
-type Event = ControlFlowEvent | ContentPart | ToolCall | ToolCallPart | ToolResult
-
-
-class ApprovalResponse(Enum):
-    APPROVE = "approve"
-    APPROVE_FOR_SESSION = "approve_for_session"
-    REJECT = "reject"
-
-
-class ApprovalRequest:
-    def __init__(self, tool_call_id: str, action: str, description: str):
-        self.id = str(uuid.uuid4())
-        self.tool_call_id = tool_call_id
-        self.action = action
-        self.description = description
-        self._future = asyncio.Future[ApprovalResponse]()
-
-    def __repr__(self) -> str:
-        return (
-            f"ApprovalRequest(id={self.id}, tool_call_id={self.tool_call_id}, "
-            f"action={self.action}, description={self.description})"
-        )
-
-    async def wait(self) -> ApprovalResponse:
-        """
-        Wait for the request to be resolved or cancelled.
-
-        Returns:
-            ApprovalResponse: The response to the approval request.
-        """
-        return await self._future
-
-    def resolve(self, response: ApprovalResponse) -> None:
-        """
-        Resolve the approval request with the given response.
-        This will cause the `wait()` method to return the response.
-        """
-        self._future.set_result(response)
-
-
-type WireMessage = Event | ApprovalRequest
-
-
-class Wire:
-    """
-    A channel for communication between the soul and the UI.
-    """
-
-    def __init__(self):
-        self._queue = asyncio.Queue[WireMessage]()
-
-    def send(self, msg: WireMessage) -> None:
-        if not isinstance(msg, ContentPart | ToolCallPart):
-            logger.debug("Sending wire message: {msg}", msg=msg)
-        self._queue.put_nowait(msg)
-
-    async def receive(self) -> WireMessage:
-        msg = await self._queue.get()
-        if not isinstance(msg, ContentPart | ToolCallPart):
-            logger.debug("Receiving wire message: {msg}", msg=msg)
-        return msg
-
-    def shutdown(self) -> None:
-        self._queue.shutdown()
-
-
-current_wire = ContextVar[Wire | None]("current_wire", default=None)
-
-
-def get_wire_or_none() -> Wire | None:
-    """
-    Get the current wire or None.
-    Expect to be not None when called from anywhere in the agent loop.
-    """
-    return current_wire.get()