[codex] Unify Persona Runtime prompt context pipeline

.ai/index.md

@@ -35,6 +35,15 @@ Escalate when uncertain.
 7. Review for regressions, scope drift, and missing tests.
 8. Report validation status and residual risk.
 
+## Validation Efficiency
+
+- Do not add or expand automated tests by default. Add a test only when the user explicitly requests it or when one basic public input-output case is necessary to establish that the primary boundary works.
+- Keep tests at observable boundaries: provide representative input through a public entry point and assert the resulting output, serialized contract, or externally visible state.
+- Do not test private methods, internal call counts or order, temporary orchestration state, or behavior that has been replaced by a mock. Coverage percentage is not a reason to add a test.
+- Prefer direct acceptance checks, static checks, and one minimal input-output smoke case over large mocked unit suites.
+- Do not rerun an unchanged test suite. Run only the smallest relevant check after a meaningful change, and report intentionally skipped validation.
+- Preserve upstream tests unless they directly conflict with the current architecture. Clean project-added transition tests when they only lock in obsolete implementation details.
+
 ## Checklists
 
 - implementation: scoped, style preserved, assumptions visible, unrelated files untouched

astrbot/api/event/__init__.py

@@ -6,6 +6,8 @@
     ResultContentType,
 )
 from astrbot.core.platform import AstrMessageEvent
+from astrbot.core.platform.group_reply_candidate import request_group_reply_candidate
+from astrbot.core.voice import TTSState
 
 __all__ = [
     "AstrMessageEvent",
@@ -14,4 +16,6 @@
     "MessageChain",
     "MessageEventResult",
     "ResultContentType",
+    "TTSState",
+    "request_group_reply_candidate",
 ]

astrbot/api/event/filter/__init__.py

@@ -29,6 +29,9 @@
 from astrbot.core.star.register import register_on_plugin_error as on_plugin_error
 from astrbot.core.star.register import register_on_plugin_loaded as on_plugin_loaded
 from astrbot.core.star.register import register_on_plugin_unloaded as on_plugin_unloaded
+from astrbot.core.star.register import (
+    register_on_tts_state_changed as on_tts_state_changed,
+)
 from astrbot.core.star.register import register_on_using_llm_tool as on_using_llm_tool
 from astrbot.core.star.register import (
     register_on_waiting_llm_request as on_waiting_llm_request,
@@ -57,6 +60,7 @@
     "on_agent_done",
     "on_astrbot_loaded",
     "on_decorating_result",
+    "on_tts_state_changed",
     "on_llm_request",
     "on_llm_response",
     "on_plugin_error",