SDK 1.1.0

.openapi-generator/FILES

@@ -12,6 +12,7 @@ docs/CategoryDeleteData.md
 docs/CategoryListData.md
 docs/CategoryPatchBody.md
 docs/Content.md
+docs/Content1.md
 docs/ContentItem.md
 docs/Data.md
 docs/Data1.md
@@ -33,6 +34,8 @@ docs/EditResultItem.md
 docs/Envelope.md
 docs/EnvelopeResult.md
 docs/EpisodeItem.md
+docs/ErrorBody.md
+docs/ErrorEnvelope.md
 docs/ExplicitInfoData.md
 docs/ExplicitInfoPatch.md
 docs/FilterNode.md
@@ -53,6 +56,9 @@ docs/KnowledgeApi.md
 docs/MemoryApi.md
 docs/MessageItem.md
 docs/ProfileItem.md
+docs/RelatedTagUsageBody.md
+docs/RelatedTagUsageItem.md
+docs/RelatedTagUsageListData.md
 docs/SearchAgentCaseItem.md
 docs/SearchAgentSkillItem.md
 docs/SearchAtomicFactItem.md
@@ -88,14 +94,18 @@ docs/SuccessEnvelopeKbData.md
 docs/SuccessEnvelopeKbDeleteData.md
 docs/SuccessEnvelopeKbListData.md
 docs/SuccessEnvelopeKbSearchData.md
+docs/SuccessEnvelopeRelatedTagUsageListData.md
 docs/SuccessEnvelopeSearchData.md
 docs/SuccessEnvelopeTagBindData.md
 docs/SuccessEnvelopeTagReplaceData.md
 docs/SuccessEnvelopeTagUnbindData.md
 docs/SuccessEnvelopeTopicDetailData.md
+docs/SuccessEnvelopeTopicFilterListData.md
 docs/SuccessEnvelopeTopicListData.md
+docs/SuccessEnvelopeTopicTagWriteData.md
 docs/TagBindData.md
 docs/TagBindInput.md
+docs/TagRef.md
 docs/TagReplaceData.md
 docs/TagReplaceInput.md
 docs/TagUnbindData.md
@@ -113,8 +123,12 @@ docs/TasksApi.md
 docs/ToolCall.md
 docs/ToolCallFunction.md
 docs/TopicDetailData.md
+docs/TopicFilterItem.md
+docs/TopicFilterListData.md
 docs/TopicListData.md
 docs/TopicListItem.md
+docs/TopicTagReplaceBody.md
+docs/TopicTagWriteData.md
 docs/UnprocessedMessageDTO.md
 docs/UpdateOperation.md
 docs/ValidationError.md
@@ -142,6 +156,7 @@ everos_cloud/models/category_delete_data.py
 everos_cloud/models/category_list_data.py
 everos_cloud/models/category_patch_body.py
 everos_cloud/models/content.py
+everos_cloud/models/content1.py
 everos_cloud/models/content_item.py
 everos_cloud/models/data.py
 everos_cloud/models/data1.py
@@ -163,6 +178,8 @@ everos_cloud/models/edit_result_item.py
 everos_cloud/models/envelope.py
 everos_cloud/models/envelope_result.py
 everos_cloud/models/episode_item.py
+everos_cloud/models/error_body.py
+everos_cloud/models/error_envelope.py
 everos_cloud/models/explicit_info_data.py
 everos_cloud/models/explicit_info_patch.py
 everos_cloud/models/filter_node.py
@@ -181,6 +198,9 @@ everos_cloud/models/kb_patch_body.py
 everos_cloud/models/kb_search_data.py
 everos_cloud/models/message_item.py
 everos_cloud/models/profile_item.py
+everos_cloud/models/related_tag_usage_body.py
+everos_cloud/models/related_tag_usage_item.py
+everos_cloud/models/related_tag_usage_list_data.py
 everos_cloud/models/search_agent_case_item.py
 everos_cloud/models/search_agent_skill_item.py
 everos_cloud/models/search_atomic_fact_item.py
@@ -215,14 +235,18 @@ everos_cloud/models/success_envelope_kb_data.py
 everos_cloud/models/success_envelope_kb_delete_data.py
 everos_cloud/models/success_envelope_kb_list_data.py
 everos_cloud/models/success_envelope_kb_search_data.py
+everos_cloud/models/success_envelope_related_tag_usage_list_data.py
 everos_cloud/models/success_envelope_search_data.py
 everos_cloud/models/success_envelope_tag_bind_data.py
 everos_cloud/models/success_envelope_tag_replace_data.py
 everos_cloud/models/success_envelope_tag_unbind_data.py
 everos_cloud/models/success_envelope_topic_detail_data.py
