release: 5.0.0rc3 (v5 cleanup stack + connector fields) (#90)

rc2 merged last night before this morning's mono stack landed, and today's two regenerations were pushed to that branch after the merge, so PyPI rc2 predates the current API. This is main plus those two commits plus the bump.

- `include` replaces `attach` as a typed list on GETs and an object on search
- search and write options live in the body; `moveTo` is a query param
- `namespaces.list` returns `{namespaces, pagination}`
- deletes return `count` / `status`
- new `memories.get`
- connectors: `authorization: ConnectorLink`, `system.status`, `latest_run` (mono#3413)

Spec matches production byte for byte. 39 tests, ruff, mypy pass; 39/39 steps against production with the built wheel.

Author: MaheshtheDev

MIGRATION.md

@@ -56,7 +56,7 @@ Only the API methods change. Everything around them works as before:
 | `custom_id` | `id` |
 | `q` | `query` |
 | `filters` | `filter` (typed filter expression) |
-| `include` | `attach` |
+| `include` | `include` (a list on GETs, a dict on search) |
 | search `timing` / `total` | `search_time` |
 
 ## Profile no longer searches

fern/openapi.json

@@ -21,6 +21,7 @@ actions:
   # memories
   - { target: '$.paths["/ns/{namespace}/memories"].delete', update: { x-fern-sdk-group-name: memories, x-fern-sdk-method-name: forget } }
   - { target: '$.paths["/ns/{namespace}/memories/semantic"].delete', update: { x-fern-sdk-group-name: memories, x-fern-sdk-method-name: forget_matching } }
+  - { target: '$.paths["/ns/{namespace}/memories/{id}"].get', update: { x-fern-sdk-group-name: memories, x-fern-sdk-method-name: get } }
   # profiles
   - { target: '$.paths["/ns/{namespace}/profile/buckets"].get', update: { x-fern-sdk-group-name: profiles, x-fern-sdk-method-name: get_buckets } }
   - { target: '$.paths["/ns/{namespace}/profile/buckets"].put', update: { x-fern-sdk-group-name: profiles, x-fern-sdk-method-name: set_buckets } }

fern/overlay.yaml

@@ -15,18 +15,15 @@
 # bodies stay inline because their fields become keyword arguments.
 
 # --- enums
-TaskType: POST /ns/{namespace}/document param:taskType
-DreamingMode: POST /ns/{namespace}/document param:dreaming
-FileType: POST /ns/{namespace}/document/file param:fileType
-SearchMode: POST /ns/{namespace}/search param:searchMode
+TaskType: POST /ns/{namespace}/document body.taskType
+DreamingMode: POST /ns/{namespace}/document body.dreaming
+FileType: POST /ns/{namespace}/document/file body.fileType
+SearchMode: POST /ns/{namespace}/search body.searchMode
 ListType: POST /ns/{namespace}/list/{type} param:type
 ListSort: POST /ns/{namespace}/list/{type} param:sort
 SortOrder: POST /ns/{namespace}/list/{type} param:order
 MemoryRelation: POST /ns/{namespace}/search 200.results[].included.related.parents[].relation
 ConnectorProvider: GET /connectors param:provider
-ConnectorStatus: GET /ns/{namespace}/connectors/{id} 200.status
-ConnectorSyncStatus: GET /ns/{namespace}/connectors/{id} 200.lastSync?.status
-ConnectorErrorCode: GET /ns/{namespace}/connectors/{id} 200.lastSync?.errorCode?
 ConnectorSyncTrigger: GET /ns/{namespace}/connectors/{id} 200.syncs[].trigger
 
 # --- filters
@@ -46,13 +43,17 @@ BatchAddResult: POST /ns/{namespace}/document/batch 200
 BatchAddItemResult: POST /ns/{namespace}/document/batch 200.results[]
 DeleteDocumentsResult: DELETE /ns/{namespace}/document 200
 DeleteDocumentError: DELETE /ns/{namespace}/document 200.errors[]
-DocumentAttachment: GET /ns/{namespace}/document/{id} param:attach[]
-FileUploadResult: POST /ns/{namespace}/document/file 200
+DocumentInclude: GET /ns/{namespace}/document/{id} param:include[]
+SearchInclude: POST /ns/{namespace}/search body.include
+MemoryInclude: GET /ns/{namespace}/memories/{id} param:include[]
+ConnectorInclude: GET /ns/{namespace}/connectors/{id} param:include[]
 Document: GET /ns/{namespace}/document/{id} 200
 DocumentSystem: GET /ns/{namespace}/document/{id} 200.system
 Chunk: GET /ns/{namespace}/document/{id} 200.chunks[]
 ChunkSystem: GET /ns/{namespace}/document/{id} 200.chunks[].system
 Memory: GET /ns/{namespace}/document/{id} 200.memories[]
+MemoryIncluded: GET /ns/{namespace}/memories/{id} 200.included
+MemoryDetails: GET /ns/{namespace}/memories/{id} 200
 MemorySystem: GET /ns/{namespace}/document/{id} 200.memories[].system
 
 # --- list
@@ -77,12 +78,16 @@ ForgetError: DELETE /ns/{namespace}/memories 200.errors[]
 ForgetMatch: DELETE /ns/{namespace}/memories 200.matches[]
 
 # --- connectors
+ConnectorStatus: GET /ns/{namespace}/connectors/{id} 200.system.status
+ConnectorRunStatus: GET /ns/{namespace}/connectors/{id} 200.latestRun?.system.status
+ConnectorErrorCode: GET /ns/{namespace}/connectors/{id} 200.latestRun?.errorCode?
+ConnectorRun: GET /ns/{namespace}/connectors/{id} 200.latestRun?
+ConnectorSystem: GET /ns/{namespace}/connectors/{id} 200.system
 Connector: GET /ns/{namespace}/connectors/{id} 200
 ConnectorList: GET /connectors 200
 ConnectorCapabilities: GET /ns/{namespace}/connectors/{id} 200.capabilities
-ConnectorPicker: GET /ns/{namespace}/connectors/{id} 200.picker?
+ConnectorLink: GET /ns/{namespace}/connectors/{id} 200.picker?  # same {url, expiresAt} shape as authorization
 ConnectorSelectionItem: GET /ns/{namespace}/connectors/{id} 200.selection?{}[]
-ConnectorLastSync: GET /ns/{namespace}/connectors/{id} 200.lastSync?
 ConnectorSync: GET /ns/{namespace}/connectors/{id} 200.syncs[]
 ConnectorSyncFailure: GET /ns/{namespace}/connectors/{id} 200.syncs[].failures[]
 ConnectorSelection: PATCH /ns/{namespace}/connectors/{id} body.selection
@@ -96,8 +101,9 @@ ConnectorSyncStarted: POST /ns/{namespace}/connectors/{id}/sync 202
 ConnectorDeleted: DELETE /ns/{namespace}/connectors/{id} 200
 
 # --- namespaces and organization
-Namespace: GET /ns 200[]
-NamespaceSystem: GET /ns 200[].system
+NamespaceList: GET /ns 200
+Namespace: GET /ns 200.namespaces[]
+NamespaceSystem: GET /ns 200.namespaces[].system
 NamespaceDetails: GET /ns/{namespace} 200
 NamespaceDeleted: DELETE /ns/{namespace} 200
 Organization: GET /organization 200

fern/schemas.yaml

@@ -1,6 +1,6 @@
 [project]
 name = "supermemory"
-version = "5.0.0rc2"
+version = "5.0.0rc3"
 description = "The official Python library for the Supermemory API"
 readme = "README.md"
 license = "Apache-2.0"