docs: add descriptive parameter examples

Updates documentation with clean examples using descriptive parameter names:
- Update API documentation example with descriptive recency parameters
- Add comprehensive recency configuration section to client README
- Demonstrate clear, readable parameter naming

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: abrookins

agent-memory-client/README.md

@@ -240,6 +240,39 @@ results = await client.search_long_term_memory(
 )
 ```
 
+## Recency-Aware Search
+
+```python
+from agent_memory_client.models import RecencyConfig
+
+# Search with recency-aware ranking
+recency_config = RecencyConfig(
+    recency_boost=True,
+    semantic_weight=0.8,           # Weight for semantic similarity
+    recency_weight=0.2,            # Weight for recency score
+    freshness_weight=0.6,          # Weight for freshness component
+    novelty_weight=0.4,            # Weight for novelty/age component
+    half_life_last_access_days=7,  # Last accessed decay half-life
+    half_life_created_days=30,     # Creation date decay half-life
+    server_side_recency=True       # Use server-side optimization
+)
+
+results = await client.search_long_term_memory(
+    text="project updates",
+    recency=recency_config,
+    limit=10
+)
+
+# Legacy parameter names are still supported for backward compatibility
+legacy_config = RecencyConfig(
+    recency_boost=True,
+    w_sem=0.8,      # Deprecated: use semantic_weight
+    w_recency=0.2,  # Deprecated: use recency_weight
+    wf=0.6,         # Deprecated: use freshness_weight
+    wa=0.4          # Deprecated: use novelty_weight
+)
+```
+
 ## Error Handling
 
 ```python

docs/api.md

@@ -89,17 +89,19 @@ The following endpoints are available:
     "last_accessed": { "gt": 1704063600 },
     "user_id": { "eq": "user-456" },
     "recency_boost": true,
-    "recency_w_sem": 0.8,
-    "recency_w_recency": 0.2,
-    "recency_wf": 0.6,
-    "recency_wa": 0.4,
+    "recency_semantic_weight": 0.8,
+    "recency_recency_weight": 0.2,
+    "recency_freshness_weight": 0.6,
+    "recency_novelty_weight": 0.4,
     "recency_half_life_last_access_days": 7.0,
     "recency_half_life_created_days": 30.0
   }
   ```
 
   When `recency_boost` is enabled (default), results are re-ranked using a combined score of semantic similarity and a recency score computed from `last_accessed` and `created_at`. The optional fields adjust weighting and half-lives. The server rate-limits updates to `last_accessed` in the background when results are returned.
 
+  **Note:** Legacy parameter names (`recency_w_sem`, `recency_w_recency`, `recency_wf`, `recency_wa`) are still supported for backward compatibility but are deprecated. Use the descriptive names shown above for new implementations.
+
 - **POST /v1/long-term-memory/forget**
   Trigger a forgetting pass (admin/maintenance).