+everos_cloud/models/success_envelope_topic_filter_list_data.py
 everos_cloud/models/success_envelope_topic_list_data.py
+everos_cloud/models/success_envelope_topic_tag_write_data.py
 everos_cloud/models/tag_bind_data.py
 everos_cloud/models/tag_bind_input.py
+everos_cloud/models/tag_ref.py
 everos_cloud/models/tag_replace_data.py
 everos_cloud/models/tag_replace_input.py
 everos_cloud/models/tag_unbind_data.py
@@ -239,8 +263,12 @@ everos_cloud/models/task_status_response.py
 everos_cloud/models/tool_call.py
 everos_cloud/models/tool_call_function.py
 everos_cloud/models/topic_detail_data.py
+everos_cloud/models/topic_filter_item.py
+everos_cloud/models/topic_filter_list_data.py
 everos_cloud/models/topic_list_data.py
 everos_cloud/models/topic_list_item.py
+everos_cloud/models/topic_tag_replace_body.py
+everos_cloud/models/topic_tag_write_data.py
 everos_cloud/models/unprocessed_message_dto.py
 everos_cloud/models/update_operation.py
 everos_cloud/models/validation_error.py
@@ -265,6 +293,7 @@ test/test_category_delete_data.py
 test/test_category_list_data.py
 test/test_category_patch_body.py
 test/test_content.py
+test/test_content1.py
 test/test_content_item.py
 test/test_data.py
 test/test_data1.py
@@ -286,6 +315,8 @@ test/test_edit_result_item.py
 test/test_envelope.py
 test/test_envelope_result.py
 test/test_episode_item.py
+test/test_error_body.py
+test/test_error_envelope.py
 test/test_explicit_info_data.py
 test/test_explicit_info_patch.py
 test/test_filter_node.py
@@ -306,6 +337,9 @@ test/test_knowledge_api.py
 test/test_memory_api.py
 test/test_message_item.py
 test/test_profile_item.py
+test/test_related_tag_usage_body.py
+test/test_related_tag_usage_item.py
+test/test_related_tag_usage_list_data.py
 test/test_search_agent_case_item.py
 test/test_search_agent_skill_item.py
 test/test_search_atomic_fact_item.py
@@ -341,14 +375,18 @@ test/test_success_envelope_kb_data.py
 test/test_success_envelope_kb_delete_data.py
 test/test_success_envelope_kb_list_data.py
 test/test_success_envelope_kb_search_data.py
+test/test_success_envelope_related_tag_usage_list_data.py
 test/test_success_envelope_search_data.py
 test/test_success_envelope_tag_bind_data.py
 test/test_success_envelope_tag_replace_data.py
 test/test_success_envelope_tag_unbind_data.py
 test/test_success_envelope_topic_detail_data.py
+test/test_success_envelope_topic_filter_list_data.py
 test/test_success_envelope_topic_list_data.py
+test/test_success_envelope_topic_tag_write_data.py
 test/test_tag_bind_data.py
 test/test_tag_bind_input.py
+test/test_tag_ref.py
 test/test_tag_replace_data.py
 test/test_tag_replace_input.py
 test/test_tag_unbind_data.py
@@ -366,8 +404,12 @@ test/test_tasks_api.py
 test/test_tool_call.py
 test/test_tool_call_function.py
 test/test_topic_detail_data.py
+test/test_topic_filter_item.py
+test/test_topic_filter_list_data.py
 test/test_topic_list_data.py
 test/test_topic_list_item.py
+test/test_topic_tag_replace_body.py
+test/test_topic_tag_write_data.py
 test/test_unprocessed_message_dto.py
 test/test_update_operation.py
 test/test_validation_error.py

docs/AddData.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**message_count** | **int** |  | 
+**message_count** | **int** | How many messages this call accepted. | 
 **status** | **str** | \"queued\" — async enqueue accepted (HTTP 202). \"accumulated\"/\"extracted\" — synchronous write outcome (HTTP 200, async_mode=false). | 
 
 ## Example

docs/AddInput.md

