kimi 2.6 (#775)

* kimi 2.6
agent trace uploads

* Relax brittle internal prompt unit test

* improve internal slash command help

* fix review issues (agent name etc.)

* fix issues, version up, hf dep

* serialize zero-arg tool calls as {}

* timestamp fixes

* Fix session export session lookup and relax kimi alias test

* Fix ACP implicit session export lookup

Author: evalstate

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.6.19"
+version = "0.6.20"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -46,6 +46,7 @@ dependencies = [
     "uvloop==0.22.1; platform_system != 'Windows'",
     "multilspy==0.0.15",
     "ruamel.yaml==0.19.1",
+    "huggingface_hub==1.9.0",
     "mslex==1.3.0",
 ]
 
@@ -116,7 +117,6 @@ testpaths = ["tests"]
 [dependency-groups]
 dev = [
     "boto3>=1.35.0",
-    "huggingface_hub==1.9.0",
     "multilspy>=0.0.15",
     "pre-commit>=4.0.1",
     "pydantic>=2.10.4",

resources/shared/smart_prompt.md

@@ -1,9 +1,8 @@
-You are a helpful AI Agent.
+You are a helpful AI Agent running in the `fast-agent` harness.
 
 You have the ability to create sub-agents and delegate tasks to them.
 
-Information about how to do so is below. Pre-existing cards may be in the `fast-agent environment` directories. You may issue
-multiple calls in parallel to new or existing AgentCard definitions.
+Information about how to do so is below. Pre-existing cards may be in the `fast-agent environment` directories. You may issue multiple calls in parallel to new or existing AgentCard definitions.
 
 {{agentInternalResources}}
 
@@ -13,11 +12,13 @@ multiple calls in parallel to new or existing AgentCard definitions.
 {{env}}
 
 fast-agent environment paths:
+
 - Environment root: {{environmentDir}}
 - Agent cards: {{environmentAgentCardsDir}}
 - Tool cards: {{environmentToolCardsDir}}
 
 Current agent identity:
+
 - Name: {{agentName}}
 - Type: {{agentType}}
 - AgentCard path: {{agentCardPath}}
@@ -42,4 +43,6 @@ declare them with `mcp_connect` entries (`target` + optional `name`). Prefer exp
 `defer_loading: true` automatically enables server-side `tool_search` for lazy
 remote tool or connector loading.
 
+Mermaid diagrams between code fences are supported.
+
 The current date is {{currentDate}}.

src/fast_agent/acp/slash/handlers/cards_manager.py

@@ -4,6 +4,7 @@
 
 from typing import TYPE_CHECKING, cast
 
+from fast_agent.commands.command_discovery import render_direct_command_help
 from fast_agent.commands.handlers import cards_manager as cards_handlers
 
 if TYPE_CHECKING:
@@ -12,6 +13,10 @@
 
 
 async def handle_cards(handler: "SlashCommandHandler", arguments: str | None = None) -> str:
+    direct_help = render_direct_command_help("cards", arguments)
+    if direct_help is not None:
+        return direct_help
+
     tokens = (arguments or "").strip().split(maxsplit=1)
     action = tokens[0].lower() if tokens else "list"
     remainder = tokens[1] if len(tokens) > 1 else ""

src/fast_agent/acp/slash/handlers/commands.py

@@ -35,6 +35,7 @@ async def handle_commands(handler: "SlashCommandHandler", arguments: str | None
     if request.as_json:
         return render_commands_json(
             command_name=request.command_name,
+            action_name=request.action_name,
             command_names=available_names,
         )
 
@@ -51,8 +52,14 @@ async def handle_commands(handler: "SlashCommandHandler", arguments: str | None
             f"Use `/commands` to list available commands.{suggestion_line}"
         )
 
-    detail = render_command_detail_markdown(request.command_name)
+    detail = render_command_detail_markdown(request.command_name, request.action_name)
     if detail is not None:
         return detail
 
+    if request.action_name is not None:
+        return (
+            f"# commands\n\nNo discovery metadata for `/{request.command_name} "
+            f"{request.action_name}` yet."
+        )
+
     return f"# commands\n\nNo discovery metadata for `{request.command_name}` yet."

src/fast_agent/acp/slash/handlers/model.py

@@ -6,6 +6,7 @@
 from typing import TYPE_CHECKING, cast
 
 from fast_agent.acp.command_io import ACPCommandIO
+from fast_agent.commands.command_discovery import render_direct_command_help
 from fast_agent.commands.context import CommandContext, StaticAgentProvider
 from fast_agent.commands.handlers import model as model_handlers
 from fast_agent.commands.handlers import models_manager as models_manager_handlers
@@ -27,6 +28,10 @@ async def _handle_model_like(
     *,
     heading_prefix: str,
 ) -> str:
+    direct_help = render_direct_command_help(heading_prefix, arguments)
+    if direct_help is not None:
+        return direct_help
+
     remainder = (arguments or "").strip()
     value = None
     command_kind = "reasoning" if heading_prefix == "model" else "doctor"

src/fast_agent/acp/slash/handlers/session.py

@@ -4,11 +4,17 @@
 
 from typing import TYPE_CHECKING, cast
 
+from fast_agent.commands.handlers import session_export as session_export_handlers
 from fast_agent.commands.handlers import sessions as sessions_handlers
 from fast_agent.commands.handlers.shared import clear_agent_histories
 from fast_agent.commands.renderers.session_markdown import render_session_list_markdown
+from fast_agent.commands.results import CommandOutcome
+from fast_agent.commands.session_export_help import render_session_export_help_markdown
 from fast_agent.commands.session_summaries import build_session_list_summary
-from fast_agent.commands.shared_command_intents import parse_session_command_intent
+from fast_agent.commands.shared_command_intents import (
+    parse_session_command_intent,
+    should_default_export_agent,
+)
 
 if TYPE_CHECKING:
     from fast_agent.acp.command_io import ACPCommandIO
@@ -43,13 +49,15 @@ async def handle_session(handler: "SlashCommandHandler", arguments: str | None =
         return await handle_session_delete(handler, intent.argument)
     if intent.action == "pin":
         return await handle_session_pin(handler, value=intent.pin_value, target=intent.pin_target)
+    if intent.action == "export":
+        return await handle_session_export(handler, intent)
 
     return "\n".join(
         [
             "# session",
             "",
             f"Unknown /session action: {intent.raw_subcommand or ''}",
-            "Usage: /session [list|new|resume|title|fork|delete|pin] [args]",
+            "Usage: /session [list|new|resume|title|fork|delete|pin|export] [args]",
         ]
     )
 
@@ -153,3 +161,45 @@ async def handle_session_pin(
         target=target,
     )
     return handler._format_outcome_as_markdown(outcome, "session pin", io=io)
+
+
+async def handle_session_export(handler: "SlashCommandHandler", intent) -> str:
+    if intent.export_help:
+        return render_session_export_help_markdown()
+
+    ctx = handler._build_command_context()
+    io = cast("ACPCommandIO", ctx.io)
+    manager = ctx.resolve_session_manager()
+    current_session = manager.current_session
+    current_session_id = current_session.info.name if current_session is not None else None
+    if current_session_id != handler.session_id:
+        try:
+            handler_session = manager.get_session(handler.session_id)
+        except AttributeError:
+            handler_session = None
+        current_session_id = handler_session.info.name if handler_session is not None else None
+    if intent.export_target is None and current_session_id is None:
+        outcome = CommandOutcome()
+        outcome.add_message(
+            "No active session to export.",
+            channel="error",
+            right_info="session",
+        )
+        return handler._format_outcome_as_markdown(outcome, "session export", io=io)
+    agent_name = intent.export_agent
+    if agent_name is None and should_default_export_agent(
+        intent.export_target,
+        current_session_id=current_session_id,
+    ):
+        agent_name = handler.current_agent_name
+    outcome = await session_export_handlers.handle_session_export(
+        ctx,
+        target=intent.export_target,
+        agent_name=agent_name,
+        output_path=intent.export_output,
+        hf_dataset=intent.export_hf_dataset,
+        hf_dataset_path=intent.export_hf_dataset_path,
+        current_session_id=current_session_id,
+        error=intent.export_error,
+    )
+    return handler._format_outcome_as_markdown(outcome, "session export", io=io)

src/fast_agent/acp/slash/handlers/skills.py

@@ -15,6 +15,7 @@
     ToolCallStart,
 )
 
+from fast_agent.commands.command_discovery import render_direct_command_help
 from fast_agent.commands.handlers import skills as skills_handlers
 from fast_agent.commands.renderers.skills_markdown import (
     render_marketplace_skills,
@@ -112,6 +113,10 @@ async def handle_skills_available(
 
 
 async def handle_skills(handler: "SlashCommandHandler", arguments: str | None = None) -> str:
+    direct_help = render_direct_command_help("skills", arguments)
+    if direct_help is not None:
+        return direct_help
+
     tokens = (arguments or "").strip().split(maxsplit=1)
     action = tokens[0].lower() if tokens else "list"
     remainder = tokens[1] if len(tokens) > 1 else ""

src/fast_agent/acp/slash_commands.py

@@ -216,7 +216,7 @@ def __init__(
         self._acp_context: ACPContext | None = None
 
         cards_action_hint = "|".join(
-            action for action in command_action_names("cards") if action != "list"
+            action for action in command_action_names("cards") if action not in {"list", "readme", "help"}
         ) or "add|remove|update|publish|registry"
 
         # Session-level commands (always available, operate on current agent)
@@ -294,7 +294,7 @@ def __init__(
                 description="List or manage sessions",
                 input=AvailableCommandInput(
                     root=UnstructuredCommandInput(
-                        hint="[list|new|resume|title|fork|clear] [args]"
+                        hint="[list|new|resume|title|fork|delete|pin|export] [args]"
                     )
                 ),
             ),

src/fast_agent/agents/llm_decorator.py

@@ -7,6 +7,7 @@
 from collections import Counter, defaultdict
 from copy import deepcopy
 from dataclasses import dataclass
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -847,6 +848,7 @@ def _prepare_llm_call(
     ) -> _CallContext:
         """Normalize template/history handling for both generate and structured."""
         sanitized_messages, summary = self._sanitize_messages_for_llm(messages)
+        self._timestamp_messages(sanitized_messages)
         final_request_params = self._require_llm().get_request_params(request_params)
 
         use_history = final_request_params.use_history if final_request_params else True
@@ -916,9 +918,17 @@ def _persist_history(
             return
 
         history_messages = [self._strip_removed_metadata(msg) for msg in sanitized_messages]
+        assistant_message.ensure_timestamp()
         self._message_history.extend(history_messages)
         self._message_history.append(assistant_message)
 
+    @staticmethod
+    def _timestamp_messages(messages: list[PromptMessageExtended]) -> None:
+        """Attach UTC wall-clock timestamps to new turn messages before LLM execution."""
+        for message in messages:
+            if message.timestamp is None:
+                message.timestamp = datetime.now(timezone.utc)
+
     @staticmethod
     def _strip_removed_metadata(message: PromptMessageExtended) -> PromptMessageExtended:
         """Remove per-turn removed-content metadata before persisting to history."""