klaude-code 1.2.16__py3-none-any.whl → 1.2.17__py3-none-any.whl

klaude_code/protocol/sub_agent/web.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+from typing import Any
+
+from klaude_code.protocol import tools
+from klaude_code.protocol.sub_agent import SubAgentProfile, register_sub_agent
+
+WEB_AGENT_DESCRIPTION = """\
+Launch a sub-agent to search the web, fetch pages, and analyze content. Use this for:
+- Accessing up-to-date information beyond your knowledge cutoff (current events, recent releases, latest docs)
+- Researching topics, news, APIs, or technical references
+- Fetching and analyzing specific URLs
+- Gathering comprehensive information from multiple web sources
+
+Capabilities:
+- Search the web to find relevant pages (no URL required)
+- Fetch and parse web pages (HTML-to-Markdown conversion)
+- Follow links across multiple pages autonomously
+- Aggregate findings from multiple sources
+
+How to use:
+- Write a clear prompt describing what information you need - the agent will search and fetch as needed
+- Optionally provide a `url` if you already know the target page
+- Use `output_format` (JSON Schema) to get structured data back from the agent
+- Account for "Today's date" in <env>. For example, if <env> says "Today's date: 2025-07-01", and the user wants the latest docs, do not use 2024 in the search query. Use 2025.
+
+What you receive:
+- The agent returns a text response summarizing its findings
+- With `output_format`, you receive structured JSON matching your schema
+- The response is the agent's analysis, not raw web content\
+"""
+
+WEB_AGENT_PARAMETERS = {
+    "type": "object",
+    "properties": {
+        "description": {
+            "type": "string",
+            "description": "A short (3-5 word) description of the task",
+        },
+        "url": {
+            "type": "string",
+            "description": "The URL to fetch and analyze. If not provided, the agent will search the web first",
+        },
+        "prompt": {
+            "type": "string",
+            "description": "Instructions for searching, analyzing, or extracting content from the web page",
+        },
+        "output_format": {
+            "type": "object",
+            "description": "Optional JSON Schema for sub-agent structured output",
+        },
+    },
+    "required": ["description", "prompt"],
+    "additionalProperties": False,
+}
+
+
+def _web_agent_prompt_builder(args: dict[str, Any]) -> str:
+    """Build the WebAgent prompt from tool arguments."""
+    url = args.get("url", "")
+    prompt = args.get("prompt", "")
+    if url:
+        return f"URL to fetch: {url}\nTask: {prompt}"
+    return prompt
+
+
+register_sub_agent(
+    SubAgentProfile(
+        name="WebAgent",
+        description=WEB_AGENT_DESCRIPTION,
+        parameters=WEB_AGENT_PARAMETERS,
+        prompt_file="prompts/prompt-sub-agent-web.md",
+        tool_set=(tools.BASH, tools.READ, tools.WEB_FETCH, tools.WEB_SEARCH),
+        prompt_builder=_web_agent_prompt_builder,
+        active_form="Surfing",
+        output_schema_arg="output_format",
+    )
+)

klaude_code/protocol/tools.py

@@ -10,6 +10,7 @@ SKILL = "Skill"
 MERMAID = "Mermaid"
 MEMORY = "Memory"
 WEB_FETCH = "WebFetch"
+WEB_SEARCH = "WebSearch"
 REPORT_BACK = "report_back"
 
 # SubAgentType is just a string alias now; agent types are defined via SubAgentProfile

klaude_code/session/templates/export_session.html

