fix(mcp-sse): sync tool schemas for SSE/MCP parity

[jack-arturo]

Summary

Fixes the SSE server side of #90 — tool description drift between SSE and MCP transports.

• associate_memories.type: Was unconstrained string, now enum with all 16 valid relationship types (synced from automem/config.py RELATIONSHIP_TYPES)
• update_memory: Added missing type and confidence properties (MCP package already had these)
• All tools: Added parameter-level description fields to every property
• All tools: Added MCP annotations (readOnlyHint, destructiveHint) for spec compliance
• Shared constants: Extracted RELATION_TYPES and MEMORY_TYPES arrays so they're easy to keep in sync

What's NOT in this PR (separate repo / follow-up)

The MCP npm package (verygoodplugins/mcp-automem) still needs:

• per_query_limit, sort, format added to recall_memory
• store_memory expanded from 6 to 13 properties
• outputSchema definitions (both SSE and MCP)

Test plan

• All 7 existing mcp-sse-server tests pass
• No application code changes — only tool schema metadata
• Pre-commit hooks pass (conventional commit, secrets check, trailing whitespace)

Closes the SSE-server portion of #90.

Made with Cursor

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8df3c08 and b0db672.

📒 Files selected for processing (1)

• mcp-sse-server/server.js

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Improved input validation and descriptions for memory management tools.
  • Tool parameters now include clearer type constraints and relationship specifications.
  • Operations clearly marked to indicate whether they modify, read-only, or delete data.

Walkthrough

Introduces RELATION_TYPES and MEMORY_TYPES constant sets to enforce enum constraints on tool inputs. Expands input schemas for six MCP tools with richer field descriptions, annotations (readOnly, destructive), and validation rules. No functional flow changes; improves metadata for client tooling.

Changes

Cohort / File(s)	Summary
MCP Tool Schema Enhancements mcp-sse-server/server.js	Added RELATION_TYPES and MEMORY_TYPES constants; expanded and annotated input schemas for store_memory, recall_memory, associate_memories, update_memory, delete_memory, and check_database_health with richer field descriptions, enum constraints, and readOnly/destructive metadata hints.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related issues

• fix: tool description drift between SSE and MCP transports #90: This PR directly addresses SSE vs MCP schema description drift by syncing mcp-sse-server schemas to match more-complete MCP tool definitions with expanded fields and constraints.

Possibly related PRs

• feat(mcp-sse): agent-friendly recall output + tests #28: Both PRs modify mcp-sse-server/server.js's MCP tool definitions, specifically expanding recall_memory and other tool input schemas with enhanced field coverage and surface area.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main change: syncing tool schemas for SSE/MCP parity by fixing tool description drift.
Description check	✅ Passed	The description is directly related to the changeset, detailing the specific schema updates made to tools, extracted constants, test results, and what remains for follow-up.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/90-sse-tool-parity

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}