feat(planner): persist reusable action semantics

tests/test_tool_specs.py

@@ -13,7 +13,9 @@ from runtime.tool_specs import (
 )
 
 
-def test_action_tool_specs_has_five_entries_and_all_tool_specs_adds_finish_task() -> None:
+def test_action_tool_specs_has_five_entries_and_all_tool_specs_adds_finish_task() -> (
+    None
+):
     assert len(ACTION_TOOL_SPECS) == 5
     assert len(ALL_TOOL_SPECS) == 6
     assert ALL_TOOL_SPECS == [*ACTION_TOOL_SPECS, FINISH_TASK_SPEC]
@@ -33,32 +35,70 @@ def test_every_tool_spec_schema_forbids_additional_properties() -> None:
 
 
 def test_tap_spec_requires_x_and_y() -> None:
-    assert TAP_SPEC.parameters["required"] == ["x", "y"]
-    assert set(TAP_SPEC.parameters["properties"]) == {"x", "y"}
+    assert TAP_SPEC.parameters["required"] == ["x", "y", "purpose", "expected_outcome"]
+    assert set(TAP_SPEC.parameters["properties"]) == {
+        "x",
+        "y",
+        "purpose",
+        "expected_outcome",
+    }
 
 
 def test_swipe_spec_requires_coordinates_and_makes_duration_optional() -> None:
-    assert SWIPE_SPEC.parameters["required"] == ["start_x", "start_y", "end_x", "end_y"]
+    assert SWIPE_SPEC.parameters["required"] == [
+        "start_x",
+        "start_y",
+        "end_x",
+        "end_y",
+        "purpose",
+        "expected_outcome",
+    ]
     assert set(SWIPE_SPEC.parameters["properties"]) == {
         "start_x",
         "start_y",
         "end_x",
         "end_y",
         "duration_ms",
+        "purpose",
+        "expected_outcome",
     }
     assert "duration_ms" not in SWIPE_SPEC.parameters["required"]
     assert SWIPE_SPEC.parameters["properties"]["duration_ms"]["default"] == 500
 
 
 def test_input_text_spec_requires_text() -> None:
-    assert INPUT_TEXT_SPEC.parameters["required"] == ["text"]
-    assert set(INPUT_TEXT_SPEC.parameters["properties"]) == {"text"}
+    assert INPUT_TEXT_SPEC.parameters["required"] == [
+        "text",
+        "purpose",
+        "expected_outcome",
+    ]
+    assert set(INPUT_TEXT_SPEC.parameters["properties"]) == {
+        "text",
+        "purpose",
+        "expected_outcome",
+    }
 
 
 def test_launch_and_terminate_app_specs_require_app_id() -> None:
     for spec in (LAUNCH_APP_SPEC, TERMINATE_APP_SPEC):
-        assert spec.parameters["required"] == ["app_id"]
-        assert set(spec.parameters["properties"]) == {"app_id"}
+        assert spec.parameters["required"] == [
+            "app_id",
+            "purpose",
+            "expected_outcome",
+        ]
+        assert set(spec.parameters["properties"]) == {
+            "app_id",
+            "purpose",
+            "expected_outcome",
+        }
+
+
+def test_action_metadata_is_required_nonempty_text() -> None:
+    for spec in ACTION_TOOL_SPECS:
+        for field_name in ("purpose", "expected_outcome"):
+            field = spec.parameters["properties"][field_name]
+            assert field["type"] == "string"
+            assert field["minLength"] == 1
 
 
 def test_finish_task_spec_requires_success_and_reason() -> None: