refactor: clean CLI taxonomy — canonical subcommands, merged memory.update, no aliases

- calendar: split write → create/read/update/delete/share
- contacts: rename lookup → read
- memory: merge write+forget → update (unified action field in operations)
- Remove all alias/normalization logic from adapter and handlers
- Update tool_postprocessor ui_hints builders to canonical keys
- Remove frontend legacy TOOL_CALL_START/ARGS/END events and ToolCallItem
- Update SKILL.md files and protocol docs
- Update tests and settings screens

backend/tests/unit/core/agentscope/tools/test_cli_calendar_handler.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from core.agentscope.tools.cli.handler_calendar import (
+    _resolve_read_range,
+)
+from core.agentscope.tools.cli.models import CliCommand
+
+
+def test_resolve_read_range_supports_date_timezone_fallback() -> None:
+    request = CliCommand(
+        command="calendar",
+        subcommand="read",
+        owner_id="u1",
+        args={"date": "2026-04-23", "timezone": "Asia/Shanghai"},
+    )
+
+    start_at, end_at, error = _resolve_read_range(request)
+
+    assert error is None
+    assert start_at is not None
+    assert end_at is not None
+    assert start_at.isoformat() == "2026-04-22T16:00:00+00:00"
+    assert end_at.isoformat() == "2026-04-23T16:00:00+00:00"
+
+
+def test_resolve_read_range_rejects_bad_date() -> None:
+    request = CliCommand(
+        command="calendar",
+        subcommand="read",
+        owner_id="u1",
+        args={"date": "2026/04/23", "timezone": "Asia/Shanghai"},
+    )
+
+    start_at, end_at, error = _resolve_read_range(request)
+
+    assert start_at is None
+    assert end_at is None
+    assert error == "date must be YYYY-MM-DD"

backend/tests/unit/core/agentscope/tools/test_cli_handlers_router.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from core.agentscope.tools.cli.handlers import build_router
+
+
+def test_router_registers_only_new_canonical_subcommands() -> None:
+    router = build_router()
+
+    assert ("calendar", "create") in router.command_pairs
+    assert ("calendar", "read") in router.command_pairs
+    assert ("calendar", "update") in router.command_pairs
+    assert ("calendar", "delete") in router.command_pairs
+    assert ("calendar", "share") in router.command_pairs
+    assert ("contacts", "read") in router.command_pairs
+    assert ("memory", "update") in router.command_pairs
+
+    assert ("calendar", "write") not in router.command_pairs
+    assert ("contacts", "lookup") not in router.command_pairs
+    assert ("memory", "write") not in router.command_pairs
+    assert ("memory", "forget") not in router.command_pairs

backend/tests/unit/core/agentscope/tools/test_tool_postprocessor.py

@@ -22,35 +22,54 @@ def _make_tool_output(
     )
 
 
-def test_postprocess_calendar_read_success() -> None:
+def test_postprocess_calendar_read_has_ui_hints() -> None:
     output = _make_tool_output(command="calendar", subcommand="read", status=ToolStatus.SUCCESS, data={"total": 5, "items": []})
     processed = postprocess_tool_output(output)
     assert processed.ui_hints is not None
-    assert processed.ui_hints["view"] == "calendar_event_list"
-    assert processed.ui_hints["total"] == 5
+    assert processed.ui_hints["intent"] == "list"
 
 
-def test_postprocess_calendar_write_partial() -> None:
-    output = _make_tool_output(command="calendar", subcommand="write", status=ToolStatus.PARTIAL, data={"status": "partial", "results": []})
+def test_postprocess_calendar_create_partial() -> None:
+    output = _make_tool_output(command="calendar", subcommand="create", status=ToolStatus.PARTIAL, data={"status": "partial", "success": 1, "failed": 1, "results": []})
     processed = postprocess_tool_output(output)
     assert processed.ui_hints is not None
-    assert processed.ui_hints["view"] == "calendar_batch_result"
-    assert processed.ui_hints["status"] == "partial"
+    assert processed.ui_hints["intent"] == "status"
+    assert processed.ui_hints["status"] == "warning"
 
 
-def test_postprocess_contacts_lookup_success() -> None:
-    output = _make_tool_output(command="contacts", subcommand="lookup", status=ToolStatus.SUCCESS, data={"friends_count": 3, "friends": []})
+def test_postprocess_contacts_read_has_ui_hints() -> None:
+    output = _make_tool_output(command="contacts", subcommand="read", status=ToolStatus.SUCCESS, data={"friends_count": 3, "friends": []})
     processed = postprocess_tool_output(output)
     assert processed.ui_hints is not None
-    assert processed.ui_hints["view"] == "contact_list"
-    assert processed.ui_hints["friends_count"] == 3
+    assert processed.ui_hints["intent"] == "list"
+    assert processed.ui_hints["status"] == "success"
 
 
-def test_postprocess_memory_forget_success() -> None:
-    output = _make_tool_output(command="memory", subcommand="forget", status=ToolStatus.SUCCESS, data={"status": "success", "forgotten": 5})
+def test_postprocess_memory_update_has_ui_hints() -> None:
+    output = _make_tool_output(
+        command="memory",
+        subcommand="update",
+        status=ToolStatus.SUCCESS,
+        data={
+            "status": "success",
+            "success": 1,
+            "failed": 0,
+            "forgotten": 5,
+            "results": [
+                {
+                    "memoryType": "user",
+                    "action": "delete",
+                    "status": "success",
+                    "forgotten": 5,
+                    "memoryId": "mem_1",
+                }
+            ],
+        },
+    )
     processed = postprocess_tool_output(output)
     assert processed.ui_hints is not None
-    assert processed.ui_hints["forgotten"] == 5
+    assert processed.ui_hints["intent"] == "status"
+    assert processed.ui_hints["status"] == "success"
 
 
 def test_postprocess_failure_no_ui_hints() -> None:

backend/tests/unit/core/agentscope/tools/test_toolkit.py

@@ -29,6 +29,16 @@ def test_validate_accepts_known_skills() -> None:
     assert result == {"calendar", "contacts"}
 
 
+def test_validate_rejects_unknown_allowed_command() -> None:
+    from core.agentscope.tools.toolkit import _validate_allowed_commands
+
+    try:
+        _validate_allowed_commands({"calendar", "unknown_command"})
+        assert False, "should have raised"
+    except ValueError as exc:
+        assert "unknown_command" in str(exc)
+
+
 def test_build_toolkit_registers_project_cli() -> None:
     toolkit = build_toolkit()
     schemas = toolkit.get_json_schemas()