klaude-code 2.28.0__tar.gz → 2.29.0__tar.gz

{klaude_code-2.28.0 → klaude_code-2.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 2.28.0
+Version: 2.29.0
 Summary: Minimal code agent CLI
 Requires-Dist: anthropic[bedrock]>=0.66.0
 Requires-Dist: chardet>=5.2.0,<6
@@ -8,13 +8,14 @@ Requires-Dist: diff-match-patch>=20241021
 Requires-Dist: filelock>=3.20.3
 Requires-Dist: fastapi
 Requires-Dist: google-genai>=1.56.0
+Requires-Dist: httpx[socks]>=0.28.1
 Requires-Dist: markdown-it-py>=4.0.0
 Requires-Dist: openai>=2.24.0
 Requires-Dist: prompt-toolkit>=3.0.52
 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: socksio>=1.0.0
 Requires-Dist: sse-starlette
 Requires-Dist: trafilatura>=2.0.0
 Requires-Dist: typer>=0.17.3

{klaude_code-2.28.0 → klaude_code-2.29.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "klaude-code"
-version = "2.28.0"
+version = "2.29.0"
 description = "Minimal code agent CLI"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -15,13 +15,14 @@ dependencies = [
     "filelock>=3.20.3",
     "fastapi",
     "google-genai>=1.56.0",
+    "httpx[socks]>=0.28.1",
     "markdown-it-py>=4.0.0",
     "openai>=2.24.0",
     "prompt-toolkit>=3.0.52",
     "pydantic>=2.11.7",
-    "python-socks>=2.8.1",
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
+    "socksio>=1.0.0",
     "sse-starlette",
     "trafilatura>=2.0.0",
     "typer>=0.17.3",

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/agent.py

@@ -38,6 +38,7 @@ class Agent:
         self.profile: AgentProfile = profile
         self.compact_llm_client: LLMClientABC | None = compact_llm_client
         self._current_task: TaskExecutor | None = None
+        self._follow_up_queue: list[UserInputPayload] = [item.model_copy(deep=True) for item in session.follow_up_queue]
         self._last_interrupt_show_notice = True
         self._last_interrupt_prefill_text: str | None = None
         self.request_user_interaction = request_user_interaction
@@ -54,6 +55,37 @@ class Agent:
         self._last_interrupt_prefill_text = None
         return text
 
+    def follow_up(self, user_input: UserInputPayload) -> int:
+        """Queue a user message to run after the active task completes."""
+
+        self._follow_up_queue.append(user_input)
+        self.session.set_follow_up_queue(self._follow_up_queue)
+        return len(self._follow_up_queue)
+
+    def follow_up_count(self) -> int:
+        return len(self._follow_up_queue)
+
+    def follow_up_snapshot(self) -> tuple[UserInputPayload, ...]:
+        return tuple(self._follow_up_queue)
+
+    def pop_all_follow_up(self) -> tuple[UserInputPayload, ...]:
+        messages = tuple(self._follow_up_queue)
+        self._follow_up_queue.clear()
+        self.session.set_follow_up_queue(self._follow_up_queue)
+        return messages
+
+    def peek_next_follow_up(self) -> UserInputPayload | None:
+        if not self._follow_up_queue:
+            return None
+        return self._follow_up_queue[0]
+
+    def pop_next_follow_up(self) -> UserInputPayload | None:
+        if not self._follow_up_queue:
+            return None
+        message = self._follow_up_queue.pop(0)
+        self.session.set_follow_up_queue(self._follow_up_queue)
+        return message
+
     def on_interrupt(self) -> Iterable[events.Event]:
         """Handle an interrupt by emitting best-effort cleanup events.
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/agent_profile.py

@@ -44,7 +44,7 @@ MAIN_AGENT_COMMON_BASE_TOOLS: list[str] = [tools.BASH, tools.READ]
 MAIN_AGENT_GPT5_DIFF_TOOLS: list[str] = [tools.APPLY_PATCH, tools.TODO_WRITE]
 MAIN_AGENT_NON_GPT5_DIFF_TOOLS: list[str] = [tools.EDIT, tools.WRITE, tools.TODO_WRITE]
 MAIN_AGENT_COMMON_TOOLS: list[str] = [
-    tools.HANDOFF,
+    # tools.HANDOFF,
     tools.AGENT,
     tools.WEB_FETCH,
     tools.WEB_SEARCH,

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/attachments/files.py

@@ -15,6 +15,7 @@ from klaude_code.prompts.attachments import (
     TOOL_RESULT_TEMPLATE,
 )
 from klaude_code.protocol import message, tools
+from klaude_code.protocol.input_syntax import AT_FILE_PATTERN
 from klaude_code.protocol.models import (
     AtFileImagesUIItem,
     AtFileOp,
@@ -61,18 +62,6 @@ def _fmt_paste_file_hint(pasted_files: dict[str, str]) -> str:
     return PASTE_FILE_HINT_TEMPLATE.format(mapping=mapping)
 
 
-# Match @ preceded by whitespace, start of line, or -> (ReadTool line number arrow)
-# Supports optional line range suffix: @file.txt#L10-20 or @file.txt#L10.
-_AT_PLAIN_STOP_CHARS = (
-    r"\u3000-\u303f"
-    r"\uff01-\uff0f"
-    r"\uff1a-\uff20"
-    r"\uff3b-\uff40"
-    r"\uff5b-\uff65"
-)
-AT_FILE_PATTERN = re.compile(rf'(?:(?<!\S)|(?<=\u2192))@("(?P<quoted>[^"]+)"|(?P<plain>[^\s{_AT_PLAIN_STOP_CHARS}]+))')
-
-
 class AtFileRef:
     """Parsed @file reference with optional line range."""
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/runtime/agent_ops.py

@@ -438,6 +438,12 @@ class AgentOperationHandler:
         # session is the only one that benefits from a suggestion.
         if agent.session.sub_agent_state is not None:
             return
+        if agent.follow_up_count() > 0:
+            log_debug(
+                f"[PromptSuggestion] skip session={session_id} reason=follow-up queue pending",
+                debug_type=DebugType.EXECUTION,
+            )
+            return
         suppress = should_suggest(agent.session)
         if suppress is not None:
             log_debug(
@@ -561,6 +567,10 @@ class AgentOperationHandler:
             session_id=operation.session_id,
         )
 
+    async def follow_up_agent(self, operation: op.FollowUpAgentOperation) -> None:
+        agent = await self.ensure_agent(operation.session_id)
+        agent.follow_up(operation.input)
+
     async def run_bash(self, operation: op.RunBashOperation) -> None:
         agent = await self.ensure_agent(operation.session_id)
 
@@ -1031,6 +1041,9 @@ class AgentRunner:
     async def run_agent(self, operation: op.RunAgentOperation) -> None:
         await self._operation_handler.run_agent(operation)
 
+    async def follow_up_agent(self, operation: op.FollowUpAgentOperation) -> None:
+        await self._operation_handler.follow_up_agent(operation)
+
     async def continue_agent(self, operation: op.ContinueAgentOperation) -> None:
         await self._operation_handler.continue_agent(operation)
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/runtime/dispatcher.py

@@ -215,6 +215,9 @@ class OperationDispatcher:
     async def handle_run_agent(self, operation: op.RunAgentOperation) -> None:
         await self._agent_runner.run_agent(operation)
 
+    async def handle_follow_up_agent(self, operation: op.FollowUpAgentOperation) -> None:
+        await self._agent_runner.follow_up_agent(operation)
+
     async def handle_run_bash(self, operation: op.RunBashOperation) -> None:
         await self._bash_runner.run_bash(operation)
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/agent/task.py

@@ -880,6 +880,8 @@ class TaskExecutor:
                 break
             empty_response_retries = 0
 
+        file_change_summary = _build_task_file_change_summary(file_change_baseline, session_ctx.file_change_summary)
+
         # Finalize metadata
         task_duration_s = time.perf_counter() - self._started_at
         accumulated = metadata_accumulator.finalize(task_duration_s)
@@ -891,7 +893,6 @@ class TaskExecutor:
         )
         session_ctx.append_history([accumulated])
 
-        file_change_summary = _build_task_file_change_summary(file_change_baseline, session_ctx.file_change_summary)
         if file_change_summary is not None:
             yield events.TaskFileChangeSummaryEvent(summary=file_change_summary, session_id=session_ctx.session_id)
             session_ctx.append_history([file_change_summary])

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/app/runtime.py

@@ -22,6 +22,7 @@ from klaude_code.config.config import ModelPreference
 from klaude_code.control.event_bus import EventBus, EventSubscription
 from klaude_code.control.event_relay import EventRelayPublisher, event_relay_socket_path
 from klaude_code.control.session_meta_relay import SessionMetaRelayPublisher, session_meta_relay_socket_path
+from klaude_code.llm.proxy_support import configured_socks_proxy_var, is_missing_socks_proxy_support_error
 from klaude_code.log import DebugType, log, log_debug, set_debug_logging
 from klaude_code.protocol import events, op, user_interaction
 from klaude_code.session.session import Session
@@ -142,6 +143,16 @@ async def initialize_app_components(
             model_override=init_config.model,
             skip_sub_agents=init_config.vanilla,
         )
+    except ImportError as exc:
+        if is_missing_socks_proxy_support_error(exc):
+            proxy_var = configured_socks_proxy_var()
+            log(("Error: SOCKS proxy is configured, but SOCKS support is not installed.", "red"))
+            if proxy_var is not None:
+                log((f"Detected SOCKS proxy from {proxy_var}.", "yellow"))
+            log(("Hint: upgrade or reinstall klaude-code so the socksio dependency is installed.", "yellow"))
+            log(("Hint: to run without proxy, unset ALL_PROXY/HTTPS_PROXY/HTTP_PROXY.", "yellow"))
+            raise typer.Exit(2) from None
+        raise
     except ValueError as exc:
         if init_config.model:
             log(

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/config/assets/builtin_config.yaml

@@ -113,7 +113,7 @@ provider_list:
     context_limit: 400000
     verbosity: low
     thinking:
-      reasoning_effort: high
+      reasoning_effort: medium
       reasoning_summary: detailed
     cost: { input: 5, output: 30, cache_read: 0.5 }
 
@@ -135,7 +135,7 @@ provider_list:
     verbosity: low
     fast_mode: true
     thinking:
-      reasoning_effort: high
+      reasoning_effort: medium
       reasoning_summary: detailed
     cost: { input: 10, output: 60, cache_read: 1 }
 
@@ -504,7 +504,7 @@ provider_list:
     context_limit: 400000
     verbosity: low
     thinking:
-      reasoning_effort: high
+      reasoning_effort: medium
       reasoning_summary: detailed
     cost: { input: 5, output: 30, cache_read: 0.5 }
   - model_name: gpt-5.5:xhigh
@@ -567,7 +567,7 @@ provider_list:
     context_limit: 400000
     verbosity: low
     thinking:
-      reasoning_effort: high
+      reasoning_effort: medium
       reasoning_summary: detailed
     cost: { input: 5, output: 30, cache_read: 0.5 }
 
@@ -722,7 +722,6 @@ provider_list:
 
 sub_agent_models:
   finder:
-  - deepseek-flash@deepseek
   - gpt-5.4-mini
   - gemini-flash:minimal
   - haiku
@@ -733,7 +732,6 @@ sub_agent_models:
   - opus
 
 fast_model:
-- deepseek-flash@deepseek
 - gpt-5.4-nano
 - gemini-flash-lite
 - gpt-5.4-mini

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/const.py

@@ -175,10 +175,8 @@ NOTIFY_COMPACT_LIMIT = 160  # Maximum length for notification body text
 # =============================================================================
 
 UI_REFRESH_RATE_FPS = 10  # UI refresh rate (frames per second)
-CROP_ABOVE_LIVE_REFRESH_PER_SECOND = 4.0  # CropAboveLive default refresh rate
-MARKDOWN_STREAM_LIVE_REPAINT_ENABLED = True  # Enable live area for streaming markdown
+MARKDOWN_STREAM_LIVE_REPAINT_ENABLED = False  # Enable live area for streaming markdown
 MARKDOWN_STREAM_SYNCHRONIZED_OUTPUT_ENABLED = True  # Use terminal "Synchronized Output" to reduce flicker
-STREAM_MAX_HEIGHT_SHRINK_RESET_LINES = 5  # Reset stream height ceiling after this shrinkage
 MARKDOWN_LEFT_MARGIN = 2  # Left margin (columns) for markdown rendering
 MARKDOWN_RIGHT_MARGIN = 0  # Right margin (columns) for markdown rendering
 
@@ -205,7 +203,7 @@ STATUS_SHIMMER_ENABLED = True  # Enable shimmer effect on status text
 STATUS_SHIMMER_PADDING = 10  # Horizontal padding for shimmer band position
 STATUS_SHIMMER_BAND_HALF_WIDTH = 5.0  # Half-width of shimmer band in characters
 STATUS_SHIMMER_ALPHA_SCALE = 0.7  # Scale factor for shimmer intensity
-STATUS_SHOW_BUFFER_LENGTH = False  # Show character count (e.g., "(213)") during text generation
+STATUS_SHOW_BUFFER_LENGTH = True  # Show character count (e.g., "(213 chars)") during text generation
 
 # =============================================================================
 # UI - Completion System

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/control/runtime/actor.py

@@ -507,7 +507,13 @@ def _is_root_operation(operation: op.Operation) -> bool:
 
 
 def _is_control_operation(operation: op.Operation) -> bool:
-    return isinstance(operation, op.InterruptOperation | op.UserInteractionRespondOperation | op.CloseSessionOperation)
+    return isinstance(
+        operation,
+        op.FollowUpAgentOperation
+        | op.InterruptOperation
+        | op.UserInteractionRespondOperation
+        | op.CloseSessionOperation,
+    )
 
 
 def _root_task_kind(operation: op.Operation) -> str:

klaude_code-2.29.0/src/klaude_code/llm/proxy_support.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+import os
+from collections.abc import Iterator, Mapping
+
+SOCKS_PROXY_ENV_VARS = (
+    "ALL_PROXY",
+    "all_proxy",
+    "HTTPS_PROXY",
+    "https_proxy",
+    "HTTP_PROXY",
+    "http_proxy",
+)
+
+_SOCKS_PROXY_SCHEMES = ("socks://", "socks4://", "socks4a://", "socks5://", "socks5h://")
+
+
+def configured_socks_proxy_var(environ: Mapping[str, str] | None = None) -> str | None:
+    env = os.environ if environ is None else environ
+    for name in SOCKS_PROXY_ENV_VARS:
+        value = env.get(name)
+        if value and value.strip().lower().startswith(_SOCKS_PROXY_SCHEMES):
+            return name
+    return None
+
+
+def is_missing_socks_proxy_support_error(exc: BaseException) -> bool:
+    for current in _iter_exception_chain(exc):
+        if not isinstance(current, ImportError):
+            continue
+        message = str(current).lower()
+        if "socks" in message and ("socksio" in message or "python-socks" in message):
+            return True
+    return False
+
+
+def _iter_exception_chain(exc: BaseException) -> Iterator[BaseException]:
+    current: BaseException | None = exc
+    seen: set[int] = set()
+    while current is not None and id(current) not in seen:
+        seen.add(id(current))
+        yield current
+        current = current.__cause__ or current.__context__

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/prompts/prompt_suggestion.py

@@ -7,11 +7,12 @@ LANGUAGE RULE (mandatory): The suggestion MUST be written in the same language t
 
 Good suggestions (based on the test "would they think 'I was just about to type that'?"):
 - After tests pass → "commit this" or "run the full suite" (EN) / "提交一个 commit" 或 "跑一下完整的测试套件" (ZH)
-- After code written and the recent chat shows a clear runnable or interactive verification path → "try it out" (EN) / "跑一下看看" (ZH)
+- After a coherent code change is complete → "summarize what changed" (EN) / "总结一下你改了啥" (ZH)
+- After a bug fix with no test yet → "add a regression test" (EN) / "加个回归测试" (ZH)
 - After you ask to continue → "yes" / "go ahead" (EN) / "好" / "继续" (ZH)
 - Task done, obvious follow-up → "push it" or "submit a PR" (EN) / "推送到远端" 或 "提交一个 PR" (ZH)
-- Large/multi-file change done, not yet committed → "run code-reviewer to check the implementation" (EN) / "运行 code-reviewer 子 Agent 检查代码实现" (ZH)
-- Code works but looks verbose or messy after edits → "clean up the code" (EN) / "精简一下代码，去掉冗余" (ZH)
+- After the conversation reveals a durable project lesson or pitfall worth preserving → "update AGENTS.md with this lesson" (EN) / "更新 AGENTS.md 记下这个坑" (ZH)
+- After partial implementation with an obvious remaining step → "continue" (EN) / "继续改" (ZH)
 - After research/search, not yet implemented → "apply the changes" or "draft a plan" (EN) / "按这个思路改一下" 或 "帮我写一个计划" (ZH)
 
 Never suggest:

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/prompts/sub_agents/prompt-sub-agent-simplifier.md

@@ -1,4 +1,3 @@
-
 You are a code simplification agent. Your job is to refine recently changed code for clarity,
 consistency, and maintainability while preserving exact functionality. This includes removing
 AI-generated code slop when it appears in the recent change.

klaude_code-2.29.0/src/klaude_code/protocol/input_syntax.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import re
+
+# Allow inline @ and / tokens after CJK text so users typing Chinese or
+# Japanese do not need to insert an extra space before the trigger character.
+# Keep English-word boundaries unchanged to avoid matching emails or URLs.
+CJK_INLINE_BOUNDARY_CHARS = (
+    r"\u3005-\u3007"
+    r"\u303b"
+    r"\u3040-\u309f"
+    r"\u30a0-\u30ff"
+    r"\u31f0-\u31ff"
+    r"\u3400-\u4dbf"
+    r"\u4e00-\u9fff"
+    r"\uf900-\ufaff"
+    r"\uff66-\uff9f"
+)
+INLINE_TOKEN_BOUNDARY = rf"(^|[\s{CJK_INLINE_BOUNDARY_CHARS}])"
+
+# Characters that terminate an @-path token besides whitespace.
+# Includes CJK punctuation and fullwidth ASCII punctuation so that a path
+# followed by e.g. Chinese "，" or "。" is not treated as part of the path.
+# Fullwidth digits/letters and halfwidth katakana are intentionally excluded
+# to keep them usable within paths.
+AT_TOKEN_STOP_CHARS = (
+    r"\u3000-\u303f"  # CJK symbols and punctuation (、。「」『』《》【】 ...)
+    r"\uff01-\uff0f"  # fullwidth ASCII punctuation (！＂＃＄％＆＇（）＊＋，－．／)
+    r"\uff1a-\uff20"  # ：；＜＝＞？＠
+    r"\uff3b-\uff40"  # ［＼］＾＿｀
+    r"\uff5b-\uff65"  # ｛｜｝～｡｢｣､･ ...
+)
+
+# Pattern to match @token for completion refresh. Supports both plain tokens
+# like `@src/file.py` and quoted tokens like `@"path with spaces/file.py"`.
+AT_COMPLETION_PATTERN = re.compile(rf'{INLINE_TOKEN_BOUNDARY}@(?P<frag>"[^"]*"|[^\s{AT_TOKEN_STOP_CHARS}]*)$')
+
+# Pattern to match inline /skill token for skill completion.
+SKILL_COMPLETION_PATTERN = re.compile(rf"{INLINE_TOKEN_BOUNDARY}(?P<prefix>//|/)(?P<frag>[^\s/]*)$")
+
+# Match @ preceded by whitespace, start of line, CJK text, or -> (ReadTool
+# line number arrow). Supports optional line range suffix in consumers:
+# @file.txt#L10-20 or @file.txt#L10.
+AT_FILE_PATTERN = re.compile(
+    rf"(?P<boundary>{INLINE_TOKEN_BOUNDARY}|(?<=\u2192))"
+    rf'(?P<at_token>@("(?P<quoted>[^"]+)"|(?P<plain>[^\s{AT_TOKEN_STOP_CHARS}]+)))'
+)
+
+# Match inline patterns for user-message rendering. Group "token" captures the
+# visual token without the leading boundary. Group "skill_token" captures one of:
+# - /skill:skill-name
+# - //skill:skill-name
+INLINE_RENDER_PATTERN = re.compile(
+    rf"(?P<boundary>{INLINE_TOKEN_BOUNDARY})"
+    rf'(?P<token>@(?:"[^"]+"|[^\s{AT_TOKEN_STOP_CHARS}]+)'
+    rf"|(?P<skill_token>//skill:[^\s/]+(?=\s|$)|/skill:[^\s/]+(?=\s|$)))"
+)

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/protocol/message.py

@@ -319,6 +319,7 @@ class UserInputPayload(BaseModel):
     text: str
     images: Sequence[ImageURLPart | ImageFilePart] | None = None
     pasted_files: dict[str, str] | None = None
+    queued_edit: bool = Field(default=False, exclude=True)
 
 
 # Helper functions

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/protocol/model_id.py

@@ -50,10 +50,9 @@ def is_claude_model_any(model_name: str | None) -> bool:
 def model_supports_eager_input_streaming(model_name: str | None) -> bool:
     """Check if the model supports the eager_input_streaming tool parameter.
 
-    Opus 4.6 and Sonnet 4.6 accept this field.
-    # TODO: Weird！ Opus 4.7 rejects it on Bedrock with 'Extra inputs are not permitted', so we exclude it.
+    Opus 4.6, Opus 4.7, and Sonnet 4.6 accept this field.
     """
-    return (is_opus_46_model(model_name) or is_sonnet_46_model(model_name)) and not is_opus_47_model(model_name)
+    return is_opus_46_model(model_name) or is_sonnet_46_model(model_name) or is_opus_47_model(model_name)
 
 
 def is_deepseek_model(model_name: str | None) -> bool:

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/protocol/op.py

@@ -26,6 +26,7 @@ class OperationType(Enum):
     """Enumeration of supported operation types."""
 
     RUN_AGENT = "run_agent"
+    FOLLOW_UP_AGENT = "follow_up_agent"
     RUN_BASH = "run_bash"
     CONTINUE_AGENT = "continue_agent"
     COMPACT_SESSION = "compact_session"
@@ -68,6 +69,17 @@ class RunAgentOperation(Operation):
         await handler.handle_run_agent(self)
 
 
+class FollowUpAgentOperation(Operation):
+    """Operation for queueing a follow-up message while an agent task is running."""
+
+    type: OperationType = OperationType.FOLLOW_UP_AGENT
+    session_id: str
+    input: UserInputPayload
+
+    async def execute(self, handler: OperationHandler) -> None:
+        await handler.handle_follow_up_agent(self)
+
+
 class RunBashOperation(Operation):
     """Operation for running a user-entered bash-mode command."""
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/protocol/op_handler.py

@@ -18,6 +18,7 @@ if TYPE_CHECKING:
         CloseSessionOperation,
         CompactSessionOperation,
         ContinueAgentOperation,
+        FollowUpAgentOperation,
         ForkAndSwitchSessionOperation,
         GenerateAwaySummaryOperation,
         GetSessionStatsOperation,
@@ -39,6 +40,10 @@ class OperationHandler(Protocol):
         """Handle a run agent operation."""
         ...
 
+    async def handle_follow_up_agent(self, operation: FollowUpAgentOperation) -> None:
+        """Handle a follow-up agent operation."""
+        ...
+
     async def handle_run_bash(self, operation: RunBashOperation) -> None:
         """Handle a bash-mode command execution operation."""
         ...

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/session/meta.py

@@ -8,7 +8,7 @@ from typing import Any, cast
 
 from pydantic import ValidationError
 
-from klaude_code.protocol import llm_param
+from klaude_code.protocol import llm_param, message
 from klaude_code.protocol.models import (
     FileChangeSummary,
     FileStatus,
@@ -37,6 +37,7 @@ class LoadedSessionMeta:
     model_config_name: str | None
     model_thinking: llm_param.Thinking | None
     next_checkpoint_id: int
+    follow_up_queue: list[message.UserInputPayload]
 
 
 def read_json_dict(path: Path) -> dict[str, Any] | None:
@@ -86,6 +87,20 @@ def _parse_todos(raw: object) -> list[TodoItem]:
     return todos
 
 
+def _parse_follow_up_queue(raw: object) -> list[message.UserInputPayload]:
+    inputs: list[message.UserInputPayload] = []
+    if not isinstance(raw, list):
+        return inputs
+    for item in cast(list[object], raw):
+        if not isinstance(item, dict):
+            continue
+        try:
+            inputs.append(message.UserInputPayload.model_validate(item))
+        except ValidationError:
+            continue
+    return inputs
+
+
 def parse_session_state(raw: object) -> SessionRuntimeState | None:
     if not isinstance(raw, str):
         return None
@@ -138,6 +153,7 @@ def parse_session_meta(raw: dict[str, Any], *, work_dir: Path) -> LoadedSessionM
         model_config_name=raw.get("model_config_name") if isinstance(raw.get("model_config_name"), str) else None,
         model_thinking=model_thinking,
         next_checkpoint_id=int(raw.get("next_checkpoint_id", 0)),
+        follow_up_queue=_parse_follow_up_queue(raw.get("follow_up_queue")),
     )
 
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/session/session.py

@@ -42,6 +42,7 @@ class Session(BaseModel):
     file_tracker: dict[str, FileStatus] = Field(default_factory=dict)
     file_change_summary: FileChangeSummary = Field(default_factory=FileChangeSummary)
     todos: list[TodoItem] = Field(default_factory=list)  # pyright: ignore[reportUnknownVariableType]
+    follow_up_queue: list[message.UserInputPayload] = Field(default_factory=list)  # pyright: ignore[reportUnknownVariableType]
     model_name: str | None = None
     session_state: SessionRuntimeState | None = None
     runtime_owner: SessionOwner | None = None
@@ -151,6 +152,7 @@ class Session(BaseModel):
             model_config_name=meta.model_config_name,
             model_thinking=meta.model_thinking,
             next_checkpoint_id=meta.next_checkpoint_id,
+            follow_up_queue=meta.follow_up_queue,
         )
 
     @classmethod
@@ -229,9 +231,16 @@ class Session(BaseModel):
             model_config_name=self.model_config_name,
             model_thinking=self.model_thinking,
             next_checkpoint_id=self.next_checkpoint_id,
+            follow_up_queue=self.follow_up_queue,
         )
         self._store.append_and_flush(session_id=self.id, items=items, meta=meta)
 
+    def set_follow_up_queue(self, items: Sequence[message.UserInputPayload]) -> None:
+        self.follow_up_queue = [item.model_copy(deep=True) for item in items]
+        payload = [item.model_dump(mode="json", exclude_none=True) for item in self.follow_up_queue]
+        if not self._store.update_meta(self.id, {"follow_up_queue": payload or None}) and payload:
+            self.ensure_meta_exists()
+
     def update_title(self, title: str | None) -> bool:
         normalized = title.strip() if isinstance(title, str) else None
         if normalized == "":
@@ -263,6 +272,7 @@ class Session(BaseModel):
             model_config_name=self.model_config_name,
             model_thinking=self.model_thinking,
             next_checkpoint_id=self.next_checkpoint_id,
+            follow_up_queue=self.follow_up_queue,
         )
         self._store.create_meta_if_missing(self.id, meta)
 

{klaude_code-2.28.0 → klaude_code-2.29.0}/src/klaude_code/session/store.py

@@ -23,7 +23,8 @@ from klaude_code.protocol.models import (
 )
 from klaude_code.session.codec import decode_jsonl_line, encode_jsonl_line
 
-_RUNTIME_META_KEYS = ("session_state", "runtime_owner", "runtime_owner_heartbeat_at")
+_RUNTIME_META_KEYS = ("session_state", "runtime_owner", "runtime_owner_heartbeat_at", "follow_up_queue")
+_DELETE_WINS_META_KEYS = ("follow_up_queue",)
 
 type SessionMetaObserver = Callable[[str, dict[str, Any]], None]
 
@@ -134,6 +135,8 @@ class JsonlSessionWriter:
                     for key in _RUNTIME_META_KEYS:
                         if key in current_meta:
                             meta[key] = current_meta[key]
+                        elif key in _DELETE_WINS_META_KEYS:
+                            meta.pop(key, None)
             meta = {k: v for k, v in meta.items() if v is not None}
 
             tmp_path.write_text(json.dumps(meta, ensure_ascii=False, indent=2), encoding="utf-8")
@@ -282,7 +285,9 @@ def build_meta_snapshot(
     model_config_name: str | None,
     model_thinking: llm_param.Thinking | None,
     next_checkpoint_id: int = 0,
+    follow_up_queue: Sequence[message.UserInputPayload] = (),
 ) -> dict[str, Any]:
+    follow_up_queue_payload = [item.model_dump(mode="json", exclude_none=True) for item in follow_up_queue]
     snapshot: dict[str, Any] = {
         "id": session_id,
         "work_dir": str(work_dir),
@@ -306,5 +311,6 @@ def build_meta_snapshot(
         if model_thinking
         else None,
         "next_checkpoint_id": next_checkpoint_id,
+        "follow_up_queue": follow_up_queue_payload or None,
     }
     return {k: v for k, v in snapshot.items() if v is not None}