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

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

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 2.22.0
+Version: 2.24.0
 Summary: Minimal code agent CLI
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: chardet>=5.2.0,<6
-Requires-Dist: ddgs>=9.9.3
 Requires-Dist: diff-match-patch>=20241021
 Requires-Dist: filelock>=3.20.3
+Requires-Dist: fastapi
 Requires-Dist: google-genai>=1.56.0
 Requires-Dist: markdown-it-py>=4.0.0
 Requires-Dist: openai>=2.24.0
@@ -15,8 +15,11 @@ Requires-Dist: pydantic>=2.11.7
 Requires-Dist: python-socks>=2.8.1
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=14.1.0
+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
 
@@ -57,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
@@ -96,7 +118,8 @@ export OPENAI_API_KEY=sk-xxx             # GPT models
 export OPENROUTER_API_KEY=sk-or-xxx      # OpenRouter (multi-provider)
 export DEEPSEEK_API_KEY=sk-xxx           # DeepSeek models
 export MOONSHOT_API_KEY=sk-xxx           # Moonshot/Kimi models
-export BRAVE_API_KEY=BSA-xxx             # Brave Search (optional, enhances web search)
+export BRAVE_API_KEY=BSA-xxx             # Brave Search (optional, WebSearch provider)
+export EXA_API_KEY=exa-xxx               # Exa Search (optional, WebSearch provider)
 
 # Then just run:
 klaude
@@ -104,16 +127,39 @@ klaude
 
 On first run, you'll be prompted to select a model. Your choice is saved as `main_model`.
 
+You can also configure fallback lists for helper models:
+
+```yaml
+fast_model:
+  - haiku
+  - gemini-flash
+  - gpt-5-nano
+
+compact_model:
+  - gemini-flash
+  - haiku
+```
+
+Klaude tries these entries in order and uses the first available model. `fast_model` is used for session-title generation; `compact_model` is used for compact/helper tasks.
+
 #### Built-in Providers
 
-| Provider    | Env Variable          | Models                                                                        |
-|-------------|-----------------------|-------------------------------------------------------------------------------|
-| anthropic   | `ANTHROPIC_API_KEY`   | sonnet, opus                                                                  |
-| openai      | `OPENAI_API_KEY`      | gpt-5.2                                                                       |
-| openrouter  | `OPENROUTER_API_KEY`  | gpt-5.2, gpt-5.2-fast, gpt-5.1-codex-max, sonnet, opus, haiku, kimi, gemini-* |
-| deepseek    | `DEEPSEEK_API_KEY`    | deepseek                                                                      |
-| moonshot    | `MOONSHOT_API_KEY`    | kimi@moonshot                                                                 |
-| codex       | N/A (OAuth)           | gpt-5.2-codex (requires ChatGPT Pro subscription)                             |
+| Provider         | Env Variable                                                                 | Models                                                                                                   |
+|------------------|------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| anthropic        | `ANTHROPIC_API_KEY`                                                          | sonnet, sonnet-no-thinking, opus, haiku                                                                 |
+| openai           | `OPENAI_API_KEY`                                                             | gpt-5.4-high, gpt-5.4-xhigh, gpt-5.3-codex, gpt-5.3-codex-xhigh                                         |
+| openrouter       | `OPENROUTER_API_KEY`                                                         | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh, kimi, haiku, sonnet, sonnet-no-thinking, opus, gemini-pro, gemini-flash, grok, minimax, glm |
+| google           | `GOOGLE_API_KEY` or `GEMINI_API_KEY`                                         | gemini-pro, gemini-flash                                                                                |
+| google-vertex    | `GOOGLE_APPLICATION_CREDENTIALS`, `GOOGLE_CLOUD_PROJECT`, `GOOGLE_CLOUD_LOCATION` | gemini-pro, gemini-flash                                                                                |
+| bedrock          | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`                   | sonnet                                                                                                   |
+| deepseek         | `DEEPSEEK_API_KEY`                                                           | deepseek                                                                                                 |
+| moonshot         | `MOONSHOT_API_KEY`                                                           | kimi                                                                                                     |
+| cerebras         | `CEREBRAS_API_KEY`                                                           | glm                                                                                                      |
+| claude-max       | N/A (OAuth)                                             | sonnet, sonnet-no-thinking, opus, haiku                                                                 |
+| codex            | N/A (OAuth)                                                                  | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh   |
+| github-copilot   | N/A (OAuth)                                                                  | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh, sonnet, sonnet-4.5, haiku, opus       |
+| ark-api          | `ARK_API_KEY`                                                                | seed-pro, seed-code                                                                                      |
+| ark-coding-plan  | `ARK_API_KEY`                                                                | seed-code, kimi                                                                                          |
 
 List all configured providers and models:
 
@@ -167,6 +213,17 @@ You can add custom models to built-in providers or define new ones. Configuratio
 
 ```yaml
 # ~/.klaude/klaude-config.yaml