@@ -5,10 +5,10 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**app_id** | **str** |  | [optional] [default to 'default']
-**project_id** | **str** |  | [optional] [default to 'default']
-**session_id** | **str** |  | 
-**messages** | [**List[MessageItem]**](MessageItem.md) |  | 
+**app_id** | **str** | Business-semantic scope for this write, defaulting to \"default\". Reads must use the same app_id / project_id pair to see what was written under it. Note this is a partition, not the security boundary — that is the tenant resolved from your API key. | [optional] [default to 'default']
+**project_id** | **str** | Second half of the business-semantic scope, defaulting to \"default\". See `app_id`. | [optional] [default to 'default']
+**session_id** | **str** | The conversation these messages belong to (1–128 characters). It is the unit extraction works on: /api/v2/memory/flush takes this id, and a session boundary is what triggers extraction on its own. | 
+**messages** | [**List[MessageItem]**](MessageItem.md) | The turns to append, in order — 1 to 500 per call. Each carries its own sender and timestamp, so one call can hold a whole exchange. | 
 **async_mode** | **bool** | Selects the write path. true (default): validated and enqueued asynchronously → HTTP 202 with status \"queued\". false: forwarded synchronously to the engine, returning its 200 result and surfacing write errors directly. Extraction is always asynchronous (flush-triggered). | [optional] [default to True]
 
 ## Example

docs/AddOperation.md

@@ -7,8 +7,8 @@ Add a new profile item (``item_id`` forbidden — the server mints it).
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **reason** | **str** |  | [optional] 
-**action** | **str** |  | 
-**type** | **str** |  | 
+**action** | **str** | Always \"add\" for this variant. | 
+**type** | **str** | Which profile item this edit targets — \"explicit_info\" (a stated fact, needing `category` + `description`) or \"implicit_traits\" (an inferred trait, needing `trait` + `description`). | 
 **data** | [**Data**](Data.md) |  | 
 
 ## Example

docs/AgentCaseItem.md

@@ -5,16 +5,16 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **str** |  | 
-**app_id** | **str** |  | 
-**project_id** | **str** |  | 
-**agent_id** | **str** |  | 
-**session_id** | **str** |  | 
-**task_intent** | **str** |  | 
-**approach** | **str** |  | 
-**quality_score** | **float** |  | 
+**id** | **str** | Agent-case id. | 
+**app_id** | **str** | The business-semantic scope this case was written under. | 
+**project_id** | **str** | Second half of that scope. | 
+**agent_id** | **str** | The agent that owns this case. | 
+**session_id** | **str** | The session whose trajectory the case was distilled from. | 
+**task_intent** | **str** | What the agent was trying to do in that trajectory. | 
+**approach** | **str** | How it went about it — the reusable part of the case. | 
+**quality_score** | **float** | How good this case is judged to be. Nominally 0.0–1.0 with 0.5 as the no-opinion default, but the value is the extractor's own and nothing on the write path enforces the range — treat an out-of-range number as possible. One threshold is real: a case scoring below 0.2 is never distilled into a skill. | 
 **key_insight** | **str** |  | [optional] 
-**timestamp** | **datetime** |  | 
+**timestamp** | **datetime** | When the trajectory happened (ISO 8601). | 
 
 ## Example
 

docs/AgentSkillItem.md

@@ -5,16 +5,18 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **str** |  | 
-**app_id** | **str** |  | 
-**project_id** | **str** |  | 
-**agent_id** | **str** |  | 
-**name** | **str** |  | 
-**description** | **str** |  | 
-**content** | **str** |  | 
-**confidence** | **float** |  | 
-**maturity_score** | **float** |  | 
-**source_case_ids** | **List[str]** |  | [optional] 
+**id** | **str** | Agent-skill id. | 
+**app_id** | **str** | The business-semantic scope this skill was written under. | 
+**project_id** | **str** | Second half of that scope. | 
+**agent_id** | **str** | The agent that owns this skill. | 
+**name** | **str** | The skill's name. | 
+**description** | **str** | What the skill is for, in a sentence. | 
+**content** | **str** | The skill itself — the reusable procedure, ready to put in a prompt. | 
+**confidence** | **float** | How much the distillation trusts this skill. Nominally 0.0–1.0, defaulting to 0.0 before anything scores it; the range is not enforced on the write path. Nothing in retrieval filters on it today, and how it divides labour with `maturity_score` is still open — so do not build a threshold on it yet. | 
+**maturity_score** | **float** | How well-established the skill is. Nominally 0.0–1.0 and unenforced, and — unlike the other two scores — its default is 0.6 rather than 0.0, chosen so an unscored skill starts mid-optimistic. The cost is that an unscored 0.6 is indistinguishable from a scored 0.6: there is no \"not evaluated\" sentinel, and maturity scoring is skipped by default. Filtering near 0.6 is therefore unreliable. | 
+**source_case_ids** | **List[str]** | The agent cases this skill was distilled from. Fetch them for the underlying evidence. | [optional] 
+**created_at** | **datetime** |  | [optional] 
+**updated_at** | **datetime** |  | [optional] 
 
 ## Example
 

