{"record":{"id":"9e133d350ca2b0e5","repo":"mem0ai/mem0","slug":"invalid-query-cannot-be-empty-or-whitespace-only","errorCode":null,"errorMessage":"Invalid query: cannot be empty or whitespace-only.","messagePattern":"Invalid query: cannot be empty or whitespace-only\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"mem0/client/main.py","lineNumber":48,"sourceCode":"from mem0.memory.telemetry import capture_client_event, client_telemetry\n\nlogger = logging.getLogger(__name__)\n\nwarnings.filterwarnings(\"default\", category=DeprecationWarning)\n\n# Setup user config\nsetup_config()\n\n# Entity parameters that must be passed via filters, not top-level\nENTITY_PARAMS = frozenset({\"user_id\", \"agent_id\", \"app_id\", \"run_id\"})\n\n\ndef _validate_and_trim_search_query(query: str) -> str:\n    if not isinstance(query, str):\n        raise ValueError(\"Invalid query: must be a non-empty string.\")\n    trimmed = query.strip()\n    if not trimmed:\n        raise ValueError(\"Invalid query: cannot be empty or whitespace-only.\")\n    return trimmed\n\n\ndef _encode_path_segment(value: Any) -> str:\n    return quote(str(value), safe=\"\")\n\n\ndef _maybe_alias_anon_to_email(user_email):\n    \"\"\"Fire $identify per prior anon ID so PostHog merges them into email.\n\n    Idempotent via telemetry.aliased_pairs: only writes markers when\n    telemetry is actually enabled, so disabling/re-enabling MEM0_TELEMETRY still works.\n    Best-effort: never raises.\n    \"\"\"\n    if client_telemetry.posthog is None:\n        return\n    if not user_email or \"@\" not in user_email:\n        return","sourceCodeStart":30,"sourceCodeEnd":66,"githubUrl":"https://github.com/mem0ai/mem0/blob/001c235229be8795e3834520467bd0d661ed8f34/mem0/client/main.py#L30-L66","documentation":"Error \"Invalid query: cannot be empty or whitespace-only.\" thrown in mem0ai/mem0.","triggerScenarios":"Thrown at mem0/client/main.py:48 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Trim the query and ensure it contains non-whitespace characters before calling search()."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"001c235229be8795e3834520467bd0d661ed8f34","analyzedAt":"2026-08-15T01:55:42.685Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}