Docs: Updating PythonSDK Server content for new API Endpoints (Semantic Memory)#1083
Merged
Merged
Conversation
jealous
approved these changes
Feb 27, 2026
Signed-off-by: Sarah Scargall <sarah.scargall@memverge.com>
Signed-off-by: Sarah Scargall <sarah.scargall@memverge.com>
Signed-off-by: Sarah Scargall <sarah.scargall@memverge.com>
Signed-off-by: Sarah Scargall <sarah.scargall@memverge.com>
e74ad20 to
471d01b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose of the change
This PR performs a comprehensive technical update to the Python SDK Server documentation. It aligns the server-side
.mdxfiles with the actual v2 backend architecture found inrouter.py,spec.py, andservice.py. The primary goal is to resolve terminology discrepancies and document the internal resource management logic (Reference Counting/Caching) that was previously undocumented.Description
This update transitions the server documentation from a high-level overview to a technical implementation guide:
server.mdxandmemory_types.mdxto reflect the FastAPI router structure and the shared Pydantic models inspec.py.episodic_memory_manager.mdxto accurately describe the Reference Counting and Instance Caching mechanisms used in the server core.episodic_memory.mdxto reflect the server-side mapping of SDKproducerfields to internalproducer_idfields.Fixes/Closes
Fixes #1047
Closes #975
Type of change
How Has This Been Tested?
memmachine/server/api_v2/router.pyandmemmachine/common/api/spec.py.semantic_memory.mdxand theserver.mdxentry point viamint dev.Test Results: All server-side Enums (MemoryType, EpisodeType) and Specs (AddSemanticTagSpec, etc.) now match the source code exactly.
Checklist
Maintainer Checklist
Screenshots/Gifs
Screenshot 1 - Updated Server Implementation Page (1 of 3):

Screenshot 2 - Updated Server Implementation Page (2 of 3):

Screenshot 3 - Updated Server Implementation Page (3 of 3):

Screenshot 4 - Updated Memory Types & Models Page (1 of 3):

Screenshot 5 - Updated Memory Types & Models Page (2 of 3):

Screenshot 6 - Updated Memory Types & Models Page (3 of 3):

Screenshot 7 - Updated Episodic Memory Page (1 of 3):

Screenshot 8 - Updated Episodic Memory Page (2 of 3):

Screenshot 9 - Updated Episodic Memory Page (3 of 3):

Screenshot 10 - Updated Semantic Memory (was Profile Memory) Page (1 of 3):

Screenshot 11 - Updated Semantic Memory Page (2 of 3):

Screenshot 12 - Updated Semantic Memory Page (3 of 3):

Screenshot 13 - Updated Episodic Memory Manager Page (1 of 3):

Screenshot 14 - Updated Episodic Memory Manager Page (2 of 3):

Screenshot 15 - Updated Episodic Memory manager Page (3 of 3):

Further comments
Note to Reviewers: This PR is a companion to the Client SDK PR#1074. While the Client PR focuses on how to use the memory, this PR focuses on how the server implements and manages those resources. Specifically, it clarifies the transition from "Profile" to "Semantic" stores, which is a breaking change in documentation terminology but an alignment with existing backend code.
Also, Screenshots 2 and 3 hold a different left menu than the others. The others are correct and show updated changes to docs.json that those do not.