refactor: rename EpisodicMemoryIndex to MemorySpace per review

Replace "index" terminology with "memory space" throughout the
memory module to match the product language used by frontends
and backend (MemorySpaceResponse, MemorySpace, etc.).

Renames:
- EpisodicMemoryIndex → MemorySpace
- EpisodicMemoryListResponse → MemorySpaceListResponse
- EpisodicMemoryCreateRequest → MemorySpaceCreateRequest

All docstrings updated to use "memory space" instead of
"memory index".

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mjnovice

packages/uipath-platform/src/uipath/platform/memory/__init__.py

@@ -3,9 +3,6 @@
 from ._memory_service import MemoryService
 from .memory import (
     CachedRecall,
-    EpisodicMemoryCreateRequest,
-    EpisodicMemoryIndex,
-    EpisodicMemoryListResponse,
     EscalationMemoryIngestRequest,
     EscalationMemoryMatch,
     EscalationMemorySearchResponse,
@@ -14,16 +11,16 @@
     MemoryMatchField,
     MemorySearchRequest,
     MemorySearchResponse,
+    MemorySpace,
+    MemorySpaceCreateRequest,
+    MemorySpaceListResponse,
     SearchField,
     SearchMode,
     SearchSettings,
 )
 
 __all__ = [
     "CachedRecall",
-    "EpisodicMemoryCreateRequest",
-    "EpisodicMemoryIndex",
-    "EpisodicMemoryListResponse",
     "EscalationMemoryIngestRequest",
     "EscalationMemoryMatch",
     "EscalationMemorySearchResponse",
@@ -33,6 +30,9 @@
     "MemorySearchRequest",
     "MemorySearchResponse",
     "MemoryService",
+    "MemorySpace",
+    "MemorySpaceCreateRequest",
+    "MemorySpaceListResponse",
     "SearchField",
     "SearchMode",
     "SearchSettings",

packages/uipath-platform/src/uipath/platform/memory/_memory_service.py

@@ -1,6 +1,6 @@
-"""Episodic Memory service.
+"""Memory Spaces service.
 
-Index management (create/list) goes through ECS v2.
+Memory space CRUD (create/list) goes through ECS v2.
 Search and escalation memory operations go through LLMOps, which
 enriches traces/feedback before forwarding to ECS.
 """
@@ -16,24 +16,24 @@
 from ..common._models import Endpoint, RequestSpec
 from ..orchestrator._folder_service import FolderService
 from .memory import (
-    EpisodicMemoryCreateRequest,
-    EpisodicMemoryIndex,
-    EpisodicMemoryListResponse,
     EscalationMemoryIngestRequest,
     EscalationMemorySearchResponse,
     MemorySearchRequest,
     MemorySearchResponse,
+    MemorySpace,
+    MemorySpaceCreateRequest,
+    MemorySpaceListResponse,
 )
 
 _MEMORY_SPACES_BASE = "/ecs_/v2/episodicmemories"
 _LLMOPS_AGENT_BASE = "/llmopstenant_/api/Agent/memory"
 
 
 class MemoryService(FolderContext, BaseService):
-    """Service for Agent Episodic Memory.
+    """Service for Agent Memory Spaces.
 
     Agent Memory allows agents to persist context across jobs using dynamic
-    few-shot retrieval. Memory indexes are folder-scoped and managed via ECS.
+    few-shot retrieval. Memory spaces are folder-scoped and managed via ECS.
     Search is routed through LLMOps, which handles trace/feedback enrichment
     and system prompt injection. Escalation memory enables agents to recall
     previously resolved escalation outcomes.
@@ -48,7 +48,7 @@ def __init__(
         super().__init__(config=config, execution_context=execution_context)
         self._folders_service = folders_service
 
-    # ── Index operations (ECS) ─────────────────────────────────────────
+    # ── Memory space operations (ECS) ──────────────────────────────────
 
     @traced(name="memory_create", run_type="uipath")
     def create(
@@ -57,17 +57,17 @@ def create(
         description: Optional[str] = None,
         is_encrypted: Optional[bool] = None,
         folder_key: Optional[str] = None,
-    ) -> EpisodicMemoryIndex:
-        """Create a new episodic memory index.
+    ) -> MemorySpace:
+        """Create a new memory space.
 
         Args:
-            name: The name of the memory index (max 128 chars).
+            name: The name of the memory space (max 128 chars).
             description: Optional description (max 1024 chars).
-            is_encrypted: Whether the index should be encrypted.
+            is_encrypted: Whether the memory space should be encrypted.
             folder_key: The folder key for the operation.
 
         Returns:
-            EpisodicMemoryIndex: The created memory index.
+            MemorySpace: The created memory space.
         """
         spec = self._create_spec(name, description, is_encrypted, folder_key)
         response = self.request(
@@ -76,7 +76,7 @@ def create(
             json=spec.json,
             headers=spec.headers,
         ).json()
-        return EpisodicMemoryIndex.model_validate(response)
+        return MemorySpace.model_validate(response)
 
     @traced(name="memory_create", run_type="uipath")
     async def create_async(
@@ -85,17 +85,17 @@ async def create_async(
         description: Optional[str] = None,
         is_encrypted: Optional[bool] = None,
         folder_key: Optional[str] = None,
-    ) -> EpisodicMemoryIndex:
-        """Asynchronously create a new episodic memory index.
+    ) -> MemorySpace:
+        """Asynchronously create a new memory space.
 
         Args:
-            name: The name of the memory index (max 128 chars).
+            name: The name of the memory space (max 128 chars).
             description: Optional description (max 1024 chars).
-            is_encrypted: Whether the index should be encrypted.
+            is_encrypted: Whether the memory space should be encrypted.
             folder_key: The folder key for the operation.
 
         Returns:
-            EpisodicMemoryIndex: The created memory index.
+            MemorySpace: The created memory space.
         """
         spec = self._create_spec(name, description, is_encrypted, folder_key)
         response = (
@@ -106,7 +106,7 @@ async def create_async(
                 headers=spec.headers,
             )
         ).json()
-        return EpisodicMemoryIndex.model_validate(response)
+        return MemorySpace.model_validate(response)
 
     @traced(name="memory_list", run_type="uipath")
     def list(
@@ -116,8 +116,8 @@ def list(
         top: Optional[int] = None,
         skip: Optional[int] = None,
         folder_key: Optional[str] = None,
-    ) -> EpisodicMemoryListResponse:
-        """List episodic memory indexes with optional OData query parameters.
+    ) -> MemorySpaceListResponse:
+        """List memory spaces with optional OData query parameters.
 
         Args:
             filter: OData $filter expression.
@@ -127,7 +127,7 @@ def list(
             folder_key: The folder key for the operation.
 
         Returns:
-            EpisodicMemoryListResponse: The list of memory indexes.
+            MemorySpaceListResponse: The list of memory spaces.
         """
         spec = self._list_spec(filter, orderby, top, skip, folder_key)
         response = self.request(
@@ -136,7 +136,7 @@ def list(
             params=spec.params,
             headers=spec.headers,
         ).json()
-        return EpisodicMemoryListResponse.model_validate(response)
+        return MemorySpaceListResponse.model_validate(response)
 
     @traced(name="memory_list", run_type="uipath")
     async def list_async(
@@ -146,8 +146,8 @@ async def list_async(
         top: Optional[int] = None,
         skip: Optional[int] = None,
         folder_key: Optional[str] = None,
-    ) -> EpisodicMemoryListResponse:
-        """Asynchronously list episodic memory indexes.
+    ) -> MemorySpaceListResponse:
+        """Asynchronously list memory spaces.
 
         Args:
             filter: OData $filter expression.
@@ -157,7 +157,7 @@ async def list_async(
             folder_key: The folder key for the operation.
 
         Returns:
-            EpisodicMemoryListResponse: The list of memory indexes.
+            MemorySpaceListResponse: The list of memory spaces.
         """
         spec = self._list_spec(filter, orderby, top, skip, folder_key)
         response = (
@@ -168,7 +168,7 @@ async def list_async(
                 headers=spec.headers,
             )
         ).json()
-        return EpisodicMemoryListResponse.model_validate(response)
+        return MemorySpaceListResponse.model_validate(response)
 
     # ── Search (LLMOps) ───────────────────────────────────────────────
 
@@ -179,13 +179,13 @@ def search(
         request: MemorySearchRequest,
         folder_key: Optional[str] = None,
     ) -> MemorySearchResponse:
-        """Search episodic memory via LLMOps.
+        """Search a memory space via LLMOps.
 
         Returns search results with scores and a systemPromptInjection
         string ready for the agent loop.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The search request payload.
             folder_key: The folder key for the operation.
 
@@ -208,13 +208,13 @@ async def search_async(
         request: MemorySearchRequest,
         folder_key: Optional[str] = None,
     ) -> MemorySearchResponse:
-        """Asynchronously search episodic memory via LLMOps.
+        """Asynchronously search a memory space via LLMOps.
 
         Returns search results with scores and a systemPromptInjection
         string ready for the agent loop.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The search request payload.
             folder_key: The folder key for the operation.
 
@@ -247,7 +247,7 @@ def escalation_search(
         re-escalating for similar situations.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The search request payload (same as regular search).
             folder_key: The folder key for the operation.
 
@@ -276,7 +276,7 @@ async def escalation_search_async(
         re-escalating for similar situations.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The search request payload (same as regular search).
             folder_key: The folder key for the operation.
 
@@ -307,7 +307,7 @@ def escalation_ingest(
         without re-escalating.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The escalation ingest payload.
             folder_key: The folder key for the operation.
         """
@@ -332,7 +332,7 @@ async def escalation_ingest_async(
         without re-escalating.
 
         Args:
-            memory_space_id: The GUID of the memory space (ECS index).
+            memory_space_id: The GUID of the memory space.
             request: The escalation ingest payload.
             folder_key: The folder key for the operation.
         """
@@ -381,7 +381,7 @@ def _create_spec(
         folder_key: Optional[str] = None,
     ) -> RequestSpec:
         folder_key = self._resolve_folder(folder_key)
-        body = EpisodicMemoryCreateRequest(
+        body = MemorySpaceCreateRequest(
             name=name,
             description=description,
             is_encrypted=is_encrypted,

packages/uipath-platform/src/uipath/platform/memory/memory.py

@@ -1,6 +1,6 @@
-"""Pydantic models for the Episodic Memory API.
+"""Pydantic models for the Memory Spaces API.
 
-Index management goes through ECS v2.  Search goes through LLMOps,
+Memory space CRUD goes through ECS v2. Search goes through LLMOps,
 which enriches traces/feedback before forwarding to ECS.
 Escalation memory operations also go through LLMOps.
 """
@@ -14,7 +14,7 @@
 
 
 class SearchMode(str, Enum):
-    """Search mode for episodic memory queries."""
+    """Search mode for memory space queries."""
 
     Hybrid = "Hybrid"
     Semantic = "Semantic"
@@ -65,11 +65,11 @@ class MemoryMatchField(BaseModel):
     weighted_score: float = Field(..., alias="weightedScore")
 
 
-# ── ECS request models (index CRUD) ───────────────────────────────────
+# ── ECS request models (memory space CRUD) ────────────────────────────
 
 
-class EpisodicMemoryCreateRequest(BaseModel):
-    """Request payload for creating an episodic memory index (ECS)."""
+class MemorySpaceCreateRequest(BaseModel):
+    """Request payload for creating a memory space (ECS)."""
 
     model_config = ConfigDict(populate_by_name=True)
 
@@ -81,8 +81,8 @@ class EpisodicMemoryCreateRequest(BaseModel):
 # ── ECS response models ───────────────────────────────────────────────
 
 
-class EpisodicMemoryIndex(BaseModel):
-    """An episodic memory index (folder-scoped, from ECS)."""
+class MemorySpace(BaseModel):
+    """A memory space (folder-scoped, from ECS)."""
 
     model_config = ConfigDict(populate_by_name=True)
 
@@ -96,12 +96,12 @@ class EpisodicMemoryIndex(BaseModel):
     is_encrypted: bool = Field(default=False, alias="isEncrypted")
 
 
-class EpisodicMemoryListResponse(BaseModel):
-    """OData response from listing episodic memory indexes (ECS)."""
+class MemorySpaceListResponse(BaseModel):
+    """OData response from listing memory spaces (ECS)."""
 
     model_config = ConfigDict(populate_by_name=True)
 
-    value: List[EpisodicMemoryIndex] = Field(default_factory=list, alias="value")
+    value: List[MemorySpace] = Field(default_factory=list, alias="value")
 
 
 # ── LLMOps search models ──────────────────────────────────────────────

packages/uipath-platform/tests/services/test_memory_service.py

@@ -7,14 +7,14 @@
 
 from uipath.platform import UiPathApiConfig, UiPathExecutionContext
 from uipath.platform.memory import (
-    EpisodicMemoryIndex,
-    EpisodicMemoryListResponse,
     EscalationMemoryIngestRequest,
     EscalationMemorySearchResponse,
     MemoryMatch,
     MemoryMatchField,
     MemorySearchRequest,
     MemorySearchResponse,
+    MemorySpace,
+    MemorySpaceListResponse,
     SearchField,
     SearchMode,
     SearchSettings,
@@ -120,7 +120,7 @@ def test_create_memory_space(
                 description="A test memory space",
             )
 
-            assert isinstance(result, EpisodicMemoryIndex)
+            assert isinstance(result, MemorySpace)
             assert result.id == "aaaa-bbbb-cccc-dddd"
             assert result.name == "test-memory-space"
             assert result.memories_count == 5
@@ -194,7 +194,7 @@ def test_list_memory_spaces(
 
             result = service.list()
 
-            assert isinstance(result, EpisodicMemoryListResponse)
+            assert isinstance(result, MemorySpaceListResponse)
             assert len(result.value) == 1
             assert result.value[0].name == "test-memory-space"
 
@@ -219,7 +219,7 @@ def test_list_with_odata_params(
                 skip=5,
             )
 
-            assert isinstance(result, EpisodicMemoryListResponse)
+            assert isinstance(result, MemorySpaceListResponse)
 
         def test_list_empty(
             self,
@@ -237,7 +237,7 @@ def test_list_empty(
 
             result = service.list()
 
-            assert isinstance(result, EpisodicMemoryListResponse)
+            assert isinstance(result, MemorySpaceListResponse)
             assert len(result.value) == 0
 
     class TestSearch: