Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "3.33.1"
".": "3.34.0"
}
6 changes: 3 additions & 3 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 26
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-3d1ed08ae874eafef0c275748f38e21c1e6a245ecad05db24dee27f4166f18db.yml
openapi_spec_hash: fa7ccfe7d4574c280f3189d020401032
config_hash: f3eb5ca71172780678106f6d46f15dda
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-5d883c307659b317ca9a27ffd4e98855210c7030167bc79f4727412266c8e53b.yml
openapi_spec_hash: 4e5b35c97838082939b19a24d9472ffd
config_hash: cde97ef3188581c5f4924c633ec33ddb
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Changelog

## 3.34.0 (2026-04-17)

Full Changelog: [v3.33.1...v3.34.0](https://github.com/supermemoryai/python-sdk/compare/v3.33.1...v3.34.0)

### Features

* **api:** api update ([ab60a76](https://github.com/supermemoryai/python-sdk/commit/ab60a7657699fc974c8648adcb74a0dba9a4fe5b))
* **api:** api update ([0950bae](https://github.com/supermemoryai/python-sdk/commit/0950bae08a126b09a2844839db673e99cfc13f75))

## 3.33.1 (2026-04-11)

Full Changelog: [v3.33.0...v3.33.1](https://github.com/supermemoryai/python-sdk/compare/v3.33.0...v3.33.1)
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "supermemory"
version = "3.33.1"
version = "3.34.0"
description = "The official Python library for the supermemory API"
dynamic = ["readme"]
license = "Apache-2.0"
Expand Down
12 changes: 11 additions & 1 deletion src/supermemory/_client.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

import os
from typing import TYPE_CHECKING, Any, Dict, Union, Mapping
from typing_extensions import Self, override
from typing_extensions import Self, Literal, override

import httpx

Expand Down Expand Up @@ -246,6 +246,7 @@ def add(
custom_id: str | Omit = omit,
entity_context: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand All @@ -271,6 +272,9 @@ def add(

metadata: Optional metadata for the document.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -289,6 +293,7 @@ def add(
"custom_id": custom_id,
"entity_context": entity_context,
"metadata": metadata,
"task_type": task_type,
},
client_add_params.ClientAddParams,
),
Expand Down Expand Up @@ -562,6 +567,7 @@ async def add(
custom_id: str | Omit = omit,
entity_context: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand All @@ -587,6 +593,9 @@ async def add(

metadata: Optional metadata for the document.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -605,6 +614,7 @@ async def add(
"custom_id": custom_id,
"entity_context": entity_context,
"metadata": metadata,
"task_type": task_type,
},
client_add_params.ClientAddParams,
),
Expand Down
2 changes: 1 addition & 1 deletion src/supermemory/_version.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

__title__ = "supermemory"
__version__ = "3.33.1" # x-release-please-version
__version__ = "3.34.0" # x-release-please-version
4 changes: 4 additions & 0 deletions src/supermemory/resources/connections.py
Original file line number Diff line number Diff line change
Expand Up @@ -417,6 +417,7 @@ def resources(
connection_id: str,
*,
page: float | Omit = omit,
parent_id: str | Omit = omit,
per_page: float | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
Expand Down Expand Up @@ -449,6 +450,7 @@ def resources(
query=maybe_transform(
{
"page": page,
"parent_id": parent_id,
"per_page": per_page,
},
connection_resources_params.ConnectionResourcesParams,
Expand Down Expand Up @@ -839,6 +841,7 @@ async def resources(
connection_id: str,
*,
page: float | Omit = omit,
parent_id: str | Omit = omit,
per_page: float | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
Expand Down Expand Up @@ -871,6 +874,7 @@ async def resources(
query=await async_maybe_transform(
{
"page": page,
"parent_id": parent_id,
"per_page": per_page,
},
connection_resources_params.ConnectionResourcesParams,
Expand Down
40 changes: 40 additions & 0 deletions src/supermemory/resources/documents.py
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,7 @@ def update(
content: str | Omit = omit,
custom_id: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand Down Expand Up @@ -104,6 +105,9 @@ def update(
and are case sensitive. Values can be strings, numbers, or booleans. You cannot
nest objects.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -123,6 +127,7 @@ def update(
"content": content,
"custom_id": custom_id,
"metadata": metadata,
"task_type": task_type,
},
document_update_params.DocumentUpdateParams,
),
Expand Down Expand Up @@ -241,6 +246,7 @@ def add(
custom_id: str | Omit = omit,
entity_context: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand All @@ -266,6 +272,9 @@ def add(

metadata: Optional metadata for the document.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -284,6 +293,7 @@ def add(
"custom_id": custom_id,
"entity_context": entity_context,
"metadata": metadata,
"task_type": task_type,
},
document_add_params.DocumentAddParams,
),
Expand All @@ -301,6 +311,7 @@ def batch_add(
container_tags: SequenceNotStr[str] | Omit = omit,
content: None | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand Down Expand Up @@ -328,6 +339,9 @@ def batch_add(
and are case sensitive. Values can be strings, numbers, or booleans. You cannot
nest objects.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -345,6 +359,7 @@ def batch_add(
"container_tags": container_tags,
"content": content,
"metadata": metadata,
"task_type": task_type,
},
document_batch_add_params.DocumentBatchAddParams,
),
Expand Down Expand Up @@ -458,6 +473,7 @@ def upload_file(
file_type: str | Omit = omit,
metadata: str | Omit = omit,
mime_type: str | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
use_advanced_processing: str | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
Expand Down Expand Up @@ -490,6 +506,9 @@ def upload_file(
mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

use_advanced_processing: DEPRECATED: This field is no longer used. Advanced PDF processing is now
automatic with our hybrid Mistral OCR + Gemini pipeline. This parameter will be
accepted but ignored for backwards compatibility.
Expand All @@ -510,6 +529,7 @@ def upload_file(
"file_type": file_type,
"metadata": metadata,
"mime_type": mime_type,
"task_type": task_type,
"use_advanced_processing": use_advanced_processing,
}
)
Expand Down Expand Up @@ -558,6 +578,7 @@ async def update(
content: str | Omit = omit,
custom_id: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand Down Expand Up @@ -595,6 +616,9 @@ async def update(
and are case sensitive. Values can be strings, numbers, or booleans. You cannot
nest objects.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -614,6 +638,7 @@ async def update(
"content": content,
"custom_id": custom_id,
"metadata": metadata,
"task_type": task_type,
},
document_update_params.DocumentUpdateParams,
),
Expand Down Expand Up @@ -732,6 +757,7 @@ async def add(
custom_id: str | Omit = omit,
entity_context: str | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand All @@ -757,6 +783,9 @@ async def add(

metadata: Optional metadata for the document.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -775,6 +804,7 @@ async def add(
"custom_id": custom_id,
"entity_context": entity_context,
"metadata": metadata,
"task_type": task_type,
},
document_add_params.DocumentAddParams,
),
Expand All @@ -792,6 +822,7 @@ async def batch_add(
container_tags: SequenceNotStr[str] | Omit = omit,
content: None | Omit = omit,
metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
extra_headers: Headers | None = None,
Expand Down Expand Up @@ -819,6 +850,9 @@ async def batch_add(
and are case sensitive. Values can be strings, numbers, or booleans. You cannot
nest objects.

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

extra_headers: Send extra headers

extra_query: Add additional query parameters to the request
Expand All @@ -836,6 +870,7 @@ async def batch_add(
"container_tags": container_tags,
"content": content,
"metadata": metadata,
"task_type": task_type,
},
document_batch_add_params.DocumentBatchAddParams,
),
Expand Down Expand Up @@ -949,6 +984,7 @@ async def upload_file(
file_type: str | Omit = omit,
metadata: str | Omit = omit,
mime_type: str | Omit = omit,
task_type: Literal["memory", "superrag"] | Omit = omit,
use_advanced_processing: str | Omit = omit,
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
# The extra values given here take precedence over values defined on the client or passed to this method.
Expand Down Expand Up @@ -981,6 +1017,9 @@ async def upload_file(
mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')

task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.

use_advanced_processing: DEPRECATED: This field is no longer used. Advanced PDF processing is now
automatic with our hybrid Mistral OCR + Gemini pipeline. This parameter will be
accepted but ignored for backwards compatibility.
Expand All @@ -1001,6 +1040,7 @@ async def upload_file(
"file_type": file_type,
"metadata": metadata,
"mime_type": mime_type,
"task_type": task_type,
"use_advanced_processing": use_advanced_processing,
}
)
Expand Down
8 changes: 7 additions & 1 deletion src/supermemory/types/client_add_params.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
from __future__ import annotations

from typing import Dict, Union
from typing_extensions import Required, Annotated, TypedDict
from typing_extensions import Literal, Required, Annotated, TypedDict

from .._types import SequenceNotStr
from .._utils import PropertyInfo
Expand Down Expand Up @@ -40,3 +40,9 @@ class ClientAddParams(TypedDict, total=False):

metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
"""Optional metadata for the document."""

task_type: Annotated[Literal["memory", "superrag"], PropertyInfo(alias="taskType")]
"""
Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.
"""
2 changes: 2 additions & 0 deletions src/supermemory/types/connection_resources_params.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,6 @@
class ConnectionResourcesParams(TypedDict, total=False):
page: float

parent_id: str

per_page: float
8 changes: 7 additions & 1 deletion src/supermemory/types/document_add_params.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
from __future__ import annotations

from typing import Dict, Union
from typing_extensions import Required, Annotated, TypedDict
from typing_extensions import Literal, Required, Annotated, TypedDict

from .._types import SequenceNotStr
from .._utils import PropertyInfo
Expand Down Expand Up @@ -40,3 +40,9 @@ class DocumentAddParams(TypedDict, total=False):

metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
"""Optional metadata for the document."""

task_type: Annotated[Literal["memory", "superrag"], PropertyInfo(alias="taskType")]
"""
Task type: "memory" (default) for full context layer with SuperRAG built in,
"superrag" for managed RAG as a service.
"""
Loading