diff --git a/docs/MemoryApi.md b/docs/MemoryApi.md index 1225563..0e4067e 100644 --- a/docs/MemoryApi.md +++ b/docs/MemoryApi.md @@ -7,7 +7,7 @@ Method | HTTP request | Description [**add_memory**](MemoryApi.md#add_memory) | **POST** /api/v2/memory/add | Add messages [OSS + Cloud] [**delete_memory**](MemoryApi.md#delete_memory) | **POST** /api/v2/memory/delete | Delete memories [Cloud-only] [**edit_profile**](MemoryApi.md#edit_profile) | **POST** /api/v2/memory/edit | Edit profile items [Cloud-only] -[**flush_api_v2_memory_flush_post**](MemoryApi.md#flush_api_v2_memory_flush_post) | **POST** /api/v2/memory/flush | Force boundary detection + extraction [OSS + Cloud] +[**flush_memory**](MemoryApi.md#flush_memory) | **POST** /api/v2/memory/flush | Force boundary detection + extraction [OSS + Cloud] [**get_memory**](MemoryApi.md#get_memory) | **POST** /api/v2/memory/get | Get memories (paginated) [OSS + Cloud] [**search_memory**](MemoryApi.md#search_memory) | **POST** /api/v2/memory/search | Search memories [OSS + Cloud] @@ -259,8 +259,8 @@ Name | Type | Description | Notes [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) -# **flush_api_v2_memory_flush_post** -> SuccessEnvelopeFlushData flush_api_v2_memory_flush_post(flush_input) +# **flush_memory** +> SuccessEnvelopeFlushData flush_memory(flush_input) Force boundary detection + extraction [OSS + Cloud] @@ -299,11 +299,11 @@ with everos_cloud.ApiClient(configuration) as api_client: try: # Force boundary detection + extraction [OSS + Cloud] - api_response = api_instance.flush_api_v2_memory_flush_post(flush_input) - print("The response of MemoryApi->flush_api_v2_memory_flush_post:\n") + api_response = api_instance.flush_memory(flush_input) + print("The response of MemoryApi->flush_memory:\n") pprint(api_response) except Exception as e: - print("Exception when calling MemoryApi->flush_api_v2_memory_flush_post: %s\n" % e) + print("Exception when calling MemoryApi->flush_memory: %s\n" % e) ``` diff --git a/everos_cloud/__init__.py b/everos_cloud/__init__.py index 603fd51..fdb69aa 100644 --- a/everos_cloud/__init__.py +++ b/everos_cloud/__init__.py @@ -15,7 +15,7 @@ """ # noqa: E501 -__version__ = "1.0.0-rc2" +__version__ = "1.0.0-rc3" # import apis into sdk package from everos_cloud.api.memory_api import MemoryApi @@ -92,15 +92,7 @@ from everos_cloud.models.validation_error import ValidationError from everos_cloud.models.validation_error_loc_inner import ValidationErrorLocInner -# Ergonomic high-level client — hand-maintained, preserved across regeneration -# (usage in quickstart.md). Guarded so a bare generated tree without client.py -# (e.g. the factory's build output) still imports cleanly. try: - from everos_cloud.client import ( - EverOS, - EverOSAPIError, - EverOSError, - EverOSStorageError, - ) -except ImportError: # pragma: no cover + from everos_cloud.client import EverOS, EverOSError, EverOSAPIError, EverOSStorageError +except ImportError: pass diff --git a/everos_cloud/api/memory_api.py b/everos_cloud/api/memory_api.py index c20e702..66c8022 100644 --- a/everos_cloud/api/memory_api.py +++ b/everos_cloud/api/memory_api.py @@ -910,7 +910,7 @@ def _edit_profile_serialize( @validate_call - def flush_api_v2_memory_flush_post( + def flush_memory( self, flush_input: FlushInput, _request_timeout: Union[ @@ -953,7 +953,7 @@ def flush_api_v2_memory_flush_post( :return: Returns the result object. """ # noqa: E501 - _param = self._flush_api_v2_memory_flush_post_serialize( + _param = self._flush_memory_serialize( flush_input=flush_input, _request_auth=_request_auth, _content_type=_content_type, @@ -981,7 +981,7 @@ def flush_api_v2_memory_flush_post( @validate_call - def flush_api_v2_memory_flush_post_with_http_info( + def flush_memory_with_http_info( self, flush_input: FlushInput, _request_timeout: Union[ @@ -1024,7 +1024,7 @@ def flush_api_v2_memory_flush_post_with_http_info( :return: Returns the result object. """ # noqa: E501 - _param = self._flush_api_v2_memory_flush_post_serialize( + _param = self._flush_memory_serialize( flush_input=flush_input, _request_auth=_request_auth, _content_type=_content_type, @@ -1052,7 +1052,7 @@ def flush_api_v2_memory_flush_post_with_http_info( @validate_call - def flush_api_v2_memory_flush_post_without_preload_content( + def flush_memory_without_preload_content( self, flush_input: FlushInput, _request_timeout: Union[ @@ -1095,7 +1095,7 @@ def flush_api_v2_memory_flush_post_without_preload_content( :return: Returns the result object. """ # noqa: E501 - _param = self._flush_api_v2_memory_flush_post_serialize( + _param = self._flush_memory_serialize( flush_input=flush_input, _request_auth=_request_auth, _content_type=_content_type, @@ -1118,7 +1118,7 @@ def flush_api_v2_memory_flush_post_without_preload_content( return response_data.response - def _flush_api_v2_memory_flush_post_serialize( + def _flush_memory_serialize( self, flush_input, _request_auth, diff --git a/everos_cloud/api_client.py b/everos_cloud/api_client.py index e21ccbc..d7a3e15 100644 --- a/everos_cloud/api_client.py +++ b/everos_cloud/api_client.py @@ -91,7 +91,7 @@ def __init__( self.default_headers[header_name] = header_value self.cookie = cookie # Set default User-Agent. - self.user_agent = 'OpenAPI-Generator/1.0.0-rc2/python' + self.user_agent = 'OpenAPI-Generator/1.0.0-rc3/python' self.client_side_validation = configuration.client_side_validation def __enter__(self): diff --git a/everos_cloud/configuration.py b/everos_cloud/configuration.py index ce34b85..90aa82b 100644 --- a/everos_cloud/configuration.py +++ b/everos_cloud/configuration.py @@ -504,7 +504,7 @@ def to_debug_report(self) -> str: "OS: {env}\n"\ "Python Version: {pyversion}\n"\ "Version of the API: 2.0.0\n"\ - "SDK Package Version: 1.0.0-rc2".\ + "SDK Package Version: 1.0.0-rc3".\ format(env=sys.platform, pyversion=sys.version) def get_host_settings(self) -> List[HostSetting]: diff --git a/openapi.json b/openapi.json index c5e9935..1dd2776 100644 --- a/openapi.json +++ b/openapi.json @@ -274,7 +274,7 @@ "Memory" ], "summary": "Force boundary detection + extraction [OSS + Cloud]", - "operationId": "flush_api_v2_memory_flush_post", + "operationId": "flushMemory", "requestBody": { "content": { "application/json": { diff --git a/pyproject.toml b/pyproject.toml index 1da3041..4d475c7 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "everos_cloud" -version = "1.0.0-rc2" +version = "1.0.0-rc3" description = "EverOS Cloud Memory API" authors = ["EverMind AI "] license = "Apache-2.0" diff --git a/quickstart.md b/quickstart.md index a7d6841..10c2dce 100644 --- a/quickstart.md +++ b/quickstart.md @@ -105,11 +105,10 @@ with ApiClient(config) as client: # Scope the delete by any combination of user_id / agent_id / session_id. memory.delete_memory(DeleteInput(user_id="user-1", session_id="session-1")) - # ── Flush a session (force boundary detection + extraction) ──────────────── + # ── Flush a session (force extraction) ───────────────────────────────────── # Extraction is normally async; flush forces it for a session and returns - # status "extracted" or "no_extraction". The generated method name mirrors - # the operationId. - flushed = memory.flush_api_v2_memory_flush_post(FlushInput(session_id="session-1")) + # status "extracted" or "no_extraction". + flushed = memory.flush_memory(FlushInput(session_id="session-1")) print(flushed.data.status) # "extracted" | "no_extraction" ``` @@ -173,7 +172,7 @@ description in `openapi.json` for the full list. | `get_memory(GetInput)` | `POST /api/v2/memory/get` | Paginated list by `memory_type`. | | `delete_memory(DeleteInput)` | `POST /api/v2/memory/delete` | Scoped soft-delete. | | `edit_profile(EditInput)` | `POST /api/v2/memory/edit` | Bulk profile add/update/delete operations. | -| `flush_api_v2_memory_flush_post(FlushInput)` | `POST /api/v2/memory/flush` | Force boundary detection + extraction for a session. | +| `flush_memory(FlushInput)` | `POST /api/v2/memory/flush` | Force extraction for a session. | `StorageApi` covers object upload: diff --git a/setup.py b/setup.py index 794542a..1dc9afe 100644 --- a/setup.py +++ b/setup.py @@ -13,6 +13,8 @@ """ # noqa: E501 +from pathlib import Path + from setuptools import setup, find_packages # noqa: H301 # To install the library, run the following @@ -22,8 +24,16 @@ # prerequisite: setuptools # http://pypi.python.org/pypi/setuptools NAME = "everos-cloud" -VERSION = "1.0.0-rc2" +VERSION = "1.0.0-rc3" PYTHON_REQUIRES = ">= 3.8" + +# PyPI renders this as the project page body. Use the repo README (which ships in +# the SDK tree — propose_sdk.sh preserves it), falling back to the spec description +# if it is ever absent (keeps a bare-tree build from crashing). +try: + LONG_DESCRIPTION = (Path(__file__).parent / "README.md").read_text(encoding="utf-8") +except FileNotFoundError: + LONG_DESCRIPTION = """Official Python client for the EverOS Cloud Memory API. Add, search, retrieve, and manage long-term memory for your AI applications over a typed interface (pydantic v2, with full type hints). Install and usage guides: https://github.com/EverMind-AI/everos-cloud-sdk-python""" REQUIRES = [ "urllib3 >= 1.25.3, < 3.0.0", "python-dateutil >= 2.8.2", @@ -44,8 +54,6 @@ include_package_data=True, license="Apache-2.0", long_description_content_type='text/markdown', - long_description="""\ - Official Python client for the EverOS Cloud Memory API. Add, search, retrieve, and manage long-term memory for your AI applications over a typed interface (pydantic v2, with full type hints). Install and usage guides: https://github.com/EverMind-AI/everos-cloud-sdk-python - """, # noqa: E501 + long_description=LONG_DESCRIPTION, # noqa: E501 package_data={"everos_cloud": ["py.typed"]}, ) diff --git a/test/test_memory_api.py b/test/test_memory_api.py index 47e2672..bc4d6cc 100644 --- a/test/test_memory_api.py +++ b/test/test_memory_api.py @@ -48,8 +48,8 @@ def test_edit_profile(self) -> None: """ pass - def test_flush_api_v2_memory_flush_post(self) -> None: - """Test case for flush_api_v2_memory_flush_post + def test_flush_memory(self) -> None: + """Test case for flush_memory Force boundary detection + extraction [OSS + Cloud] """