@@ -672,8 +672,102 @@
       /* Markdown Elements */
       .markdown-body {
         font-family: var(--font-markdown);
-        line-height: 1.5;
+        line-height: 1.6;
+        font-size: var(--font-size-base);
+      }
+      .markdown-body > *:first-child {
+        margin-top: 0 !important;
+      }
+      .markdown-body > *:last-child {
+        margin-bottom: 0 !important;
+      }
+      
+      .markdown-body h1,
+      .markdown-body h2,
+      .markdown-body h3,
+      .markdown-body h4,
+      .markdown-body h5,
+      .markdown-body h6 {
+        margin-top: 24px;
+        margin-bottom: 16px;
+        font-weight: var(--font-weight-bold);
+        line-height: 1.25;
+      }
+
+      .markdown-body a {
+        color: var(--accent);
+        text-decoration: none;
+        border-bottom: 1px solid rgba(8, 81, 178, 0.2);
+        transition: border-color 0.2s, background-color 0.2s;
+      }
+      .markdown-body a:hover {
+        border-bottom-color: var(--accent);
+        background-color: rgba(8, 81, 178, 0.05);
+        border-radius: 2px;
+      }
+
+      .markdown-body p {
+        margin-bottom: 8px; /* Tighter spacing */
+      }
+      
+      .markdown-body ul,
+      .markdown-body ol {
+        margin-bottom: 8px; /* Tighter spacing */
+        padding-left: 1.5rem;
+        list-style-position: outside;
+      }
+      
+      .markdown-body ul ul,
+      .markdown-body ol ul,
+      .markdown-body ul ol,
+      .markdown-body ol ol {
+        margin-top: 0;
+        margin-bottom: 0;
+      }
+      
+      .markdown-body li > p {
+        margin-bottom: 0;
+      }
+      .markdown-body li + li {
+        margin-top: 0.25em;
       }
+
+      .markdown-body blockquote {
+        margin: 0 0 16px;
+        padding: 0 1em;
+        color: var(--text-dim);
+        border-left: 0.25em solid var(--border);
+      }
+
+      .markdown-body table {
+        border-collapse: collapse;
+        width: 100%;
+        margin-top: 8px;
+        margin-bottom: 16px;
+        display: block;
+        overflow-x: auto;
+      }
+      
+      .markdown-body table tr {
+        background-color: var(--bg-card);
+        border-top: 1px solid var(--border);
+      }
+      
+      .markdown-body table tr:nth-child(2n) {
+        background-color: rgba(0, 0, 0, 0.02);
+      }
+      
+      .markdown-body table th,
+      .markdown-body table td {
+        padding: 6px 13px;
+        border: 1px solid var(--border);
+      }
+      
+      .markdown-body table th {
+        font-weight: var(--font-weight-bold);
+        background-color: rgba(0, 0, 0, 0.04);
+      }
+
       .markdown-body hr {
         height: 0;
         margin: 24px 0;
@@ -682,10 +776,10 @@
       }
       .markdown-body pre {
         background: var(--bg-code);
-        padding: 16px;
+        padding: 12px;
         border-radius: var(--radius-md);
         overflow-x: auto;
-        margin: 12px 0;
+        margin: 8px 0 16px 0;
         border: 1px solid var(--border);
       }
       .markdown-body code {
@@ -694,36 +788,17 @@
         font-size: var(--font-size-sm);
         padding: 2px 4px;
         border-radius: var(--radius-sm);
+        background-color: rgba(0, 0, 0, 0.05); /* Slight bg for inline code */
       }
       .markdown-body pre code {
         background: transparent;
         padding: 0;
         border-radius: 0;
+        color: inherit;
       }
       .markdown-body pre code.hljs {
         background: transparent;
       }
