fleet-memory/hindsight-clients/python/hindsight_client_api/models
Nicolò Boschi 5d05962db0
feat: add source facts token limits to consolidation and recall (#509)
* feat: add source facts token limits to consolidation and recall

- Add two new configurable (per-bank) parameters:
  - consolidation_source_facts_max_tokens: total token budget for source
    facts across all observations in the consolidation prompt (-1 = unlimited)
  - consolidation_source_facts_max_tokens_per_observation: per-observation
    cap so each observation gets a fair share of source facts (-1 = unlimited,
    default 256)
- Both are also exposed as recall API parameters via SourceFactsIncludeOptions
  (max_tokens and max_tokens_per_observation)
- Consolidation now uses resolve_full_config to respect bank-level overrides
- Improve consolidation prompt: temporal metadata (occurred_start=, | Involving:)
  is now clearly separated from observation text, with a concrete example showing
  the expected synthesis style and explicit rules not to copy raw fact lines
- Add tests for recall source facts capping and consolidation config forwarding
- Expose all three new fields in the control plane bank config UI
- Document new env vars in configuration.md
- Regenerate OpenAPI spec and all SDK clients

* fix: reorder observations UI fields and rename Label Groups to Entity Labels

* fix: revert Entities section title (only rename inner label)

* doc: add consolidation source facts and batch size fields to memory-banks docs
2026-03-06 13:01:33 +01:00
..
__init__.py Release v0.4.16 2026-03-05 17:54:59 +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_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