+main_model: opus
+
+fast_model:
+  - haiku
+  - gemini-flash
+  - gpt-5-nano
+
+compact_model:
+  - gemini-flash
+  - haiku
+
 provider_list:
   # Add/Override models for built-in OpenRouter provider
   - provider_name: openrouter
@@ -196,6 +253,7 @@ provider_list:
 - **Merging**: If `provider_name` matches a built-in provider, settings like `protocol` and `api_key` are inherited.
 - **Overriding**: Use the same `model_name` as a built-in model to override its parameters.
 - **Environment Variables**: Use `${VAR_NAME}` syntax for secrets.
+- **Model Preference Lists**: `fast_model` and `compact_model` accept either a single string or a list of model selectors. When you provide a list, Klaude tries them in order and picks the first available one.
 
 ##### Sub-agent Model Configuration
 

{klaude_code-2.22.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
@@ -74,7 +93,8 @@ export OPENAI_API_KEY=sk-xxx             # GPT models
 export OPENROUTER_API_KEY=sk-or-xxx      # OpenRouter (multi-provider)
 export DEEPSEEK_API_KEY=sk-xxx           # DeepSeek models
 export MOONSHOT_API_KEY=sk-xxx           # Moonshot/Kimi models
-export BRAVE_API_KEY=BSA-xxx             # Brave Search (optional, enhances web search)
+export BRAVE_API_KEY=BSA-xxx             # Brave Search (optional, WebSearch provider)
+export EXA_API_KEY=exa-xxx               # Exa Search (optional, WebSearch provider)
 
 # Then just run:
 klaude
@@ -82,16 +102,39 @@ klaude
 
 On first run, you'll be prompted to select a model. Your choice is saved as `main_model`.
 
+You can also configure fallback lists for helper models:
+
+```yaml
+fast_model:
+  - haiku
+  - gemini-flash
+  - gpt-5-nano
+
+compact_model:
+  - gemini-flash
+  - haiku
+```
+
+Klaude tries these entries in order and uses the first available model. `fast_model` is used for session-title generation; `compact_model` is used for compact/helper tasks.
+
 #### Built-in Providers
 
-| Provider    | Env Variable          | Models                                                                        |
-|-------------|-----------------------|-------------------------------------------------------------------------------|
-| anthropic   | `ANTHROPIC_API_KEY`   | sonnet, opus                                                                  |
-| openai      | `OPENAI_API_KEY`      | gpt-5.2                                                                       |
-| openrouter  | `OPENROUTER_API_KEY`  | gpt-5.2, gpt-5.2-fast, gpt-5.1-codex-max, sonnet, opus, haiku, kimi, gemini-* |
-| deepseek    | `DEEPSEEK_API_KEY`    | deepseek                                                                      |
-| moonshot    | `MOONSHOT_API_KEY`    | kimi@moonshot                                                                 |
-| codex       | N/A (OAuth)           | gpt-5.2-codex (requires ChatGPT Pro subscription)                             |
+| Provider         | Env Variable                                                                 | Models                                                                                                   |
+|------------------|------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
+| anthropic        | `ANTHROPIC_API_KEY`                                                          | sonnet, sonnet-no-thinking, opus, haiku                                                                 |
+| openai           | `OPENAI_API_KEY`                                                             | gpt-5.4-high, gpt-5.4-xhigh, gpt-5.3-codex, gpt-5.3-codex-xhigh                                         |
+| openrouter       | `OPENROUTER_API_KEY`                                                         | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh, kimi, haiku, sonnet, sonnet-no-thinking, opus, gemini-pro, gemini-flash, grok, minimax, glm |
+| google           | `GOOGLE_API_KEY` or `GEMINI_API_KEY`                                         | gemini-pro, gemini-flash                                                                                |
+| google-vertex    | `GOOGLE_APPLICATION_CREDENTIALS`, `GOOGLE_CLOUD_PROJECT`, `GOOGLE_CLOUD_LOCATION` | gemini-pro, gemini-flash                                                                                |
+| bedrock          | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`                   | sonnet                                                                                                   |
+| deepseek         | `DEEPSEEK_API_KEY`                                                           | deepseek                                                                                                 |
+| moonshot         | `MOONSHOT_API_KEY`                                                           | kimi                                                                                                     |
+| cerebras         | `CEREBRAS_API_KEY`                                                           | glm                                                                                                      |
+| claude-max       | N/A (OAuth)                                             | sonnet, sonnet-no-thinking, opus, haiku                                                                 |
+| codex            | N/A (OAuth)                                                                  | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh   |
+| github-copilot   | N/A (OAuth)                                                                  | gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.4-high, gpt-5.4-xhigh, sonnet, sonnet-4.5, haiku, opus       |
+| ark-api          | `ARK_API_KEY`                                                                | seed-pro, seed-code                                                                                      |
+| ark-coding-plan  | `ARK_API_KEY`                                                                | seed-code, kimi                                                                                          |
 
 List all configured providers and models:
 
@@ -145,6 +188,17 @@ You can add custom models to built-in providers or define new ones. Configuratio
 
 ```yaml
 # ~/.klaude/klaude-config.yaml
+main_model: opus
+
+fast_model:
+  - haiku
+  - gemini-flash
+  - gpt-5-nano
+
+compact_model:
+  - gemini-flash
+  - haiku
+
 provider_list:
   # Add/Override models for built-in OpenRouter provider
   - provider_name: openrouter
@@ -174,6 +228,7 @@ provider_list:
 - **Merging**: If `provider_name` matches a built-in provider, settings like `protocol` and `api_key` are inherited.
 - **Overriding**: Use the same `model_name` as a built-in model to override its parameters.
 - **Environment Variables**: Use `${VAR_NAME}` syntax for secrets.
+- **Model Preference Lists**: `fast_model` and `compact_model` accept either a single string or a list of model selectors. When you provide a list, Klaude tries them in order and picks the first available one.
 
 ##### Sub-agent Model Configuration
 

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

@@ -4,16 +4,16 @@ build-backend = "uv_build"
 
 [project]
 name = "klaude-code"
-version = "2.22.0"
+version = "2.24.0"
 description = "Minimal code agent CLI"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
     "anthropic>=0.66.0",
     "chardet>=5.2.0,<6",
-    "ddgs>=9.9.3",
     "diff-match-patch>=20241021",
     "filelock>=3.20.3",
+    "fastapi",
     "google-genai>=1.56.0",
     "markdown-it-py>=4.0.0",
     "openai>=2.24.0",
@@ -22,8 +22,11 @@ dependencies = [
     "python-socks>=2.8.1",
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
+    "sse-starlette",
     "trafilatura>=2.0.0",
     "typer>=0.17.3",
+    "uvicorn",
+    "readability-lxml>=0.8.4.1",
 ]
 
 [project.scripts]
@@ -32,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 = [
@@ -40,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",
 ]
@@ -47,6 +54,7 @@ dev = [
 
 
 [tool.pytest.ini_options]
+timeout = 30
 markers = [
     "network: marks tests as requiring network access (deselect with '-m \"not network\"')",
 ]
@@ -54,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"]
@@ -72,7 +81,9 @@ reportMissingImports = "warning"
 reportMissingModuleSource = "warning"
 exclude = [
     ".venv/",
-    "src/klaude_code/skill/assets/**/scripts/",
+    ".pnpm-store/",
+    "web/node_modules/",
+    "src/klaude_code/skill/assets/",
 ]
 
 [[tool.pyright.executionEnvironments]]
@@ -98,8 +109,8 @@ type = "layers"
 layers = [
     "klaude_code.cli",
     "klaude_code.tui",
+    "klaude_code.web",
     "klaude_code.app",
-    "klaude_code.ui",
     "klaude_code.core",
     "klaude_code.skill",
     "klaude_code.session",

{klaude_code-2.22.0 → klaude_code-2.24.0}/src/klaude_code/app/__init__.py

@@ -1,6 +1,6 @@
 """Application-layer runtime helpers.
 
-This package coordinates core execution (Executor) with frontend displays.
+This package coordinates core execution (RuntimeFacade) with frontend displays.
 Terminal-specific rendering and input handling live in `klaude_code.tui`.
 """
 

{klaude_code-2.22.0 → klaude_code-2.24.0}/src/klaude_code/app/log_viewer.html

@@ -201,6 +201,8 @@ body {
 .log-line .dtype-RESPONSE { color: #5b21b6; background: #ede9fe; }
 .log-line .dtype-EXECUTION { color: #0f766e; background: #ccfbf1; }
 .log-line .dtype-TERMINAL { color: #be123c; background: #ffe4e6; }
+.log-line .dtype-OPERATION { color: #1e1b4b; background: #e0e7ff; }
+.log-line .dtype-EVENT_BUS { color: #6d28d9; background: #f3e8ff; }
 .log-line .msg { color: var(--fg-secondary); }
 .log-line .json-inline { color: var(--fg-tertiary); }
 .log-line .lineno {
@@ -233,11 +235,14 @@ body {
 #right {
   width: 50%;
   min-width: 300px;
-  display: flex;
+  display: none;
   flex-direction: column;
   background: var(--bg-surface);
   border-left: 1px solid var(--border);
 }
+#right.open {
+  display: flex;
+}
 #right-toolbar {
   display: flex;
   align-items: center;
@@ -380,6 +385,7 @@ body {
 
 /* Resize handle */
 #resize-handle {
+  display: none;
   width: 4px;
   cursor: col-resize;
   background: transparent;
@@ -391,6 +397,7 @@ body {
   margin-left: -2px;
   margin-right: -2px;
 }
+#resize-handle.open { display: block; }
 #resize-handle:hover, #resize-handle.dragging { background: var(--border-strong); }
 </style>
 </head>
@@ -413,6 +420,7 @@ body {
       <button class="action-btn" id="btn-expand-all" title="Expand all">Expand All</button>
       <button class="action-btn" id="btn-collapse-all" title="Collapse all">Collapse All</button>
       <button class="action-btn" id="btn-raw" title="Toggle raw text">Raw</button>
+      <button class="action-btn" id="btn-close-panel" title="Close panel" style="padding:4px 8px;">&#x2715;</button>
     </div>
     <div id="json-view"><span class="empty-hint">Select a log line to view details</span></div>
   </div>
@@ -420,8 +428,8 @@ body {
 
 <script>
 const LOG_RE = /^\[([^\]]+)\]\s+(\S+)\s+(.*)/;
-const ALL_TYPES = ['GENERAL','LLM_CONFIG','LLM_PAYLOAD','LLM_STREAM','UI_EVENT','RESPONSE','EXECUTION','TERMINAL'];
-const DEFAULT_FILTERS = new Set(['LLM_CONFIG','LLM_PAYLOAD','LLM_STREAM']);
+const ALL_TYPES = ['GENERAL','LLM_CONFIG','LLM_PAYLOAD','LLM_STREAM','OPERATION','EVENT_BUS','UI_EVENT','RESPONSE','EXECUTION','TERMINAL'];
+const DEFAULT_FILTERS = new Set(['LLM_CONFIG','LLM_PAYLOAD','LLM_STREAM','OPERATION']);
 
 let logLines = [];
 let selectedIdx = -1;
@@ -436,7 +444,7 @@ function setViewerMode(mode) {
   document.getElementById('btn-back-list').style.display = isLogMode ? '' : 'none';
   document.getElementById('search-box').style.display = isLogMode ? '' : 'none';
   document.getElementById('filter-group').style.display = isLogMode ? '' : 'none';
-  for (const id of ['btn-copy', 'btn-expand-all', 'btn-collapse-all', 'btn-raw']) {
+  for (const id of ['btn-copy', 'btn-expand-all', 'btn-collapse-all', 'btn-raw', 'btn-close-panel']) {
     document.getElementById(id).disabled = !isLogMode;
   }
 }
@@ -651,7 +659,23 @@ function renderLogList() {
   list.appendChild(frag);
 }
 
+function openRightPanel() {
+  document.getElementById('right').classList.add('open');
+  document.getElementById('resize-handle').classList.add('open');
+}
+
+function closeRightPanel() {
+  document.getElementById('right').classList.remove('open');
+  document.getElementById('resize-handle').classList.remove('open');
+  const list = document.getElementById('log-list');
+  if (selectedIdx >= 0 && list.children[selectedIdx]) {
+    list.children[selectedIdx].classList.remove('selected');
+  }
+  selectedIdx = -1;
+}
+
 function selectLine(idx) {
+  openRightPanel();
   const list = document.getElementById('log-list');
   if (selectedIdx >= 0 && list.children[selectedIdx]) {
     list.children[selectedIdx].classList.remove('selected');
@@ -853,6 +877,8 @@ document.getElementById('btn-collapse-all').addEventListener('click', () => {
   });
 });
 
+document.getElementById('btn-close-panel').addEventListener('click', closeRightPanel);
+
 document.getElementById('btn-raw').addEventListener('click', () => {
   if (selectedIdx < 0) return;
   const entry = logLines[selectedIdx];

klaude_code-2.24.0/src/klaude_code/app/ports/__init__.py

@@ -0,0 +1,5 @@
+from .display import DisplayABC
+from .input import InputProviderABC
+from .interaction import InteractionHandlerABC
+
+__all__ = ["DisplayABC", "InputProviderABC", "InteractionHandlerABC"]

klaude_code-2.24.0/src/klaude_code/app/ports/display.py

@@ -0,0 +1,36 @@
+from abc import ABC, abstractmethod
+from asyncio import Queue
+
+from klaude_code.log import log
+from klaude_code.protocol import events
+
+
+class DisplayABC(ABC):
+    @abstractmethod
+    async def consume_envelope(self, envelope: events.EventEnvelope) -> None:
+        pass
+
+    @abstractmethod
+    async def start(self) -> None:
+        pass
+
+    @abstractmethod
+    async def stop(self) -> None:
+        pass
+
+    async def consume_event_loop(self, q: Queue[events.EventEnvelope]) -> None:
+        await self.start()
+        while True:
+            envelope = await q.get()
+            try:
+                if isinstance(envelope.event, events.EndEvent):
+                    await self.stop()
+                    break
+                await self.consume_envelope(envelope)
+            except Exception as e:
+                import traceback
+
+                log(f"Error in consume_event_loop, {e.__class__.__name__}, {e}")
+                log(traceback.format_exc())
+            finally:
+                q.task_done()

klaude_code-2.24.0/src/klaude_code/app/ports/input.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from collections.abc import AsyncIterator
+
+from klaude_code.protocol.message import UserInputPayload
+
+
+class InputProviderABC(ABC):
+    @abstractmethod
+    async def start(self) -> None:
+        pass
+
+    @abstractmethod
+    async def stop(self) -> None:
+        pass
+
+    @abstractmethod
+    async def iter_inputs(self) -> AsyncIterator[UserInputPayload]:
+        raise NotImplementedError
+        yield UserInputPayload(text="")

klaude_code-2.24.0/src/klaude_code/app/ports/interaction.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+from klaude_code.protocol import events, user_interaction
+
+
+class InteractionHandlerABC(ABC):
+    @abstractmethod
+    async def collect_response(
+        self,
+        request_event: events.UserInteractionRequestEvent,
+    ) -> user_interaction.UserInteractionResponse:
+        pass