semantic cleanup

backend/src/api/routes/assistant/__init__.py

@@ -0,0 +1,115 @@
+# [DEF:AssistantApi:Module]
+# @COMPLEXITY: 5
+# @SEMANTICS: api, assistant, chat, command, confirmation
+# @PURPOSE: API routes for LLM assistant command parsing and safe execution orchestration.
+# @LAYER: API
+# @RELATION: DEPENDS_ON -> [TaskManager]
+# @RELATION: DEPENDS_ON -> [AssistantMessageRecord]
+# @RELATION: DEPENDS_ON -> [AssistantConfirmationRecord]
+# @RELATION: DEPENDS_ON -> [AssistantAuditRecord]
+# @INVARIANT: Risky operations are never executed without valid confirmation token.
+
+# Re-export public API for backward compatibility.
+from ._routes import router, send_message, confirm_operation, cancel_operation
+from ._routes import list_conversations, delete_conversation, get_history, get_assistant_audit
+from ._schemas import (
+    AssistantMessageRequest,
+    AssistantMessageResponse,
+    AssistantAction,
+    ConfirmationRecord,
+    CONVERSATIONS,
+    USER_ACTIVE_CONVERSATION,
+    CONFIRMATIONS,
+    ASSISTANT_AUDIT,
+    INTENT_PERMISSION_CHECKS,
+    _SAFE_OPS,
+    _DATASET_REVIEW_OPS,
+)
+from ._command_parser import _parse_command
+from ._llm_planner import _plan_intent_with_llm, _build_tool_catalog, _authorize_intent
+from ._dispatch import _dispatch_intent, _async_confirmation_summary, _clarification_text_for_intent
+from ._dataset_review import (
+    _load_dataset_review_context,
+    _plan_dataset_review_intent,
+    _dispatch_dataset_review_intent,
+)
+from ._history import (
+    _append_history,
+    _persist_message,
+    _audit,
+    _persist_audit,
+    _persist_confirmation,
+    _update_confirmation_state,
+    _load_confirmation_from_db,
+    _resolve_or_create_conversation,
+    _cleanup_history_ttl,
+    _is_conversation_archived,
+    _coerce_query_bool,
+)
+from ._resolvers import (
+    _extract_id,
+    _resolve_env_id,
+    _is_production_env,
+    _resolve_provider_id,
+    _get_default_environment_id,
+    _resolve_dashboard_id_by_ref,
+    _resolve_dashboard_id_entity,
+    _get_environment_name_by_id,
+    _extract_result_deep_links,
+    _build_task_observability_summary,
+)
+
+__all__ = [
+    "router",
+    "send_message",
+    "confirm_operation",
+    "cancel_operation",
+    "list_conversations",
+    "delete_conversation",
+    "get_history",
+    "get_assistant_audit",
+    "AssistantMessageRequest",
+    "AssistantMessageResponse",
+    "AssistantAction",
+    "ConfirmationRecord",
+    "CONVERSATIONS",
+    "USER_ACTIVE_CONVERSATION",
+    "CONFIRMATIONS",
+    "ASSISTANT_AUDIT",
+    "INTENT_PERMISSION_CHECKS",
+    "_SAFE_OPS",
+    "_DATASET_REVIEW_OPS",
+    "_parse_command",
+    "_plan_intent_with_llm",
+    "_build_tool_catalog",
+    "_authorize_intent",
+    "_dispatch_intent",
+    "_async_confirmation_summary",
+    "_clarification_text_for_intent",
+    "_load_dataset_review_context",
+    "_plan_dataset_review_intent",
+    "_dispatch_dataset_review_intent",
+    "_append_history",
+    "_persist_message",
+    "_audit",
+    "_persist_audit",
+    "_persist_confirmation",
+    "_update_confirmation_state",
+    "_load_confirmation_from_db",
+    "_resolve_or_create_conversation",
+    "_cleanup_history_ttl",
+    "_is_conversation_archived",
+    "_coerce_query_bool",
+    "_extract_id",
+    "_resolve_env_id",
+    "_is_production_env",
+    "_resolve_provider_id",
+    "_get_default_environment_id",
+    "_resolve_dashboard_id_by_ref",
+    "_resolve_dashboard_id_entity",
+    "_get_environment_name_by_id",
+    "_extract_result_deep_links",
+    "_build_task_observability_summary",
+]
+
+# [/DEF:AssistantApi:Module]