klaude-code 1.2.26__py3-none-any.whl → 1.2.27__py3-none-any.whl

klaude_code/core/tool/file/edit_tool.py

@@ -88,7 +88,7 @@ class EditTool(ToolABC):
     async def call(cls, arguments: str) -> model.ToolResultItem:
         try:
             args = EditTool.EditArguments.model_validate_json(arguments)
-        except Exception as e:  # pragma: no cover - defensive
+        except ValueError as e:  # pragma: no cover - defensive
             return model.ToolResultItem(status="error", output=f"Invalid arguments: {e}")
 
         file_path = os.path.abspath(args.file_path)
@@ -150,7 +150,7 @@ class EditTool(ToolABC):
                 # Backward-compat: old sessions only stored mtime.
                 try:
                     current_mtime = Path(file_path).stat().st_mtime
-                except Exception:
+                except OSError:
                     current_mtime = tracked_status.mtime
                 if current_mtime != tracked_status.mtime:
                     return model.ToolResultItem(
@@ -188,7 +188,7 @@ class EditTool(ToolABC):
         # Write back
         try:
             await asyncio.to_thread(write_text, file_path, after)
-        except Exception as e:  # pragma: no cover
+        except (OSError, UnicodeError) as e:  # pragma: no cover
             return model.ToolResultItem(status="error", output=f"<tool_use_error>{e}</tool_use_error>")
 
         # Prepare UI extra: unified diff with 3 context lines
@@ -233,7 +233,7 @@ class EditTool(ToolABC):
                     plus_range = plus.split(" ")[0]
                     start = int(plus_range.split(",")[0]) if "," in plus_range else int(plus_range)
                     after_line_no = start - 1
-                except Exception:
+                except (ValueError, IndexError):
                     after_line_no = 0
                 continue
             if line.startswith(" ") or (line.startswith("+") and not line.startswith("+++ ")):

klaude_code/core/tool/file/write_tool.py

@@ -49,7 +49,7 @@ class WriteTool(ToolABC):
     async def call(cls, arguments: str) -> model.ToolResultItem:
         try:
             args = WriteArguments.model_validate_json(arguments)
-        except Exception as e:  # pragma: no cover - defensive
+        except ValueError as e:  # pragma: no cover - defensive
             return model.ToolResultItem(status="error", output=f"Invalid arguments: {e}")
 
         file_path = os.path.abspath(args.file_path)
@@ -79,7 +79,7 @@ class WriteTool(ToolABC):
             try:
                 before = await asyncio.to_thread(read_text, file_path)
                 before_read_ok = True
-            except Exception:
+            except OSError:
                 before = ""
                 before_read_ok = False
 
@@ -98,7 +98,7 @@ class WriteTool(ToolABC):
                 # Backward-compat: old sessions only stored mtime, or we couldn't hash.
                 try:
                     current_mtime = Path(file_path).stat().st_mtime
-                except Exception:
+                except OSError:
                     current_mtime = tracked_status.mtime
                 if current_mtime != tracked_status.mtime:
                     return model.ToolResultItem(
@@ -111,7 +111,7 @@ class WriteTool(ToolABC):
 
         try:
             await asyncio.to_thread(write_text, file_path, args.content)
-        except Exception as e:  # pragma: no cover
+        except (OSError, UnicodeError) as e:  # pragma: no cover
             return model.ToolResultItem(status="error", output=f"<tool_use_error>{e}</tool_use_error>")
 
         if file_tracker is not None:

klaude_code/core/tool/shell/bash_tool.py

@@ -274,7 +274,7 @@ class BashTool(ToolABC):
                     proc.terminate()
             except ProcessLookupError:
                 return
-            except Exception:
+            except OSError:
                 # Fall back to kill below.
                 pass
 
@@ -356,7 +356,7 @@ class BashTool(ToolABC):
         except asyncio.CancelledError:
             # Propagate cooperative cancellation so outer layers can handle interrupts correctly.
             raise
-        except Exception as e:  # safeguard against unexpected failures
+        except OSError as e:  # safeguard: catch remaining OS-level errors (permissions, resources, etc.)
             return model.ToolResultItem(
                 status="error",
                 output=f"Execution error: {e}",

klaude_code/llm/openai_compatible/stream.py

@@ -20,6 +20,7 @@ from typing import Any, Literal, cast
 import httpx
 import openai
 import openai.types
+import pydantic
 from openai import AsyncStream
 from openai.types.chat.chat_completion_chunk import ChatCompletionChunk
 
@@ -204,7 +205,7 @@ async def parse_chat_completions_stream(
                 try:
                     usage = openai.types.CompletionUsage.model_validate(choice_usage)
                     metadata_tracker.set_usage(convert_usage(usage, param.context_limit, param.max_tokens))
-                except Exception:
+                except pydantic.ValidationError:
                     pass
 
             delta = cast(Any, getattr(choice0, "delta", None))

klaude_code/session/export.py

@@ -702,7 +702,7 @@ def _render_sub_agent_session(
 
     try:
         sub_session = Session.load(session_id)
-    except Exception:
+    except (OSError, json.JSONDecodeError, ValueError):
         return None
 
     sub_history = sub_session.conversation_history

klaude_code/session/selector.py

@@ -23,7 +23,7 @@ def resume_select_session() -> str | None:
     def _fmt(ts: float) -> str:
         try:
             return time.strftime("%m-%d %H:%M:%S", time.localtime(ts))
-        except Exception:
+        except (ValueError, OSError):
             return str(ts)
 
     try:
@@ -76,6 +76,6 @@ def resume_select_session() -> str | None:
             idx = int(raw)
             if 1 <= idx <= len(sessions):
                 return str(sessions[idx - 1].id)
-        except Exception:
+        except (ValueError, EOFError):
             return None
     return None

klaude_code/session/session.py

@@ -7,7 +7,7 @@ from collections.abc import Iterable, Sequence
 from pathlib import Path
 from typing import Any, cast
 
-from pydantic import BaseModel, Field, PrivateAttr
+from pydantic import BaseModel, Field, PrivateAttr, ValidationError
 
 from klaude_code.protocol import events, llm_param, model, tools
 from klaude_code.session.store import JsonlSessionStore, ProjectPaths, build_meta_snapshot
@@ -124,7 +124,7 @@ class Session(BaseModel):
                 if isinstance(k, str) and isinstance(v, dict):
                     try:
                         file_tracker[k] = model.FileStatus.model_validate(v)
-                    except Exception:
+                    except ValidationError:
                         continue
 
         todos_raw = raw.get("todos")
@@ -135,7 +135,7 @@ class Session(BaseModel):
                     continue
                 try:
                     todos.append(model.TodoItem.model_validate(todo_raw))
-                except Exception:
+                except ValidationError:
                     continue
 
         created_at = float(raw.get("created_at", time.time()))
@@ -306,7 +306,7 @@ class Session(BaseModel):
         seen_sub_agent_sessions.add(session_id)
         try:
             sub_session = Session.load(session_id)
-        except Exception:
+        except (OSError, json.JSONDecodeError, ValueError):
             return
         yield from sub_session.get_history_item()
 

klaude_code/ui/modes/repl/completers.py

@@ -204,7 +204,7 @@ class _SkillCompleter(Completer):
             from klaude_code.skill import get_available_skills
 
             return get_available_skills()
-        except Exception:
+        except (ImportError, RuntimeError):
             return []
 
     def is_skill_context(self, document: Document) -> bool:
@@ -497,7 +497,7 @@ class _AtFilesCompleter(Completer):
             try:
                 if (cwd / s).is_dir():
                     uniq[idx] = f"{s}/"
-            except Exception:
+            except OSError:
                 continue
         return uniq
 
@@ -530,7 +530,7 @@ class _AtFilesCompleter(Completer):
             if tag != "search":
                 return root, None
             return root, kw
-        except Exception:
+        except ValueError:
             return None, None
 
     # ---- Utilities ----
@@ -680,7 +680,7 @@ class _AtFilesCompleter(Completer):
                 if p.is_dir() and not rel.endswith("/"):
                     rel += "/"
                 items.append(rel)
-        except Exception:
+        except OSError:
             return []
         return items[: min(self._max_results, 100)]
 

klaude_code/ui/modes/repl/event_handler.py

@@ -246,7 +246,7 @@ class SpinnerStatusState:
         """Get current spinner status as rich Text (without context)."""
         activity_text = self._activity.get_activity_text()
 
-        base_status = self._todo_status or self._reasoning_status
+        base_status = self._reasoning_status or self._todo_status
 
         if base_status:
             result = Text(base_status, style=ThemeKey.STATUS_TEXT_BOLD)

klaude_code/ui/modes/repl/input_prompt_toolkit.py

@@ -118,7 +118,7 @@ class PromptToolkitInput(InputProviderABC):
             try:
                 status = self._status_provider()
                 update_message = status.update_message
-            except Exception:
+            except (AttributeError, RuntimeError):
                 pass
 
         # If update available, show only the update message
@@ -127,7 +127,7 @@ class PromptToolkitInput(InputProviderABC):
             try:
                 terminal_width = shutil.get_terminal_size().columns
                 padding = " " * max(0, terminal_width - len(left_text))
-            except Exception:
+            except (OSError, ValueError):
                 padding = ""
             toolbar_text = left_text + padding
             return FormattedText([("#ansiyellow", toolbar_text)])
@@ -151,7 +151,7 @@ class PromptToolkitInput(InputProviderABC):
                 # Add context if available
                 if status.context_usage_percent is not None:
                     right_parts.append(f"context {status.context_usage_percent:.1f}%")
-            except Exception:
+            except (AttributeError, RuntimeError):
                 pass
 
         # Build left and right text with borders
@@ -163,7 +163,7 @@ class PromptToolkitInput(InputProviderABC):
             terminal_width = shutil.get_terminal_size().columns
             used_width = len(left_text) + len(right_text)
             padding = " " * max(0, terminal_width - used_width)
-        except Exception:
+        except (OSError, ValueError):
             padding = ""
 
         # Build result with style

klaude_code/ui/modes/repl/key_bindings.py

@@ -52,7 +52,7 @@ def create_key_bindings(
                 buf.delete_before_cursor()  # remove the sentinel backslash  # type: ignore[reportUnknownMemberType]
                 buf.insert_text("\n")  # type: ignore[reportUnknownMemberType]
                 return
-        except Exception:
+        except (AttributeError, TypeError):
             # Fall through to default behavior if anything goes wrong
             pass
 
@@ -111,7 +111,7 @@ def create_key_bindings(
 
             if should_refresh:
                 buf.start_completion(select_first=False)  # type: ignore[reportUnknownMemberType]
-        except Exception:
+        except (AttributeError, TypeError):
             pass
 
     @kb.add("left")
@@ -136,7 +136,7 @@ def create_key_bindings(
             # Default behavior: move one character left when possible.
             if doc.cursor_position > 0:  # type: ignore[reportUnknownMemberType]
                 buf.cursor_left()  # type: ignore[reportUnknownMemberType]
-        except Exception:
+        except (AttributeError, IndexError, TypeError):
             pass
 
     @kb.add("right")
@@ -163,7 +163,7 @@ def create_key_bindings(
             # Default behavior: move one character right when possible.
             if doc.cursor_position < len(doc.text):  # type: ignore[reportUnknownMemberType]
                 buf.cursor_right()  # type: ignore[reportUnknownMemberType]
-        except Exception:
+        except (AttributeError, IndexError, TypeError):
             pass
 
     return kb

klaude_code/ui/renderers/diffs.py

@@ -148,7 +148,7 @@ def render_diff(diff_text: str, show_file_name: bool = False) -> RenderableType:
                 plus = parts[2]  # like '+12,4'
                 new_start = int(plus[1:].split(",")[0])
                 new_ln = new_start
-            except Exception:
+            except (IndexError, ValueError):
                 new_ln = None
             if has_rendered_diff_content:
                 grid.add_row(Text(f"{'⋮':>{const.DIFF_PREFIX_WIDTH}}", style=ThemeKey.TOOL_RESULT), "")

klaude_code/ui/renderers/metadata.py

@@ -1,4 +1,4 @@
-from importlib.metadata import version
+from importlib.metadata import PackageNotFoundError, version
 
 from rich import box
 from rich.console import Group, RenderableType
@@ -17,7 +17,7 @@ def _get_version() -> str:
     """Get the current version of klaude-code."""
     try:
         return version("klaude-code")
-    except Exception:
+    except PackageNotFoundError:
         return "unknown"
 
 

klaude_code/ui/renderers/tools.py

@@ -18,7 +18,7 @@ from klaude_code.ui.rich.theme import ThemeKey
 
 # Tool markers (Unicode symbols for UI display)
 MARK_GENERIC = "⚒"
-MARK_BASH = "→"
+MARK_BASH = "$"
 MARK_PLAN = "Ξ"
 MARK_READ = "←"
 MARK_EDIT = "±"

klaude_code/ui/rich/markdown.py

@@ -192,7 +192,7 @@ class MarkdownStream:
 
         try:
             tokens = self._parser.parse(text)
-        except Exception:
+        except Exception:  # markdown-it-py may raise various internal errors during parsing
             return 0
 
         top_level: list[Token] = [token for token in tokens if token.level == 0 and token.map is not None]

klaude_code/ui/rich/theme.py

@@ -276,7 +276,7 @@ def get_theme(theme: str | None = None) -> Themes:
                 ThemeKey.RESUME_FLAG.value: "bold reverse " + palette.green,
                 ThemeKey.RESUME_INFO.value: palette.green,
                 # CONFIGURATION DISPLAY
-                ThemeKey.CONFIG_TABLE_HEADER.value: palette.green,
+                ThemeKey.CONFIG_TABLE_HEADER.value: palette.grey1,
                 ThemeKey.CONFIG_STATUS_OK.value: palette.green,
                 ThemeKey.CONFIG_STATUS_PRIMARY.value: palette.yellow,
                 ThemeKey.CONFIG_STATUS_ERROR.value: palette.red,

klaude_code/ui/terminal/color.py

@@ -182,7 +182,7 @@ def _parse_osc_color_response(data: bytes) -> tuple[int, int, int] | None:
 
     try:
         text = data.decode("ascii", errors="ignore")
-    except Exception:
+    except LookupError:  # encoding lookup failure (should not happen with "ascii")
         return None
 
     match = _OSC_BG_REGEX.search(text)

klaude_code/ui/terminal/control.py

@@ -48,7 +48,7 @@ def start_esc_interrupt_monitor(
         try:
             fd = sys.stdin.fileno()
             old = termios.tcgetattr(fd)
-        except Exception as exc:  # pragma: no cover - environment dependent
+        except OSError as exc:  # pragma: no cover - environment dependent
             log((f"esc monitor init error: {exc}", "r red"))
             return
 
@@ -60,7 +60,7 @@ def start_esc_interrupt_monitor(
                     continue
                 try:
                     ch = os.read(fd, 1).decode(errors="ignore")
-                except Exception:
+                except OSError:
                     continue
                 if ch != "\x1b":
                     continue
@@ -71,7 +71,7 @@ def start_esc_interrupt_monitor(
                 while r2:
                     try:
                         seq += os.read(fd, 1).decode(errors="ignore")
-                    except Exception:
+                    except OSError:
                         break
                     r2, _, _ = select.select([sys.stdin], [], [], 0.0)
 
@@ -127,7 +127,7 @@ def install_sigint_double_press_exit(
 
     try:
         signal.signal(signal.SIGINT, _handler)
-    except Exception:  # pragma: no cover - platform dependent
+    except (OSError, ValueError):  # pragma: no cover - platform dependent
         # If installing the handler fails, restore() will be a no-op.
         return lambda: None
 

{klaude_code-1.2.26.dist-info → klaude_code-1.2.27.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 1.2.26
-Summary: Add your description here
+Version: 1.2.27
+Summary: Minimal code agent CLI
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: chardet>=5.2.0
 Requires-Dist: ddgs>=9.9.3
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 
 # Klaude Code
 
-Multi-model code agent CLI.
+Minimal code agent CLI.
 
 ## Features
 - **Multi-provider**: Anthropic, OpenAI Responses API, OpenRouter
@@ -92,147 +92,141 @@ klaude [--model <name>] [--select-model]
 
 ### Configuration
 
-An example config will be created in `~/.klaude/klaude-config.yaml` when first run.
+#### Quick Start (Zero Config)
 
-Open the configuration file in editor:
+Klaude comes with built-in provider configurations. Just set an API key environment variable and start using it:
+
+```bash
+# Pick one (or more) of these:
+export ANTHROPIC_API_KEY=sk-ant-xxx      # Claude models
+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
+
+# Then just run:
+klaude
+```
+
+On first run, you'll be prompted to select a model. Your choice is saved as `main_model`.
+
+#### 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                                                                 |
+
+List all configured providers and models:
+
+```bash
+klaude list
+```
+
+Models from providers without a valid API key are shown as dimmed/unavailable.
+
+#### Custom Configuration
+
+User config file: `~/.klaude/klaude-config.yaml`
+
+Open in editor:
 
 ```bash
 klaude config
 ```
 
-An example config yaml:
+##### Adding Models to Built-in Providers
+
+You can add custom models to existing providers without redefining the entire provider:
 
 ```yaml
+# Just specify provider_name and your new models - no need for protocol/api_key
 provider_list:
-- provider_name: openrouter
-  protocol: openrouter # support <responses|openrouter|anthropic|openai>
-  api_key: <your-openrouter-api-key>
-
-- provider_name: openai-responses
-  protocol: responses
-  api_key: <your-openai-api-key>
-
-- provider_name: anthropic
-  protocol: anthropic
-  api_key: <your-anthropic-api-key>
-
-- provider_name: moonshot
-  protocol: anthropic
-  base_url: https://api.moonshot.cn/anthropic
-  api_key: <your-api-key>
-
-- provider_name: deepseek
-  protocol: anthropic
-  base_url: https://api.deepseek.com/anthropic
-  api_key: <your-api-key>
-
-model_list:
-
-- model_name: deepseek
-  provider: deepseek
-  model_params:
-    model: deepseek-reasoner
-    context_limit: 128000
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 2
-      output: 3
-      cache_read: 0.2
-
-- model_name: codex-max
-  provider: openai-responses
-  model_params:
-    model: gpt-5.1-codex-max
-    thinking:
-      reasoning_effort: medium
-    context_limit: 400000
-    max_tokens: 128000
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: gpt-5.1
-  provider: openrouter
-  model_params:
-    model: openai/gpt-5.1
-    context_limit: 400000
-    max_tokens: 128000
-    verbosity: high
-    thinking:
-      reasoning_effort: high
-    cost:
-      input: 1.25
-      output: 10
-      cache_read: 0.13
-
-- model_name: kimi@moonshot
-  provider: moonshot
-  model_params:
-    model: kimi-k2-thinking
-    context_limit: 262144
-    thinking:
-      type: enabled
-      budget_tokens: 8192
-    cost:
-      currency: CNY
-      input: 4
-      output: 16
-      cache_read: 1
-
-- model_name: opus
-  provider: openrouter
-  model_params:
-    model: anthropic/claude-4.5-opus
-    context_limit: 200000
-    provider_routing:
-      only: [ google-vertex ]
-    verbosity: high
-    thinking:
-      type: enabled
-      budget_tokens: 31999
-    cost:
-      input: 5
-      output: 25
-      cache_read: 0.5
-      cache_write: 6.25
-
-- model_name: gemini
-  provider: openrouter
-  model_params:
-    model: google/gemini-3-pro-preview
-    context_limit: 1048576
-    thinking:
-      reasoning_effort: medium
-    cost:
-      input: 2
-      output: 12
-      cache_read: 0.2
-
-- model_name: haiku
-  provider: anthropic
-  model_params:
-    model: claude-haiku-4-5-20251001
-    context_limit: 200000
-    cost:
-      input: 1
-      output: 5
-      cache_read: 0.1
-      cache_write: 1.25
+  - provider_name: openrouter
+    model_list:
+      - model_name: my-custom-model
+        model_params:
+          model: some-provider/some-model-id
+          context_limit: 200000
+```
+
+Your models are merged with built-in models. To override a built-in model, use the same `model_name`.
 
+##### Overriding Provider Settings
+
+Override provider-level settings (like api_key) while keeping built-in models:
+
+```yaml
+provider_list:
+  - provider_name: anthropic
+    api_key: sk-my-custom-key  # Override the default ${ANTHROPIC_API_KEY}
+    # Built-in models (sonnet, opus) are still available
+```
+
+##### Adding New Providers
+
+For providers not in the built-in list, you must specify `protocol`:
+
+```yaml
+provider_list:
+  - provider_name: my-azure-openai
+    protocol: openai
+    api_key: ${AZURE_OPENAI_KEY}
+    base_url: https://my-instance.openai.azure.com/
+    is_azure: true
+    azure_api_version: "2024-02-15-preview"
+    model_list:
+      - model_name: gpt-4-azure
+        model_params:
+          model: gpt-4
+          context_limit: 128000
+```
+
+##### Full Example
+
+```yaml
+# User configuration - merged with built-in config
 main_model: opus
 
 sub_agent_models:
-  oracle: gpt-5.1
-  explore: haiku
+  oracle: gpt-4.1
+  explore: sonnet
   task: opus
-  webagent: haiku
+  webagent: sonnet
 
+provider_list:
+  # Add models to built-in openrouter
+  - provider_name: openrouter
+    model_list:
+      - model_name: qwen-coder
+        model_params:
+          model: qwen/qwen-2.5-coder-32b-instruct
+          context_limit: 131072
+
+  # Add a completely new provider
+  - provider_name: local-ollama
+    protocol: openai
+    base_url: http://localhost:11434/v1
+    api_key: ollama
+    model_list:
+      - model_name: local-llama
+        model_params:
+          model: llama3.2
+          context_limit: 8192
 ```
 
+##### Supported Protocols
+
+- `anthropic` - Anthropic Claude API
+- `openai` - OpenAI-compatible API
+- `responses` - OpenAI Responses API (for o-series, GPT-5, Codex)
+- `openrouter` - OpenRouter API
+- `codex` - OpenAI Codex CLI (OAuth-based)
+
 List configured providers and models:
 
 ```bash