[kimi] Add /api/matrix/memory/search endpoint (#678) #740

kimi · 2026-03-21T14:52:01Z

kimi commented

2026-03-21 14:52:01 +00:00

Fixes #678

Summary

Adds GET /api/matrix/memory/search?q=<query> endpoint that allows Matrix visitors to search Timmy's memory. Results appear as floating crystal-ball text in the Workshop room.

Changes

src/dashboard/routes/world.py: Added /api/matrix/memory/search endpoint with:
- IP-based rate limiting (1 request per 5 seconds per IP)
- Query validation (returns 400 if missing/empty)
- Memory search using timmy.memory_system.search_memories()
- Response formatting with text truncation (200 chars), relevance scoring, timestamps
- Graceful degradation (returns empty array on failure)
- Max 5 results per query
tests/dashboard/test_world_api.py: Added comprehensive tests covering:
- Query parameter validation
- Response structure and formatting
- Text truncation
- Relevance score rounding
- Rate limiting (per-IP, Retry-After header)
- Graceful degradation
- URL encoding support

API Response Format

[
  {
    "text": "Memory content (truncated to 200 chars)...",
    "relevance": 0.9234,
    "created_at": "2026-03-21T10:00:00Z",
    "context_type": "conversation"
  }
]

Testing

tox -e unit passes (2535 passed)
tox -e lint passes
tox -e pre-push passes (2552 passed, 73%+ coverage)

Fixes #678 ## Summary Adds GET `/api/matrix/memory/search?q=<query>` endpoint that allows Matrix visitors to search Timmy's memory. Results appear as floating crystal-ball text in the Workshop room. ## Changes - **src/dashboard/routes/world.py**: Added `/api/matrix/memory/search` endpoint with: - IP-based rate limiting (1 request per 5 seconds per IP) - Query validation (returns 400 if missing/empty) - Memory search using `timmy.memory_system.search_memories()` - Response formatting with text truncation (200 chars), relevance scoring, timestamps - Graceful degradation (returns empty array on failure) - Max 5 results per query - **tests/dashboard/test_world_api.py**: Added comprehensive tests covering: - Query parameter validation - Response structure and formatting - Text truncation - Relevance score rounding - Rate limiting (per-IP, Retry-After header) - Graceful degradation - URL encoding support ## API Response Format ```json [ { "text": "Memory content (truncated to 200 chars)...", "relevance": 0.9234, "created_at": "2026-03-21T10:00:00Z", "context_type": "conversation" } ] ``` ## Testing - `tox -e unit` passes (2535 passed) - `tox -e lint` passes - `tox -e pre-push` passes (2552 passed, 73%+ coverage)

kimi added 1 commit 2026-03-21 14:52:02 +00:00

feat: Add /api/matrix/memory/search endpoint — visitors query Timmy's memory

Tests / lint (pull_request) Has been cancelled

Details

Tests / test (pull_request) Has been cancelled

Details

4a7f362165

Implements GET /api/matrix/memory/search?q=<query> endpoint that allows
Matrix visitors to search Timmy's memory. Results are formatted for the
3D world display.

Features:
- Returns JSON array of memory snippets with text (truncated 200 chars),
  relevance (0-1), created_at, and context_type
- Max 5 results per query
- Returns 400 if q param missing or empty
- Rate limited to 1 search per 5 seconds per IP
- Reuses existing memory_system.search() internals
- Graceful degradation on search failure (returns empty array)

Files changed:
- src/dashboard/routes/world.py: Added endpoint and helper functions
- tests/dashboard/test_world_api.py: Added comprehensive tests

Refs #678

kimi referenced this pull request

2026-03-21 14:52:17 +00:00

[kimi-task] [feat] Add /api/matrix/memory/search endpoint — visitors query Timmy's memory #678

kimi merged commit ddadc95e55 into main

2026-03-21 14:52:32 +00:00

kimi deleted branch kimi/issue-678

2026-03-21 14:52:32 +00:00

kimi referenced this issue from a commit

2026-03-21 14:52:34 +00:00

[kimi] Add /api/matrix/memory/search endpoint (#678) (#740)

Sign in to join this conversation.