fleet-memory/hindsight-clients/python/hindsight_client_api/models
Nicolò Boschi 1b4ad7f435
feat: change tags for a document (#517)
* feat: add update document tags endpoint with observation invalidation

Adds PATCH /v1/default/banks/{bank_id}/documents/{document_id} to change
tags on a document without re-processing content.

- Updates tags on the document and all associated memory units atomically
- Invalidates observations derived from the document's memory units
- Resets consolidated_at on the document's own units for re-consolidation
- Also resets consolidated_at on co-source memories from other documents
  that shared those observations (matching delete_document behavior)
- Triggers async consolidation when observations are invalidated
- 9 new tests covering all invalidation scenarios

UI: adds inline tag editor to the document detail panel in the control plane
Docs: new "Update Document Tags" section in documents.mdx with Python/JS examples

* refactor: simplify UpdateDocumentTagsResponse to {success: true}

* refactor: make PATCH /documents generic update_document endpoint

Renames update_document_tags → update_document (engine + HTTP + clients + UI).
Currently only tags are supported; the structure is open for future fields.
Tags are the only field with side effects (observation invalidation + re-consolidation).
2026-03-07 09:00:13 +01:00
..
__init__.py feat: change tags for a document (#517) 2026-03-07 09:00:13 +01:00
add_background_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
async_operation_submit_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
background_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_config_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_config_update.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_list_item.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_profile_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
bank_stats_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
budget.py Release v0.4.16 2026-03-05 17:54:59 +01:00
cancel_operation_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
child_operation_status.py Release v0.4.16 2026-03-05 17:54:59 +01:00
chunk_data.py Release v0.4.16 2026-03-05 17:54:59 +01:00
chunk_include_options.py Release v0.4.16 2026-03-05 17:54:59 +01:00
chunk_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
clear_memory_observations_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
consolidation_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
create_bank_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
create_directive_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
create_mental_model_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
create_mental_model_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
create_webhook_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
delete_document_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
delete_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
directive_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
directive_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
disposition_traits.py Release v0.4.16 2026-03-05 17:54:59 +01:00
document_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_detail_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_include_options.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_input.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_list_item.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_observation_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
entity_state_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
features_info.py Release v0.4.16 2026-03-05 17:54:59 +01:00
file_retain_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
graph_data_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
http_validation_error.py Release v0.4.16 2026-03-05 17:54:59 +01:00
include_options.py Release v0.4.16 2026-03-05 17:54:59 +01:00
list_documents_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
list_memory_units_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
list_tags_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
memory_item.py Release v0.4.16 2026-03-05 17:54:59 +01:00
mental_model_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
mental_model_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
mental_model_trigger.py Release v0.4.16 2026-03-05 17:54:59 +01:00
observation_scopes.py Release v0.4.16 2026-03-05 17:54:59 +01:00
operation_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
operation_status_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
operations_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
recall_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
recall_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
recall_result.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_based_on.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_directive.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_fact.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_include_options.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_llm_call.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_mental_model.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_tool_call.py Release v0.4.16 2026-03-05 17:54:59 +01:00
reflect_trace.py Release v0.4.16 2026-03-05 17:54:59 +01:00
retain_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
retain_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
source_facts_include_options.py feat: add source facts token limits to consolidation and recall (#509) 2026-03-06 13:01:33 +01:00
tag_item.py Release v0.4.16 2026-03-05 17:54:59 +01:00
timestamp.py Release v0.4.16 2026-03-05 17:54:59 +01:00
token_usage.py Release v0.4.16 2026-03-05 17:54:59 +01:00
tool_calls_include_options.py Release v0.4.16 2026-03-05 17:54:59 +01:00
update_directive_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
update_disposition_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
update_document_request.py feat: change tags for a document (#517) 2026-03-07 09:00:13 +01:00
update_document_response.py feat: change tags for a document (#517) 2026-03-07 09:00:13 +01:00
update_mental_model_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
update_webhook_request.py Release v0.4.16 2026-03-05 17:54:59 +01:00
validation_error.py Release v0.4.16 2026-03-05 17:54:59 +01:00
validation_error_loc_inner.py Release v0.4.16 2026-03-05 17:54:59 +01:00
version_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
webhook_delivery_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
webhook_delivery_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
webhook_http_config.py Release v0.4.16 2026-03-05 17:54:59 +01:00
webhook_list_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00
webhook_response.py Release v0.4.16 2026-03-05 17:54:59 +01:00