docs/AtomicFactItem.md

@@ -6,8 +6,8 @@ Atomic fact nested in an episode. Spec appendix E references it but does not enu
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **str** |  | 
-**content** | **str** |  | 
+**id** | **str** | Atomic-fact id. | 
+**content** | **str** | The fact itself, as a single statement. | 
 
 ## Example
 

docs/CategoryData.md

@@ -7,9 +7,9 @@ A category as returned to clients. ``id`` is the system-generated stable key.
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **str** | Category id (system-generated, stable) | 
-**name** | **str** |  | 
-**description** | **str** |  | [optional] [default to '']
-**document_count** | **int** |  | [optional] [default to 0]
+**name** | **str** | The category's display name. | 
+**description** | **str** | What belongs in this category. The classifier matches documents against this text, so it is functional, not decorative. | [optional] [default to '']
+**document_count** | **int** | How many documents are filed under it. | [optional] [default to 0]
 **scope** | **str** | 'kb' = user-created in this kb; 'tenant' = global preset (read-only) | [optional] [default to 'kb']
 **editable** | **bool** | False for tenant-global preset categories (read-only) | [optional] [default to True]
 

docs/CategoryListData.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**categories** | [**List[CategoryData]**](CategoryData.md) |  | [optional] 
+**categories** | [**List[CategoryData]**](CategoryData.md) | Every category available in this knowledge base — the ones created here plus the tenant-global presets. | [optional] 
 
 ## Example
 

docs/Content.md

@@ -1,5 +1,6 @@
 # Content
 
+The message body: a plain string (shorthand for a single text item), or a list of content items for multimodal input.
 
 ## Properties
 

docs/Content1.md

@@ -0,0 +1,29 @@
+# Content1
+
+The message body as submitted.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Example
+
+```python
+from everos_cloud.models.content1 import Content1
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of Content1 from a JSON string
+content1_instance = Content1.from_json(json)
+# print the JSON string representation of the object
+print(Content1.to_json())
+
+# convert the object into a dict
+content1_dict = content1_instance.to_dict()
+# create an instance of Content1 from a dict
+content1_from_dict = Content1.from_dict(content1_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/ContentItem.md

@@ -6,7 +6,7 @@ A single content element (appendix A). Current phase: only ``type=\"text\"``.
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**type** | **str** |  | 
+**type** | **str** | What this item is: \"text\", \"image\", \"audio\", \"doc\", \"pdf\", \"html\" or \"email\". It selects how the content is parsed, so it must match the payload. | 
 **text** | **str** |  | [optional] 
 **source** | **str** |  | [optional] 
 **var_base64** | **str** |  | [optional] 

docs/Data.md

@@ -1,13 +1,14 @@
 # Data
 
+The item to add. Its required keys depend on `type`; other keys (evidence, sources, basis, …) ride through untouched.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**category** | **str** |  | 
-**description** | **str** |  | 
-**trait** | **str** |  | 
+**category** | **str** | What kind of fact this is, e.g. \"hobby\". Required, non-empty. | 
+**description** | **str** | What the trait means and how it shows up, up to 4000 characters. | 
+**trait** | **str** | The inferred trait's name. Required, non-empty. | 
 
 ## Example
 

docs/Data1.md

@@ -1,5 +1,6 @@
 # Data1
 
+Partial patch, shallow-merged into the stored item. At least one of the type's own keys must be present.
 
 ## Properties
 

docs/DeleteInput.md

@@ -5,8 +5,8 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**app_id** | **str** |  | [optional] [default to 'default']
-**project_id** | **str** |  | [optional] [default to 'default']
+**app_id** | **str** | Scope to delete within, defaulting to \"default\". | [optional] [default to 'default']
+**project_id** | **str** | Second half of the scope, defaulting to \"default\". | [optional] [default to 'default']
 **user_id** | **str** |  | [optional] 
 **agent_id** | **str** |  | [optional] 
 **session_id** | **str** |  | [optional] 

docs/DeleteOperation.md

@@ -7,9 +7,9 @@ Delete an existing profile item by ``item_id`` (carries no ``data``).
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **reason** | **str** |  | [optional] 
-**action** | **str** |  | 
-**type** | **str** |  | 
-**item_id** | **str** |  | 
+**action** | **str** | Always \"delete\" for this variant. | 
+**type** | **str** | Which profile item this edit targets — \"explicit_info\" or \"implicit_traits\". It must match the `item_id` prefix. | 
+**item_id** | **str** | The item to delete. Its prefix must match the item type (\"ei_\" / \"it_\") followed by 24 hex characters. | 
 
 ## Example