klaude-code 2.3.0__py3-none-any.whl → 2.4.0__py3-none-any.whl

klaude_code/tui/command/sub_agent_model_cmd.py

@@ -8,7 +8,7 @@ from prompt_toolkit.styles import Style
 
 from klaude_code.config.config import load_config
 from klaude_code.config.sub_agent_model_helper import SubAgentModelHelper, SubAgentModelInfo
-from klaude_code.protocol import commands, events, message, model, op
+from klaude_code.protocol import commands, events, message, op
 from klaude_code.tui.terminal.selector import SelectItem, build_model_select_items, select_one
 
 from .command_abc import Agent, CommandABC, CommandResult
@@ -136,12 +136,11 @@ class SubAgentModelCommand(CommandABC):
         if not sub_agents:
             return CommandResult(
                 events=[
-                    events.DeveloperMessageEvent(
+                    events.CommandOutputEvent(
                         session_id=agent.session.id,
-                        item=message.DeveloperMessage(
-                            parts=message.text_parts_from_str("No sub-agents available"),
-                            ui_extra=model.build_command_output_extra(self.name),
-                        ),
+                        command_name=self.name,
+                        content="No sub-agents available",
+                        is_error=True,
                     )
                 ]
             )
@@ -150,12 +149,10 @@ class SubAgentModelCommand(CommandABC):
         if selected_sub_agent is None:
             return CommandResult(
                 events=[
-                    events.DeveloperMessageEvent(
+                    events.CommandOutputEvent(
                         session_id=agent.session.id,
-                        item=message.DeveloperMessage(
-                            parts=message.text_parts_from_str("(cancelled)"),
-                            ui_extra=model.build_command_output_extra(self.name),
-                        ),
+                        command_name=self.name,
+                        content="(cancelled)",
                     )
                 ]
             )
@@ -166,12 +163,10 @@ class SubAgentModelCommand(CommandABC):
         if selected_model is None:
             return CommandResult(
                 events=[
-                    events.DeveloperMessageEvent(
+                    events.CommandOutputEvent(
                         session_id=agent.session.id,
-                        item=message.DeveloperMessage(
-                            parts=message.text_parts_from_str("(cancelled)"),
-                            ui_extra=model.build_command_output_extra(self.name),
-                        ),
+                        command_name=self.name,
+                        content="(cancelled)",
                     )
                 ]
             )

klaude_code/tui/command/terminal_setup_cmd.py

@@ -2,7 +2,7 @@ import os
 import subprocess
 from pathlib import Path
 
-from klaude_code.protocol import commands, events, message, model
+from klaude_code.protocol import commands, events, message
 
 from .command_abc import Agent, CommandABC, CommandResult
 
@@ -226,12 +226,10 @@ class TerminalSetupCommand(CommandABC):
         """Create success result"""
         return CommandResult(
             events=[
-                events.DeveloperMessageEvent(
+                events.CommandOutputEvent(
                     session_id=agent.session.id,
-                    item=message.DeveloperMessage(
-                        parts=message.text_parts_from_str(msg),
-                        ui_extra=model.build_command_output_extra(self.name),
-                    ),
+                    command_name=self.name,
+                    content=msg,
                 )
             ]
         )
@@ -240,12 +238,11 @@ class TerminalSetupCommand(CommandABC):
         """Create error result"""
         return CommandResult(
             events=[
-                events.DeveloperMessageEvent(
+                events.CommandOutputEvent(
                     session_id=agent.session.id,
-                    item=message.DeveloperMessage(
-                        parts=message.text_parts_from_str(msg),
-                        ui_extra=model.build_command_output_extra(self.name, is_error=True),
-                    ),
+                    command_name=self.name,
+                    content=msg,
+                    is_error=True,
                 )
             ]
         )

klaude_code/tui/command/thinking_cmd.py

@@ -3,7 +3,7 @@ import asyncio
 from prompt_toolkit.styles import Style
 
 from klaude_code.config.thinking import get_thinking_picker_data, parse_thinking_value
-from klaude_code.protocol import commands, events, llm_param, message, model, op
+from klaude_code.protocol import commands, events, llm_param, message, op
 from klaude_code.tui.terminal.selector import SelectItem, select_one
 
 from .command_abc import Agent, CommandABC, CommandResult
@@ -79,12 +79,10 @@ class ThinkingCommand(CommandABC):
         if new_thinking is None:
             return CommandResult(
                 events=[
-                    events.DeveloperMessageEvent(
+                    events.CommandOutputEvent(
                         session_id=agent.session.id,
-                        item=message.DeveloperMessage(
-                            parts=message.text_parts_from_str("(no change)"),
-                            ui_extra=model.build_command_output_extra(self.name),
-                        ),
+                        command_name=self.name,
+                        content="(no change)",
                     )
                 ]
             )

klaude_code/tui/commands.py

@@ -38,6 +38,11 @@ class RenderDeveloperMessage(RenderCommand):
     event: events.DeveloperMessageEvent
 
 
+@dataclass(frozen=True, slots=True)
+class RenderCommandOutput(RenderCommand):
+    event: events.CommandOutputEvent
+
+
 @dataclass(frozen=True, slots=True)
 class RenderTurnStart(RenderCommand):
     event: events.TurnStartEvent

klaude_code/tui/components/command_output.py

@@ -0,0 +1,96 @@
+from rich.console import RenderableType
+from rich.padding import Padding
+from rich.table import Table
+from rich.text import Text
+
+from klaude_code.protocol import events, model
+from klaude_code.tui.components.common import truncate_middle
+from klaude_code.tui.components.rich.theme import ThemeKey
+
+
+def render_command_output(e: events.CommandOutputEvent) -> RenderableType:
+    """Render command output content."""
+    match e.command_name:
+        case "status":
+            return _render_status_output(e)
+        case "fork-session":
+            return _render_fork_session_output(e)
+        case _:
+            content = e.content or "(no content)"
+            style = ThemeKey.TOOL_RESULT if not e.is_error else ThemeKey.ERROR
+            return Padding.indent(truncate_middle(content, base_style=style), level=2)
+
+
+def _format_tokens(tokens: int) -> str:
+    """Format token count with K/M suffix for readability."""
+    if tokens >= 1_000_000:
+        return f"{tokens / 1_000_000:.2f}M"
+    if tokens >= 1_000:
+        return f"{tokens / 1_000:.1f}K"
+    return str(tokens)
+
+
+def _format_cost(cost: float | None, currency: str = "USD") -> str:
+    """Format cost with currency symbol."""
+    if cost is None:
+        return "-"
+    symbol = "Y" if currency == "CNY" else "$"
+    if cost < 0.01:
+        return f"{symbol}{cost:.4f}"
+    return f"{symbol}{cost:.2f}"
+
+
+def _render_fork_session_output(e: events.CommandOutputEvent) -> RenderableType:
+    """Render fork session output with usage instructions."""
+    if not isinstance(e.ui_extra, model.SessionIdUIExtra):
+        return Padding.indent(Text(e.content, style=ThemeKey.TOOL_RESULT), level=2)
+
+    grid = Table.grid(padding=(0, 1))
+    session_id = e.ui_extra.session_id
+    grid.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
+
+    grid.add_row(Text("Session forked. Resume command copied to clipboard:", style=ThemeKey.TOOL_RESULT))
+    grid.add_row(Text(f"  klaude --resume-by-id {session_id}", style=ThemeKey.TOOL_RESULT_BOLD))
+
+    return Padding.indent(grid, level=2)
+
+
+def _render_status_output(e: events.CommandOutputEvent) -> RenderableType:
+    """Render session status with total cost and per-model breakdown."""
+    if not isinstance(e.ui_extra, model.SessionStatusUIExtra):
+        return Text("(no status data)", style=ThemeKey.TOOL_RESULT)
+
+    status = e.ui_extra
+    usage = status.usage
+
+    table = Table.grid(padding=(0, 2))
+    table.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
+    table.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
+
+    # Total cost line
+    table.add_row(
+        Text("Total cost:", style=ThemeKey.TOOL_RESULT_BOLD),
+        Text(_format_cost(usage.total_cost, usage.currency), style=ThemeKey.TOOL_RESULT_BOLD),
+    )
+
+    # Per-model breakdown
+    if status.by_model:
+        table.add_row(Text("Usage by model:", style=ThemeKey.TOOL_RESULT_BOLD), "")
+        for meta in status.by_model:
+            model_label = meta.model_name
+            if meta.provider:
+                model_label = f"{meta.model_name} ({meta.provider.lower().replace(' ', '-')})"
+
+            if meta.usage:
+                usage_detail = (
+                    f"{_format_tokens(meta.usage.input_tokens)} input, "
+                    f"{_format_tokens(meta.usage.output_tokens)} output, "
+                    f"{_format_tokens(meta.usage.cached_tokens)} cache read, "
+                    f"{_format_tokens(meta.usage.reasoning_tokens)} thinking, "
+                    f"({_format_cost(meta.usage.total_cost, meta.usage.currency)})"
+                )
+            else:
+                usage_detail = "(no usage data)"
+            table.add_row(f"{model_label}:", usage_detail)
+
+    return Padding.indent(table, level=2)

klaude_code/tui/components/developer.py

@@ -1,29 +1,18 @@
 from rich.console import Group, RenderableType
-from rich.padding import Padding
-from rich.table import Table
 from rich.text import Text
 
-from klaude_code.protocol import commands, events, message, model
-from klaude_code.tui.components.common import create_grid, truncate_middle
+from klaude_code.protocol import events, model
+from klaude_code.tui.components.common import create_grid
 from klaude_code.tui.components.rich.theme import ThemeKey
 from klaude_code.tui.components.tools import render_path
 
 REMINDER_BULLET = "  ⧉"
 
 
-def get_command_output(item: message.DeveloperMessage) -> model.CommandOutput | None:
-    if not item.ui_extra:
-        return None
-    for ui_item in item.ui_extra.items:
-        if isinstance(ui_item, model.CommandOutputUIItem):
-            return ui_item.output
-    return None
-
-
 def need_render_developer_message(e: events.DeveloperMessageEvent) -> bool:
     if not e.item.ui_extra:
         return False
-    return any(not isinstance(ui_item, model.CommandOutputUIItem) for ui_item in e.item.ui_extra.items)
+    return len(e.item.ui_extra.items) > 0
 
 
 def render_developer_message(e: events.DeveloperMessageEvent) -> RenderableType:
@@ -126,101 +115,5 @@ def render_developer_message(e: events.DeveloperMessageEvent) -> RenderableType:
                         ),
                     )
                     parts.append(grid)
-                case model.CommandOutputUIItem():
-                    # Rendered via render_command_output
-                    pass
 
     return Group(*parts) if parts else Text("")
-
-
-def render_command_output(e: events.DeveloperMessageEvent) -> RenderableType:
-    """Render developer command output content."""
-    command_output = get_command_output(e.item)
-    if not command_output:
-        return Text("")
-
-    content = message.join_text_parts(e.item.parts)
-    match command_output.command_name:
-        case commands.CommandName.STATUS:
-            return _render_status_output(command_output)
-        case commands.CommandName.FORK_SESSION:
-            return _render_fork_session_output(command_output)
-        case _:
-            content = content or "(no content)"
-            style = ThemeKey.TOOL_RESULT if not command_output.is_error else ThemeKey.ERROR
-            return Padding.indent(truncate_middle(content, base_style=style), level=2)
-
-
-def _format_tokens(tokens: int) -> str:
-    """Format token count with K/M suffix for readability."""
-    if tokens >= 1_000_000:
-        return f"{tokens / 1_000_000:.2f}M"
-    if tokens >= 1_000:
-        return f"{tokens / 1_000:.1f}K"
-    return str(tokens)
-
-
-def _format_cost(cost: float | None, currency: str = "USD") -> str:
-    """Format cost with currency symbol."""
-    if cost is None:
-        return "-"
-    symbol = "¥" if currency == "CNY" else "$"
-    if cost < 0.01:
-        return f"{symbol}{cost:.4f}"
-    return f"{symbol}{cost:.2f}"
-
-
-def _render_fork_session_output(command_output: model.CommandOutput) -> RenderableType:
-    """Render fork session output with usage instructions."""
-    if not isinstance(command_output.ui_extra, model.SessionIdUIExtra):
-        return Padding.indent(Text("(no session id)", style=ThemeKey.TOOL_RESULT), level=2)
-
-    grid = Table.grid(padding=(0, 1))
-    session_id = command_output.ui_extra.session_id
-    grid.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
-
-    grid.add_row(Text("Session forked. Resume command copied to clipboard:", style=ThemeKey.TOOL_RESULT))
-    grid.add_row(Text(f"  klaude --resume-by-id {session_id}", style=ThemeKey.TOOL_RESULT_BOLD))
-
-    return Padding.indent(grid, level=2)
-
-
-def _render_status_output(command_output: model.CommandOutput) -> RenderableType:
-    """Render session status with total cost and per-model breakdown."""
-    if not isinstance(command_output.ui_extra, model.SessionStatusUIExtra):
-        return Text("(no status data)", style=ThemeKey.TOOL_RESULT)
-
-    status = command_output.ui_extra
-    usage = status.usage
-
-    table = Table.grid(padding=(0, 2))
-    table.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
-    table.add_column(style=ThemeKey.TOOL_RESULT, overflow="fold")
-
-    # Total cost line
-    table.add_row(
-        Text("Total cost:", style=ThemeKey.TOOL_RESULT_BOLD),
-        Text(_format_cost(usage.total_cost, usage.currency), style=ThemeKey.TOOL_RESULT_BOLD),
-    )
-
-    # Per-model breakdown
-    if status.by_model:
-        table.add_row(Text("Usage by model:", style=ThemeKey.TOOL_RESULT_BOLD), "")
-        for meta in status.by_model:
-            model_label = meta.model_name
-            if meta.provider:
-                model_label = f"{meta.model_name} ({meta.provider.lower().replace(' ', '-')})"
-
-            if meta.usage:
-                usage_detail = (
-                    f"{_format_tokens(meta.usage.input_tokens)} input, "
-                    f"{_format_tokens(meta.usage.output_tokens)} output, "
-                    f"{_format_tokens(meta.usage.cached_tokens)} cache read, "
-                    f"{_format_tokens(meta.usage.reasoning_tokens)} thinking, "
-                    f"({_format_cost(meta.usage.total_cost, meta.usage.currency)})"
-                )
-            else:
-                usage_detail = "(no usage data)"
-            table.add_row(f"{model_label}:", usage_detail)
-
-    return Padding.indent(table, level=2)

klaude_code/tui/components/welcome.py

@@ -38,7 +38,7 @@ def render_welcome(e: events.WelcomeEvent) -> RenderableType:
     # Model line: model @ provider · params...
     panel_content.append_text(
         Text.assemble(
-            (str(e.llm_config.model), ThemeKey.WELCOME_HIGHLIGHT),
+            (str(e.llm_config.model_id), ThemeKey.WELCOME_HIGHLIGHT),
             (" @ ", ThemeKey.WELCOME_INFO),
             (e.llm_config.provider_name, ThemeKey.WELCOME_INFO),
         )
@@ -84,7 +84,7 @@ def render_welcome(e: events.WelcomeEvent) -> RenderableType:
                     (prefix, ThemeKey.LINES),
                     (sub_agent_type.lower().ljust(max_type_len), ThemeKey.WELCOME_INFO),
                     (": ", ThemeKey.LINES),
-                    (str(sub_llm_config.model), ThemeKey.WELCOME_HIGHLIGHT),
+                    (str(sub_llm_config.model_id), ThemeKey.WELCOME_HIGHLIGHT),
                     (" @ ", ThemeKey.WELCOME_INFO),
                     (sub_llm_config.provider_name, ThemeKey.WELCOME_INFO),
                 )

klaude_code/tui/input/prompt_toolkit.py

@@ -26,7 +26,7 @@ from prompt_toolkit.styles import Style
 from prompt_toolkit.utils import get_cwidth
 
 from klaude_code.config import load_config
-from klaude_code.config.config import ModelEntry
+from klaude_code.config.model_matcher import match_model_from_config
 from klaude_code.config.thinking import (
     format_current_thinking,
     get_thinking_picker_data,
@@ -452,23 +452,21 @@ class PromptToolkitInput(InputProviderABC):
     # -------------------------------------------------------------------------
 
     def _build_model_picker_items(self) -> tuple[list[SelectItem[str]], str | None]:
-        config = load_config()
-        models: list[ModelEntry] = sorted(
-            config.iter_model_entries(only_available=True),
-            key=lambda m: (m.model_name.lower(), m.provider.lower()),
-        )
-        if not models:
+        result = match_model_from_config()
+        if result.error_message or not result.filtered_models:
             return [], None
 
-        items = build_model_select_items(models)
+        items = build_model_select_items(result.filtered_models)
 
         initial = None
         if self._get_current_model_config_name is not None:
             with contextlib.suppress(Exception):
                 initial = self._get_current_model_config_name()
         if initial is None:
+            config = load_config()
             initial = config.main_model
         if isinstance(initial, str) and initial and "@" not in initial:
+            config = load_config()
             try:
                 resolved = config.resolve_model_location_prefer_available(initial) or config.resolve_model_location(
                     initial

klaude_code/tui/machine.py

@@ -21,6 +21,7 @@ from klaude_code.tui.commands import (
     PrintRuleLine,
     RenderAssistantImage,
     RenderCommand,
+    RenderCommandOutput,
     RenderDeveloperMessage,
     RenderError,
     RenderInterrupt,
@@ -365,6 +366,10 @@ class DisplayStateMachine:
                 cmds.append(RenderDeveloperMessage(e))
                 return cmds
 
+            case events.CommandOutputEvent() as e:
+                cmds.append(RenderCommandOutput(e))
+                return cmds
+
             case events.TurnStartEvent() as e:
                 cmds.append(RenderTurnStart(e))
                 self._spinner.clear_for_new_turn()

klaude_code/tui/renderer.py

@@ -31,6 +31,7 @@ from klaude_code.tui.commands import (
     PrintRuleLine,
     RenderAssistantImage,
     RenderCommand,
+    RenderCommandOutput,
     RenderDeveloperMessage,
     RenderError,
     RenderInterrupt,
@@ -53,6 +54,7 @@ from klaude_code.tui.commands import (
     TaskClockStart,
 )
 from klaude_code.tui.components import assistant as c_assistant
+from klaude_code.tui.components import command_output as c_command_output
 from klaude_code.tui.components import developer as c_developer
 from klaude_code.tui.components import errors as c_errors
 from klaude_code.tui.components import mermaid_viewer as c_mermaid_viewer
@@ -471,7 +473,6 @@ class TUICommandRenderer:
                             self.print()
                     case events.DeveloperMessageEvent() as e:
                         self.display_developer_message(e)
-                        self.display_command_output(e)
                     case events.UserMessageEvent() as e:
                         if is_sub_agent:
                             continue
@@ -504,11 +505,9 @@ class TUICommandRenderer:
         with self.session_print_context(e.session_id):
             self.print(c_developer.render_developer_message(e))
 
-    def display_command_output(self, e: events.DeveloperMessageEvent) -> None:
-        if not c_developer.get_command_output(e.item):
-            return
+    def display_command_output(self, e: events.CommandOutputEvent) -> None:
         with self.session_print_context(e.session_id):
-            self.print(c_developer.render_command_output(e))
+            self.print(c_command_output.render_command_output(e))
             self.print()
 
     def display_welcome(self, event: events.WelcomeEvent) -> None:
@@ -627,6 +626,7 @@ class TUICommandRenderer:
                     self.display_task_start(event)
                 case RenderDeveloperMessage(event=event):
                     self.display_developer_message(event)
+                case RenderCommandOutput(event=event):
                     self.display_command_output(event)
                 case RenderTurnStart(event=event):
                     self.display_turn_start(event)

klaude_code/tui/runner.py

@@ -76,14 +76,8 @@ async def submit_user_input_payload(
     if len(run_ops) > 1:
         raise ValueError("Multiple RunAgentOperation results are not supported")
 
-    for run_op in run_ops:
-        run_op.persist_user_input = cmd_result.persist
-        run_op.emit_user_message_event = False
-
     if cmd_result.events:
         for evt in cmd_result.events:
-            if cmd_result.persist and isinstance(evt, events.DeveloperMessageEvent):
-                agent.session.append_history([evt.item])
             await executor.context.emit_event(evt)
 
     submitted_ids: list[str] = []

klaude_code/tui/terminal/selector.py

@@ -53,20 +53,20 @@ def build_model_select_items(models: list[Any]) -> list[SelectItem[str]]:
 
     items: list[SelectItem[str]] = []
     for idx, m in enumerate(models, 1):
-        model_id = m.model_params.model or "N/A"
+        model_id_str = m.model_id or "N/A"
         # Display the base model name only; provider stays in the meta section.
         display_name = m.model_name
         first_line_prefix = f"{display_name:<{max_model_name_length}} → "
         meta_parts: list[str] = [m.provider]
-        meta_parts.extend(format_model_params(m.model_params))
+        meta_parts.extend(format_model_params(m))
         meta_str = " · ".join(meta_parts)
         title = [
             ("class:meta", f"{idx:>{num_width}}. "),
             ("class:msg", first_line_prefix),
-            ("class:msg bold", model_id),
+            ("class:msg bold", model_id_str),
             ("class:meta", f"  {meta_str}\n"),
         ]
-        search_text = f"{m.selector} {m.model_name} {model_id} {m.provider}"
+        search_text = f"{m.selector} {m.model_name} {model_id_str} {m.provider}"
         items.append(SelectItem(title=title, value=m.selector, search_text=search_text))
 
     return items

{klaude_code-2.3.0.dist-info → klaude_code-2.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 2.3.0
+Version: 2.4.0
 Summary: Minimal code agent CLI
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: chardet>=5.2.0
@@ -155,95 +155,42 @@ Open in editor:
 klaude config
 ```
 
-##### Adding Models to Built-in Providers
+##### Model Configuration
 
-You can add custom models to existing built-in providers without redefining the entire provider. Just reference the `provider_name` and add your `model_list`:
+You can add custom models to built-in providers or define new ones. Configuration is inherited from built-in providers by matching `provider_name`.
 
 ```yaml
 # ~/.klaude/klaude-config.yaml
 provider_list:
-  - provider_name: openrouter  # Reference existing built-in provider
-    model_list:
-      - model_name: seed
-        model_params:
-          model: bytedance-seed/seed-1.6  # Model ID from OpenRouter
-          context_limit: 262000
-          cost:
-            input: 0.25
-            output: 2
-```
-
-**How merging works:**
-- Your models are merged with the built-in models for that provider
-- You only need `provider_name` and `model_list` - protocol, api_key, etc. are inherited from the built-in config
-- To override a built-in model, use the same `model_name` (e.g., `sonnet` to customize the built-in sonnet)
-
-**More examples:**
-
-```yaml
-provider_list:
-  # Add multiple models to OpenRouter
+  # Add/Override models for built-in OpenRouter provider
   - provider_name: openrouter
     model_list:
       - model_name: qwen-coder
-        model_params:
-          model: qwen/qwen-2.5-coder-32b-instruct
-          context_limit: 131072
-          cost:
-            input: 0.3
-            output: 0.9
-      - model_name: llama-405b
-        model_params:
-          model: meta-llama/llama-3.1-405b-instruct
-          context_limit: 131072
-          cost:
-            input: 0.8
-            output: 0.8
-
-  # Add models to Anthropic provider
-  - provider_name: anthropic
-    model_list:
-      - model_name: haiku@ant
-        model_params:
-          model: claude-3-5-haiku-20241022
-          context_limit: 200000
-          cost:
-            input: 1.0
-            output: 5.0
-```
-
-After adding models, run `klaude list` to verify they appear in the model list.
-
-##### 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
+        model_id: qwen/qwen-2.5-coder-32b-instruct
+        context_limit: 131072
+        cost: { input: 0.3, output: 0.9 }
+      - model_name: sonnet # Override built-in sonnet params
+        model_id: anthropic/claude-3.5-sonnet
+        context_limit: 200000
+
+  # Add a completely new provider
+  - provider_name: my-azure
     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
+      - model_name: gpt-4
+        model_id: gpt-4-deploy-name
+        context_limit: 128000
 ```
 
+**Key Tips:**
+- **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.
+
 ##### Supported Protocols
 
 - `anthropic` - Anthropic Messages API