sahya-code 1.0.0__tar.gz

sahya_code-1.0.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.3
+Name: sahya-code
+Version: 1.0.0
+Summary: Sahya Code - Your AI coding companion.
+Requires-Dist: agent-client-protocol==0.8.0
+Requires-Dist: aiofiles>=24.0,<26.0
+Requires-Dist: aiohttp==3.13.3
+Requires-Dist: typer==0.21.1
+Requires-Dist: kosong[contrib]==0.47.0
+Requires-Dist: loguru>=0.6.0,<0.8
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: pillow==12.1.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: lxml==6.0.2
+Requires-Dist: tenacity==9.1.2
+Requires-Dist: fastmcp==2.12.5
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Dist: pykaos==0.7.0
+Requires-Dist: batrachian-toad==0.5.23 ; python_full_version >= '3.14'
+Requires-Dist: tomlkit==0.14.0
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: pyobjc-framework-cocoa>=12.1 ; sys_platform == 'darwin'
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Requires-Dist: scalar-fastapi>=1.5.0
+Requires-Dist: websockets>=14.0
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: setproctitle>=1.3.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Sahya Code
+
+Sahya Code is a CLI-based AI coding agent that helps you write, edit, and understand code through natural language interaction. It is a customized fork of [kimi-cli](https://github.com/MoonshotAI/kimi-cli), pre-configured to work with LiteLLM endpoints.
+
+## Features
+
+- 🤖 AI-powered coding assistance
+- 📝 Code reading, writing, and editing
+- 🔍 Web search and fetch capabilities
+- 🐚 Shell command execution
+- 🔧 Extensible tool system with MCP support
+- 💻 Terminal UI with rich formatting
+- 🌐 Web interface for browser-based interaction
+
+## Installation
+
+```bash
+pip install sahya-code
+```
+
+## Configuration
+
+### API Key
+
+Set your API key as an environment variable:
+
+```bash
+export SAHYA_API_KEY="sk-VBkuXAOO7e2kV5-uWpz84A"
+```
+
+Or configure interactively on first run using the setup wizard.
+
+### Custom Endpoint
+
+Sahya Code uses a LiteLLM-compatible endpoint by default:
+- **URL:** `https://llm.nexiant.ai`
+- **Protocol:** OpenAI-compatible API
+
+To use a different endpoint:
+
+```bash
+export SAHYA_BASE_URL="https://your-endpoint.com"
+```
+
+### Configuration File
+
+You can also configure via the config file at `~/.local/share/sahya-code/config.toml`:
+
+```toml
+default_model = "default"
+
+[models.default]
+provider = "sahya"
+model = "kimi-k2.5"
+max_context_size = 256000
+capabilities = ["image_in", "thinking"]
+
+[providers.sahya]
+type = "openai_legacy"
+base_url = "https://llm.nexiant.ai"
+api_key = "sk-VBkuXAOO7e2kV5-uWpz84A"
+```
+
+## Usage
+
+Start Sahya Code:
+
+```bash
+sahya
+```
+
+Or with a specific prompt:
+
+```bash
+sahya "Explain this codebase to me"
+```
+
+### Available Commands
+
+```bash
+sahya --help              # Show help
+sahya --version           # Show version
+sahya web                 # Start web interface
+sahya mcp list            # List MCP servers
+sahya mcp add <name> ...  # Add MCP server
+```
+
+### Interactive Commands
+
+Once in the shell, you can use:
+
+- `Ctrl+X` - Toggle between agent mode and shell mode
+- `/help` - Show available slash commands
+- `/exit` or `Ctrl+D` - Exit
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SAHYA_API_KEY` | API key for authentication | Required |
+| `SAHYA_BASE_URL` | LiteLLM endpoint URL | `https://llm.nexiant.ai` |
+| `SAHYA_SHARE_DIR` | Config and data directory | `~/.local/share/sahya-code` |
+| `SAHYA_CACHE_DIR` | Cache directory | `~/.cache/sahya-code` |
+
+## Documentation
+
+- [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture and design
+- [CHANGELOG.md](CHANGELOG.md) - Version history
+- [TODOLIST.md](TODOLIST.md) - Development roadmap
+
+## Requirements
+
+- Python 3.12 or higher
+- API key for the LiteLLM endpoint
+
+## Acknowledgments
+
+Sahya Code is based on [kimi-cli](https://github.com/MoonshotAI/kimi-cli) by Moonshot AI.
+
+## License
+
+[Apache License 2.0](LICENSE)

sahya_code-1.0.0/README.md

@@ -0,0 +1,122 @@
+# Sahya Code
+
+Sahya Code is a CLI-based AI coding agent that helps you write, edit, and understand code through natural language interaction. It is a customized fork of [kimi-cli](https://github.com/MoonshotAI/kimi-cli), pre-configured to work with LiteLLM endpoints.
+
+## Features
+
+- 🤖 AI-powered coding assistance
+- 📝 Code reading, writing, and editing
+- 🔍 Web search and fetch capabilities
+- 🐚 Shell command execution
+- 🔧 Extensible tool system with MCP support
+- 💻 Terminal UI with rich formatting
+- 🌐 Web interface for browser-based interaction
+
+## Installation
+
+```bash
+pip install sahya-code
+```
+
+## Configuration
+
+### API Key
+
+Set your API key as an environment variable:
+
+```bash
+export SAHYA_API_KEY="sk-VBkuXAOO7e2kV5-uWpz84A"
+```
+
+Or configure interactively on first run using the setup wizard.
+
+### Custom Endpoint
+
+Sahya Code uses a LiteLLM-compatible endpoint by default:
+- **URL:** `https://llm.nexiant.ai`
+- **Protocol:** OpenAI-compatible API
+
+To use a different endpoint:
+
+```bash
+export SAHYA_BASE_URL="https://your-endpoint.com"
+```
+
+### Configuration File
+
+You can also configure via the config file at `~/.local/share/sahya-code/config.toml`:
+
+```toml
+default_model = "default"
+
+[models.default]
+provider = "sahya"
+model = "kimi-k2.5"
+max_context_size = 256000
+capabilities = ["image_in", "thinking"]
+
+[providers.sahya]
+type = "openai_legacy"
+base_url = "https://llm.nexiant.ai"
+api_key = "sk-VBkuXAOO7e2kV5-uWpz84A"
+```
+
+## Usage
+
+Start Sahya Code:
+
+```bash
+sahya
+```
+
+Or with a specific prompt:
+
+```bash
+sahya "Explain this codebase to me"
+```
+
+### Available Commands
+
+```bash
+sahya --help              # Show help
+sahya --version           # Show version
+sahya web                 # Start web interface
+sahya mcp list            # List MCP servers
+sahya mcp add <name> ...  # Add MCP server
+```
+
+### Interactive Commands
+
+Once in the shell, you can use:
+
+- `Ctrl+X` - Toggle between agent mode and shell mode
+- `/help` - Show available slash commands
+- `/exit` or `Ctrl+D` - Exit
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SAHYA_API_KEY` | API key for authentication | Required |
+| `SAHYA_BASE_URL` | LiteLLM endpoint URL | `https://llm.nexiant.ai` |
+| `SAHYA_SHARE_DIR` | Config and data directory | `~/.local/share/sahya-code` |
+| `SAHYA_CACHE_DIR` | Cache directory | `~/.cache/sahya-code` |
+
+## Documentation
+
+- [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture and design
+- [CHANGELOG.md](CHANGELOG.md) - Version history
+- [TODOLIST.md](TODOLIST.md) - Development roadmap
+
+## Requirements
+
+- Python 3.12 or higher
+- API key for the LiteLLM endpoint
+
+## Acknowledgments
+
+Sahya Code is based on [kimi-cli](https://github.com/MoonshotAI/kimi-cli) by Moonshot AI.
+
+## License
+
+[Apache License 2.0](LICENSE)

sahya_code-1.0.0/pyproject.toml

@@ -0,0 +1,122 @@
+[project]
+name = "sahya-code"
+version = "1.0.0"
+description = "Sahya Code - Your AI coding companion."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "agent-client-protocol==0.8.0",
+    "aiofiles>=24.0,<26.0",
+    "aiohttp==3.13.3",
+    "typer==0.21.1",
+    "kosong[contrib]==0.47.0",
+    "loguru>=0.6.0,<0.8",
+    "prompt-toolkit==3.0.52",
+    "pillow==12.1.0",
+    "pyyaml==6.0.3",
+    "rich==14.2.0",
+    "ripgrepy==2.2.0",
+    "streamingjson==0.0.5",
+    "trafilatura==2.0.0",
+    "lxml==6.0.2",
+    "tenacity==9.1.2",
+    "fastmcp==2.12.5",
+    "pydantic==2.12.5",
+    "httpx[socks]==0.28.1",
+    "pykaos==0.7.0",
+    "batrachian-toad==0.5.23; python_version >= \"3.14\"",
+    "tomlkit==0.14.0",
+    "jinja2==3.1.6",
+    "pyobjc-framework-cocoa>=12.1 ; sys_platform == \"darwin\"",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "scalar-fastapi>=1.5.0",
+    "websockets>=14.0",
+    "keyring>=25.7.0",
+    "setproctitle>=1.3.0",
+]
+
+[dependency-groups]
+dev = [
+    "pyinstaller==6.18.0",
+    "inline-snapshot[black]>=0.31.1",
+    "pyright>=1.1.407",
+    "ty>=0.0.9",
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.3.0",
+    "ruff>=0.14.10",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.5,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = ["sahya_code"]
+source-exclude = ["examples/**/*", "tests/**/*", "src/sahya_code/deps/**/*"]
+
+[tool.uv.workspace]
+members = [
+    "packages/kosong",
+    "packages/kaos",
+    "packages/kimi-code",
+    "sdks/kimi-sdk",
+]
+
+[tool.uv.sources]
+kosong = { workspace = true }
+pykaos = { workspace = true }
+sahya-code = { workspace = true }
+
+[project.scripts]
+sahya = "sahya_code.__main__:main"
+sahya-code = "sahya_code.__main__:main"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "UP",
+    "B",
+    "SIM",
+    "I",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["E501"]
+"tests_e2e/**/*.py" = ["E501"]
+"src/sahya_code/web/api/**/*.py" = ["B008"]
+
+[tool.pyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.14"
+include = [
+    "src/**/*.py",
+    "tests/**/*.py",
+    "tests_ai/scripts/**/*.py",
+    "tests_e2e/**/*.py",
+]
+strict = ["src/sahya_code/**/*.py"]
+
+[tool.ty.environment]
+python-version = "3.14"
+
+[tool.ty.src]
+include = [
+    "src/**/*.py",
+    "tests/**/*.py",
+    "tests_ai/scripts/**/*.py",
+    "tests_e2e/**/*.py",
+]
+
+[tool.typos.files]
+extend-exclude = ["kimi.spec", "pyinstaller.py"]
+
+[tool.typos.default.extend-words]
+datas = "datas"
+Seeked = "Seeked"
+seeked = "seeked"
+iterm = "iterm"

sahya_code-1.0.0/src/sahya_code/CHANGELOG.md

@@ -0,0 +1,108 @@
+# Changelog
+
+All notable changes to Sahya Code will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-04-01
+
+### Added
+- Initial release based on kimi-cli v1.28.0
+- Custom LiteLLM endpoint support (https://llm.nexiant.ai)
+- API key authentication via SAHYA_API_KEY environment variable
+- Full rebranding from Kimi Code CLI to Sahya Code
+- Pre-configured OpenAI-compatible provider for LiteLLM proxy
+- Support for SAHYA_BASE_URL environment variable
+
+### Changed
+- **Package name:** `kimi-cli` → `sahya-code`
+- **Module name:** `kimi_cli` → `sahya_code`
+- **CLI command:** `kimi` → `sahya`
+- **Config directory:** `~/.local/share/kimi` → `~/.local/share/sahya-code`
+- **Log file:** `kimi.log` → `sahya.log`
+- **Environment variable prefix:** `KIMI_*` → `SAHYA_*`
+- **Main class:** `KimiCLI` → `SahyaCode`
+- **Soul class:** `KimiSoul` → `SahyaSoul`
+- **User agent:** `KimiCLI/*` → `SahyaCode/*`
+- **Application name:** "Kimi Code CLI" → "Sahya Code"
+
+### Configuration
+
+#### Default Provider
+- Type: `openai_legacy` (OpenAI-compatible API for LiteLLM)
+- Endpoint: `https://llm.nexiant.ai`
+- Default Model: `kimi-k2.5`
+- Authentication: API key via `SAHYA_API_KEY`
+
+#### Environment Variables
+- `SAHYA_API_KEY` - API key for authentication (required)
+- `SAHYA_BASE_URL` - Endpoint URL override (optional)
+- `SAHYA_SHARE_DIR` - Custom share directory (optional)
+- `SAHYA_CACHE_DIR` - Custom cache directory (optional)
+
+#### Config File Location
+- Default: `~/.local/share/sahya-code/config.toml`
+- Format: TOML (JSON also supported)
+
+### Removed
+- Kimi-specific default configurations
+- Moonshot AI-specific provider defaults
+- Kimi-specific environment variable fallbacks
+
+### Dependencies
+Same as kimi-cli v1.28.0:
+- Python >= 3.12
+- kosong[contrib] == 0.47.0
+- pydantic == 2.12.5
+- typer == 0.21.1
+- And other dependencies (see pyproject.toml)
+
+## Original kimi-cli History
+
+For complete history of the original project, see:
+https://github.com/MoonshotAI/kimi-cli/blob/main/CHANGELOG.md
+
+---
+
+## Migration Guide
+
+### From kimi-cli to sahya-code
+
+1. **Uninstall kimi-cli:**
+   ```bash
+   pip uninstall kimi-cli
+   ```
+
+2. **Install sahya-code:**
+   ```bash
+   pip install sahya-code
+   ```
+
+3. **Update environment variables:**
+   ```bash
+   # Old
+   export KIMI_API_KEY="..."
+   
+   # New
+   export SAHYA_API_KEY="..."
+   ```
+
+4. **Migrate configuration:**
+   ```bash
+   # Copy old config (optional)
+   mkdir -p ~/.local/share/sahya-code
+   cp ~/.local/share/kimi/config.toml ~/.local/share/sahya-code/config.toml
+   
+   # Update config values
+   sed -i '' 's/kimi/sahya/g' ~/.local/share/sahya-code/config.toml
+   ```
+
+5. **Update aliases:**
+   ```bash
+   # Old
+   alias ai='kimi'
+   
+   # New
+   alias ai='sahya'
+   ```

sahya_code-1.0.0/src/sahya_code/__init__.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from typing import Any, cast
+
+
+class _LazyLogger:
+    """Import loguru only when logging is actually used."""
+
+    def __init__(self) -> None:
+        self._logger: Any | None = None
+
+    def _get(self) -> Any:
+        if self._logger is None:
+            from loguru import logger as real_logger
+
+            # Disable logging by default for library usage.
+            # Application entry points (e.g., sahya_code.cli) should call logger.enable("sahya_code")
+            # to enable logging.
+            real_logger.disable("sahya_code")
+            self._logger = real_logger
+        return self._logger
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._get(), name)
+
+
+logger = cast(Any, _LazyLogger())
+
+__all__ = ["logger"]

sahya_code-1.0.0/src/sahya_code/__main__.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+import sys
+from collections.abc import Sequence
+from pathlib import Path
+
+
+def _prog_name() -> str:
+    return Path(sys.argv[0]).name or "sahya"
+
+
+def main(argv: Sequence[str] | None = None) -> int | str | None:
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if len(args) == 1 and args[0] in {"--version", "-V"}:
+        from sahya_code.constant import get_version
+
+        print(f"sahya, version {get_version()}")
+        return 0
+
+    from sahya_code.cli import cli
+
+    try:
+        return cli(args=args, prog_name=_prog_name())
+    except SystemExit as exc:
+        return exc.code
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sahya_code-1.0.0/src/sahya_code/acp/AGENTS.md

@@ -0,0 +1,92 @@
+# ACP Integration Notes (kimi-cli)
+
+## Protocol summary (ACP overview)
+- ACP is JSON-RPC 2.0 with request/response methods plus one-way notifications.
+- Typical flow: `initialize` -> optional `authenticate` -> `session/new` or `session/load`
+  -> `session/prompt`
+  with `session/update` notifications and optional `session/cancel`.
+- Clients provide `session/request_permission` and optional terminal/filesystem methods.
+- All ACP file paths must be absolute; line numbers are 1-based.
+
+## Entry points and server modes
+- **Single-session server**: `KimiCLI.run_acp()` uses `ACP` -> `ACPServerSingleSession`.
+  - Code: `src/kimi_cli/app.py`, `src/kimi_cli/ui/acp/__init__.py`.
+  - Used when running CLI with `--acp` UI mode.
+- **Multi-session server**: `acp_main()` runs `ACPServer` with `use_unstable_protocol=True`.
+  - Code: `src/kimi_cli/acp/__init__.py`, `src/kimi_cli/acp/server.py`.
+  - Exposed via the `kimi acp` command in `src/kimi_cli/cli/__init__.py`.
+
+## Capabilities advertised
+- `prompt_capabilities`: `embedded_context=False`, `image=True`, `audio=False`.
+- `mcp_capabilities`: `http=True`, `sse=False`.
+- Single-session: `load_session=False`, no session list capabilities.
+- Multi-session: `load_session=True`, `session_capabilities.list` supported.
+- `auth_methods=[]` (no authentication methods advertised).
+
+## Session lifecycle (implemented behavior)
+- `session/new`
+  - Multi-session: creates a persisted `Session`, builds `KimiCLI`, stores `ACPSession`.
+  - Single-session: wraps the existing `Soul` into a `Wire` loop and creates `ACPSession`.
+  - Both send `AvailableCommandsUpdate` for slash commands on session creation.
+  - MCP servers passed by ACP are converted via `acp_mcp_servers_to_mcp_config`.
+- `session/load`
+  - Multi-session only: loads by `Session.find`, then builds `KimiCLI` and `ACPSession`.
+  - No history replay yet (TODO).
+  - Single-session: not implemented.
+- `session/list`
+  - Multi-session only: lists sessions via `Session.list`, no pagination.
+  - Single-session: not implemented.
+- `session/prompt`
+  - Uses `ACPSession.prompt()` to stream updates and produce a `stop_reason`.
+  - Stop reasons: `end_turn`, `max_turn_requests`, `cancelled`.
+- `session/cancel`
+  - Sets the per-turn cancel event to stop the prompt.
+
+## Streaming updates and content mapping
+- Text chunks -> `AgentMessageChunk`.
+- Think chunks -> `AgentThoughtChunk`.
+- Tool calls:
+  - Start -> `ToolCallStart` with JSON args as text content.
+  - Streaming args -> `ToolCallProgress` with updated title/args.
+  - Results -> `ToolCallProgress` with `completed` or `failed`.
+  - Tool call IDs are prefixed with turn ID to avoid collisions across turns.
+- Plan updates:
+  - `TodoDisplayBlock` is converted into `AgentPlanUpdate`.
+- Available commands:
+  - `AvailableCommandsUpdate` is sent right after session creation.
+
+## Prompt/content conversion
+- Incoming prompt blocks:
+  - Supported: `TextContentBlock`, `ImageContentBlock` (converted to data URL).
+  - Unsupported types are logged and ignored.
+- Tool result display blocks:
+  - `DiffDisplayBlock` -> `FileEditToolCallContent`.
+  - `HideOutputDisplayBlock` suppresses tool output in ACP (used by terminal tool).
+
+## Tool integration and permission flow
+- ACP sessions use `ACPKaos` to route filesystem reads/writes through ACP clients.
+- If the client advertises `terminal` capability, the `Shell` tool is replaced by an
+  ACP-backed `Terminal` tool.
+  - Uses ACP `terminal/create`, waits for exit, streams `TerminalToolCallContent`,
+    then releases the terminal handle.
+- Approval requests in the core tool system are bridged to ACP
+  `session/request_permission` with allow-once/allow-always/reject options.
+
+## Current gaps / not implemented
+- `authenticate` method (not used by current Zed ACP client).
+- `session/set_mode` and `session/set_model` (no multi-mode/model switching in kimi-cli).
+- `ext_method` / `ext_notification` for custom ACP extensions are stubbed.
+- Single-session server does not implement `session/load` or `session/list`.
+
+## Filesystem (ACP client-backed)
+- When the client advertises `fs.readTextFile` / `fs.writeTextFile`, `ACPKaos` routes
+  reads and writes through ACP `fs/*` methods.
+- `ReadFile` uses `KaosPath.read_lines`, which `ACPKaos` implements via ACP reads.
+- `ReadMediaFile` uses `KaosPath.read_bytes` to load image/video payloads through ACP reads.
+- `WriteFile` uses `KaosPath.read_text/write_text/append_text` and still generates diffs
+  and approvals in the tool layer.
+
+## Zed-specific notes (as of current integration)
+- Zed does not currently call `authenticate`.
+- Zed’s external agent server session management is not yet available, so
+  `session/load` is not exercised in practice.

sahya_code-1.0.0/src/sahya_code/acp/__init__.py

@@ -0,0 +1,13 @@
+def acp_main() -> None:
+    """Entry point for the multi-session ACP server."""
+    import asyncio
+
+    import acp
+
+    from sahya_code.acp.server import ACPServer
+    from sahya_code.app import enable_logging
+    from sahya_code.utils.logging import logger
+
+    enable_logging()
+    logger.info("Starting ACP server on stdio")
+    asyncio.run(acp.run_agent(ACPServer(), use_unstable_protocol=True))