-      .markdown-body p {
-        margin-bottom: 12px;
-      }
-      .markdown-body > *:first-child {
-        margin-top: 0;
-      }
-      .markdown-body > *:last-child {
-        margin-bottom: 0;
-      }
-      .markdown-body ul,
-      .markdown-body ol {
-        margin-bottom: 12px;
-        padding-left: 1.5rem;
-        list-style-position: outside;
-      }
-      .markdown-body ul ul,
-      .markdown-body ol ul,
-      .markdown-body ul ol,
-      .markdown-body ol ol {
-        margin-left: 1rem;
-      }
 
       /* Diff View */
       .diff-view {

klaude_code/ui/modes/repl/event_handler.py

@@ -137,11 +137,13 @@ class SpinnerStatusState:
     Composed of two independent layers:
     - base_status: Set by TodoChange, persistent within a turn
     - activity: Current activity (composing or tool_calls), mutually exclusive
+    - context_percent: Context usage percentage, updated during task execution
 
     Display logic:
     - If activity: show base + activity (if base exists) or activity + "..."
     - Elif base_status: show base_status
     - Else: show "Thinking …"
+    - Context percent is appended at the end if available
     """
 
     DEFAULT_STATUS = "Thinking …"
@@ -149,11 +151,13 @@ class SpinnerStatusState:
     def __init__(self) -> None:
         self._base_status: str | None = None
         self._activity = ActivityState()
+        self._context_percent: float | None = None
 
     def reset(self) -> None:
         """Reset all layers."""
         self._base_status = None
         self._activity.reset()
+        self._context_percent = None
 
     def set_base_status(self, status: str | None) -> None:
         """Set base status from TodoChange."""
@@ -175,12 +179,16 @@ class SpinnerStatusState:
         """Clear activity state for a new turn."""
         self._activity.reset()
 
+    def set_context_percent(self, percent: float) -> None:
+        """Set context usage percentage."""
+        self._context_percent = percent
+
     def get_activity_text(self) -> Text | None:
         """Get current activity text. Returns None if idle."""
         return self._activity.get_activity_text()
 
     def get_status(self) -> Text:
-        """Get current spinner status as rich Text."""
+        """Get current spinner status as rich Text (without context)."""
         activity_text = self._activity.get_activity_text()
 
         if self._base_status:
@@ -188,11 +196,19 @@ class SpinnerStatusState:
             if activity_text:
                 result.append(" | ")
                 result.append_text(activity_text)
-            return result
-        if activity_text:
+        elif activity_text:
             activity_text.append(" …")
-            return activity_text
-        return Text(self.DEFAULT_STATUS)
+            result = activity_text
+        else:
+            result = Text(self.DEFAULT_STATUS)
+
+        return result
+
+    def get_context_text(self) -> Text | None:
+        """Get context usage text for right-aligned display."""
+        if self._context_percent is None:
+            return None
+        return Text(f"{self._context_percent:.1f}%", style=ThemeKey.METADATA_DIM)
 
 
 class DisplayEventHandler:
@@ -247,6 +263,8 @@ class DisplayEventHandler:
                 self._on_task_metadata(e)
             case events.TodoChangeEvent() as e:
                 self._on_todo_change(e)
+            case events.ContextUsageEvent() as e:
+                self._on_context_usage(e)
             case events.TurnEndEvent():
                 pass
             case events.ResponseMetadataEvent():
@@ -412,6 +430,12 @@ class DisplayEventHandler:
         self.spinner_status.clear_for_new_turn()
         self._update_spinner()
 
+    def _on_context_usage(self, event: events.ContextUsageEvent) -> None:
+        if self.renderer.is_sub_agent_session(event.session_id):
+            return
+        self.spinner_status.set_context_percent(event.context_percent)
+        self._update_spinner()
+
     async def _on_task_finish(self, event: events.TaskFinishEvent) -> None:
         self.renderer.display_task_finish(event)
         if not self.renderer.is_sub_agent_session(event.session_id):
@@ -459,7 +483,10 @@ class DisplayEventHandler:
 
     def _update_spinner(self) -> None:
         """Update spinner text from current status state."""
-        self.renderer.spinner_update(self.spinner_status.get_status())
+        self.renderer.spinner_update(
+            self.spinner_status.get_status(),
+            self.spinner_status.get_context_text(),
+        )
 
     async def _flush_assistant_buffer(self, state: StreamState) -> None:
         if state.is_active:
@@ -525,15 +552,15 @@ class DisplayEventHandler:
         """Calculate max length for base_status based on terminal width.
 
         Reserve space for:
-        - Spinner glyph + space: 2 chars
+        - Spinner glyph + space + context text: 2 chars + context text length 10 chars
         - " | " separator: 3 chars (only if activity text present)
         - Activity text: actual length (only if present)
         - Status hint text (esc to interrupt)
         """
         terminal_width = self.renderer.console.size.width
 
-        # Base reserved space: spinner + status hint
-        reserved_space = 2 + len(const.STATUS_HINT_TEXT)
+        # Base reserved space: spinner + context + status hint
+        reserved_space = 12 + len(const.STATUS_HINT_TEXT)
 
         # Add space for activity text if present
         activity_text = self.spinner_status.get_activity_text()

klaude_code/ui/modes/repl/renderer.py

@@ -264,9 +264,9 @@ class REPLRenderer:
         """Stop the spinner animation."""
         self._spinner.stop()
 
-    def spinner_update(self, status_text: str | Text) -> None:
-        """Update the spinner status text."""
-        self._spinner.update(ShimmerStatusText(status_text, ThemeKey.SPINNER_STATUS_TEXT))
+    def spinner_update(self, status_text: str | Text, right_text: Text | None = None) -> None:
+        """Update the spinner status text with optional right-aligned text."""
+        self._spinner.update(ShimmerStatusText(status_text, ThemeKey.SPINNER_STATUS_TEXT, right_text))
 
     def spinner_renderable(self) -> Spinner:
         """Return the spinner's renderable for embedding in other components."""

klaude_code/ui/renderers/sub_agent.py

@@ -16,7 +16,7 @@ from klaude_code.ui.rich.theme import ThemeKey
 
 def _compact_schema_value(value: dict[str, Any]) -> str | list[Any] | dict[str, Any]:
     """Convert a JSON Schema value to compact representation."""
-    value_type = value.get("type", "any")
+    value_type = value.get("type", "any").lower()
     desc = value.get("description", "")
 
     if value_type == "object":
@@ -64,16 +64,20 @@ def render_sub_agent_result(
 
     # Use rich JSON for structured output
     if has_structured_output:
-        return Panel.fit(
-            Group(
-                Text(
-                    "use /export to view full output",
-                    style=ThemeKey.TOOL_RESULT,
+        try:
+            return Panel.fit(
+                Group(
+                    Text(
+                        "use /export to view full output",
+                        style=ThemeKey.TOOL_RESULT,
+                    ),
+                    JSON(stripped_result),
                 ),
-                JSON(stripped_result),
-            ),
-            border_style=ThemeKey.LINES,
-        )
+                border_style=ThemeKey.LINES,
+            )
+        except json.JSONDecodeError:
+            # Fall back to markdown if not valid JSON
+            pass
 
     lines = stripped_result.splitlines()
     if len(lines) > const.SUB_AGENT_RESULT_MAX_LINES:

klaude_code/ui/renderers/tools.py

@@ -186,14 +186,7 @@ def render_write_tool_call(arguments: str) -> RenderableType:
     try:
         json_dict = json.loads(arguments)
         file_path = json_dict.get("file_path")
-        op_label = "Create"
-        if isinstance(file_path, str):
-            abs_path = Path(file_path)
-            if not abs_path.is_absolute():
-                abs_path = (Path().cwd() / abs_path).resolve()
-            if abs_path.exists():
-                op_label = "Overwrite"
-        tool_name_column = Text.assemble(("→", ThemeKey.TOOL_MARK), " ", (op_label, ThemeKey.TOOL_NAME))
+        tool_name_column = Text.assemble(("→", ThemeKey.TOOL_MARK), " ", ("Write", ThemeKey.TOOL_NAME))
         arguments_column = render_path(file_path, ThemeKey.TOOL_PARAM_FILE_PATH)
     except json.JSONDecodeError:
         tool_name_column = Text.assemble(("→", ThemeKey.TOOL_MARK), " ", ("Write", ThemeKey.TOOL_NAME))
@@ -455,8 +448,9 @@ _TOOL_ACTIVE_FORM: dict[str, str] = {
     tools.SKILL: "Skilling",
     tools.MERMAID: "Diagramming",
     tools.MEMORY: "Memorizing",
-    tools.WEB_FETCH: "Fetching",
-    tools.REPORT_BACK: "Submitting Report",
+    tools.WEB_FETCH: "Fetching Web",
+    tools.WEB_SEARCH: "Searching Web",
+    tools.REPORT_BACK: "Reporting",
 }
 
 

klaude_code/ui/rich/status.py

@@ -21,15 +21,22 @@ from klaude_code.ui.terminal.color import get_last_terminal_background_rgb
 BREATHING_SPINNER_NAME = "dots"
 
 # Alternating glyphs for the breathing spinner - switches at each "transparent" point
-# All glyphs are center-symmetric (point-symmetric)
 _BREATHING_SPINNER_GLYPHS_BASE = [
-    # Stars
     "✦",
     "✶",
     "✲",
-    "⏺",
     "◆",
     "❖",
+    "✧",
+    "❋",
+    "✸",
+    "✻",
+    "◇",
+    "✴",
+    "✷",
+    "⟡",
+    "⬡",
+    "⬢",
 ]
 
 # Shuffle glyphs on module load for variety across sessions
@@ -172,15 +179,34 @@ def _breathing_style(console: Console, base_style: Style, intensity: float) -> S
 
 
 class ShimmerStatusText:
-    """Renderable status line with shimmer effect on the main text and hint."""
+    """Renderable status line with shimmer effect on the main text and hint.
 
-    def __init__(self, main_text: str | Text, main_style: ThemeKey) -> None:
+    Supports optional right-aligned text that stays fixed at the right edge.
+    """
+
+    def __init__(self, main_text: str | Text, main_style: ThemeKey, right_text: Text | None = None) -> None:
         self._main_text = main_text if isinstance(main_text, Text) else Text(main_text)
         self._main_style = main_style
         self._hint_text = Text(const.STATUS_HINT_TEXT)
         self._hint_style = ThemeKey.STATUS_HINT
+        self._right_text = right_text
 
     def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
+        left_text = self._render_left_text(console)
+
+        if self._right_text is None:
+            yield left_text
+            return
+
+        # Use Table.grid to create left-right aligned layout
+        table = Table.grid(expand=True)
+        table.add_column(justify="left", ratio=1)
+        table.add_column(justify="right")
+        table.add_row(left_text, self._right_text)
+        yield table
+
+    def _render_left_text(self, console: Console) -> Text:
+        """Render the left part with shimmer effect."""
         result = Text()
         main_style = console.get_style(str(self._main_style))
         hint_style = console.get_style(str(self._hint_style))
@@ -198,7 +224,7 @@ class ShimmerStatusText:
             style = _shimmer_style(console, base_style, intensity)
             result.append(ch, style=style)
 
-        yield result
+        return result
 
 
 def spinner_name() -> str:

{klaude_code-1.2.16.dist-info → klaude_code-1.2.17.dist-info}/METADATA

@@ -1,8 +1,9 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 1.2.16
+Version: 1.2.17
 Summary: Add your description here
 Requires-Dist: anthropic>=0.66.0
+Requires-Dist: ddgs>=9.9.3
 Requires-Dist: openai>=1.102.0
 Requires-Dist: pillow>=12.0.0
 Requires-Dist: prompt-toolkit>=3.0.52
@@ -71,47 +72,137 @@ Open the configuration file in editor:
 klaude config
 ```
 
-An minimal example config yaml using OpenRouter's API Key:
+An example config yaml:
 
 ```yaml
 provider_list:
-- provider_name: openrouter-work
+- 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: gpt-5.1-codex
-  provider: openrouter
+
+- 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: openai/gpt-5.1-codex
-    context_limit: 368000
+    model: gpt-5.1-codex-max
     thinking:
       reasoning_effort: medium
-- model_name: gpt-5.1-high
+    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: 368000
+    context_limit: 400000
+    max_tokens: 128000
+    verbosity: high
     thinking:
       reasoning_effort: high
-- model_name: sonnet
+    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-sonnet
-    context_limit: 168000
+    model: anthropic/claude-4.5-opus
+    context_limit: 200000
     provider_routing:
-      sort: throughput
-- model_name: haiku
+      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: anthropic/claude-haiku-4.5
-    context_limit: 168000
-    provider_routing:
-      sort: throughput
-main_model: gpt-5.1-codex
+    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
+
+main_model: opus
+
 sub_agent_models:
-  oracle: gpt-5.1-high
+  oracle: gpt-5.1
   explore: haiku
-  task: sonnet
+  task: opus
+  webfetchagent: haiku
+
 ```
 
 List configured providers and models: