cortexdb-sdk 0.2.0b2__py3-none-any.whl

_cortexdb_client/generated/openapi_types.py

@@ -0,0 +1,1305 @@
+# @generated Generated by scripts/generate_openapi_sdk_types.py. Do not edit.
+from __future__ import annotations
+
+from typing import Any, Literal, TypedDict
+
+JsonValue = Any
+
+OpenApiHealthResponse = TypedDict(
+    'OpenApiHealthResponse',
+    {
+        'server_version': 'str',
+        'status': 'str',
+        'version': 'str',
+    },
+    total=False,
+)
+
+OpenApiCompatibilityResponse = TypedDict(
+    'OpenApiCompatibilityResponse',
+    {
+        'api': 'OpenApiApiCompatibility',
+        'migration': 'OpenApiMigrationCompatibility',
+        'migration_registry': 'OpenApiMigrationVersionRegistry',
+        'schema_version': 'str',
+        'sdk': 'OpenApiSdkCompatibility',
+        'storage_formats': 'list[OpenApiStorageFormatCompatibility]',
+    },
+    total=False,
+)
+
+OpenApiApiCompatibility = TypedDict(
+    'OpenApiApiCompatibility',
+    {
+        'contract': 'str',
+        'gate': 'str',
+        'version': 'str',
+    },
+    total=False,
+)
+
+OpenApiSdkCompatibility = TypedDict(
+    'OpenApiSdkCompatibility',
+    {
+        'contract': 'str',
+        'gate': 'str',
+        'workspace_version': 'str',
+    },
+    total=False,
+)
+
+OpenApiStorageFormatCompatibility = TypedDict(
+    'OpenApiStorageFormatCompatibility',
+    {
+        'compatibility_rule': 'str',
+        'current_magic': 'str',
+        'current_version': 'int',
+        'extension': 'str',
+        'legacy_magics': 'list[str]',
+        'name': 'str',
+    },
+    total=False,
+)
+
+OpenApiMigrationCompatibility = TypedDict(
+    'OpenApiMigrationCompatibility',
+    {
+        'current_release': 'str',
+        'gate': 'str',
+        'matrix_schema_version': 'int',
+        'release': 'str',
+    },
+    total=False,
+)
+
+OpenApiMigrationVersionRegistry = TypedDict(
+    'OpenApiMigrationVersionRegistry',
+    {
+        'current_release': 'str',
+        'downgrade_policy': 'str',
+        'formats': 'list[OpenApiMigrationFormatRegistryEntry]',
+        'migration_gate': 'str',
+        'releases': 'list[OpenApiMigrationReleaseRegistryEntry]',
+        'schema_version': 'str',
+    },
+    total=False,
+)
+
+OpenApiMigrationFormatRegistryEntry = TypedDict(
+    'OpenApiMigrationFormatRegistryEntry',
+    {
+        'compatibility_rule': 'str',
+        'current_magic': 'str',
+        'current_version': 'int',
+        'extension': 'str',
+        'kind': 'str',
+        'legacy_magics': 'list[str]',
+        'required_gate': 'str',
+    },
+    total=False,
+)
+
+OpenApiMigrationReleaseRegistryEntry = TypedDict(
+    'OpenApiMigrationReleaseRegistryEntry',
+    {
+        'backup_path': 'str | None',
+        'database_path': 'str | None',
+        'downgrade': 'str',
+        'fixture': 'str | None',
+        'from': 'str',
+        'mode': 'str',
+        'to': 'str',
+    },
+    total=False,
+)
+
+OpenApiCell = TypedDict(
+    'OpenApiCell',
+    {
+        'cell_id': 'int',
+        'payload': 'str',
+    },
+    total=False,
+)
+
+OpenApiCellLookupResponse = TypedDict(
+    'OpenApiCellLookupResponse',
+    {
+        'cell': 'OpenApiCell | Any',
+    },
+    total=False,
+)
+
+OpenApiPutCellResponse = TypedDict(
+    'OpenApiPutCellResponse',
+    {
+        'cell_id': 'int',
+        'seq': 'int',
+    },
+    total=False,
+)
+
+OpenApiFeedbackRecordResponse = TypedDict(
+    'OpenApiFeedbackRecordResponse',
+    {
+        'cell_id': 'int',
+        'seq': 'int',
+        'source_cell_id': 'int',
+        'useful': 'bool',
+    },
+    total=False,
+)
+
+OpenApiFeedbackCellStatsResponse = TypedDict(
+    'OpenApiFeedbackCellStatsResponse',
+    {
+        'not_useful': 'int',
+        'score': 'int',
+        'source_cell_id': 'int',
+        'useful': 'int',
+    },
+    total=False,
+)
+
+OpenApiFeedbackStatsResponse = TypedDict(
+    'OpenApiFeedbackStatsResponse',
+    {
+        'by_source_cell': 'list[OpenApiFeedbackCellStatsResponse]',
+        'not_useful': 'int',
+        'total': 'int',
+        'useful': 'int',
+    },
+    total=False,
+)
+
+OpenApiWriteBatchRequest = TypedDict(
+    'OpenApiWriteBatchRequest',
+    {
+        'operations': 'list[OpenApiWriteBatchOperationRequest]',
+    },
+    total=False,
+)
+
+OpenApiWriteBatchOperationRequest = Any
+
+OpenApiWriteBatchPutOperation = TypedDict(
+    'OpenApiWriteBatchPutOperation',
+    {
+        'cell_id': 'int',
+        'op': "Literal['put_cell']",
+        'payload': 'str',
+    },
+    total=False,
+)
+
+OpenApiWriteBatchPatchOperation = TypedDict(
+    'OpenApiWriteBatchPatchOperation',
+    {
+        'cell_id': 'int',
+        'op': "Literal['patch_cell']",
+        'payload': 'str',
+    },
+    total=False,
+)
+
+OpenApiWriteBatchTombstoneOperation = TypedDict(
+    'OpenApiWriteBatchTombstoneOperation',
+    {
+        'cell_id': 'int',
+        'op': "Literal['tombstone_cell']",
+    },
+    total=False,
+)
+
+OpenApiWriteBatchResponse = TypedDict(
+    'OpenApiWriteBatchResponse',
+    {
+        'cell_ids': 'list[int]',
+        'operation_count': 'int',
+        'seq': 'int',
+    },
+    total=False,
+)
+
+OpenApiAuthPolicyPrincipalRequest = TypedDict(
+    'OpenApiAuthPolicyPrincipalRequest',
+    {
+        'agent_id': 'int',
+        'body_quota_bytes_per_minute': 'int',
+        'capabilities': "list[Literal['admin', 'aql', 'context', 'delete', 'ingest', 'inference', 'memory', 'metrics', 'read', 'search', 'verify', 'write']]",
+        'context_budget_tokens': 'int',
+        'disabled': 'bool',
+        'principal_id': 'str',
+        'queue_quota': 'int',
+        'request_quota_per_minute': 'int',
+        'role': "Literal['admin', 'data']",
+        'tenants': 'list[str]',
+        'token': 'str',
+    },
+    total=False,
+)
+
+OpenApiAuthPolicyMutationResponse = TypedDict(
+    'OpenApiAuthPolicyMutationResponse',
+    {
+        'action': "Literal['upsert_principal', 'disable_principal', 'rollback_policy']",
+        'active_principals': 'int',
+        'disabled_principals': 'int',
+        'principal_id': 'str | Any',
+        'rollback_available': 'bool',
+        'schema_version': "Literal['cortexdb.auth_policy_mutation.v1']",
+    },
+    total=False,
+)
+
+OpenApiAuthPolicyListPrincipal = TypedDict(
+    'OpenApiAuthPolicyListPrincipal',
+    {
+        'agent_id': 'int | Any',
+        'body_quota_bytes_per_minute': 'int | Any',
+        'capabilities': 'list[str]',
+        'context_budget_tokens': 'int | Any',
+        'disabled': 'bool',
+        'principal_id': 'str',
+        'queue_quota': 'int | Any',
+        'request_quota_per_minute': 'int | Any',
+        'role': "Literal['admin', 'data']",
+        'tenants': 'list[str]',
+        'token_fingerprint': 'str',
+        'token_present': 'bool',
+    },
+    total=False,
+)
+
+OpenApiAuthPolicyListResponse = TypedDict(
+    'OpenApiAuthPolicyListResponse',
+    {
+        'active_principals': 'int',
+        'disabled_principals': 'int',
+        'principal_count': 'int',
+        'principals': 'list[OpenApiAuthPolicyListPrincipal]',
+        'schema_version': "Literal['cortexdb.auth_policy_list.v1']",
+        'supported_roles': "list[Literal['admin', 'data']]",
+        'token_redaction': 'str',
+    },
+    total=False,
+)
+
+OpenApiAuthScopeMutationRequest = TypedDict(
+    'OpenApiAuthScopeMutationRequest',
+    {
+        'access': "Literal['read', 'write', 'read_write']",
+        'agent_id': 'int',
+        'scope': 'str',
+    },
+    total=False,
+)
+
+OpenApiAuthScopeMutationResponse = TypedDict(
+    'OpenApiAuthScopeMutationResponse',
+    {
+        'access': "Literal['read', 'write', 'read_write']",
+        'action': "Literal['grant_scope', 'revoke_scope']",
+        'agent_id': 'int',
+        'readable_scope_count': 'int',
+        'schema_version': "Literal['cortexdb.auth_scope_mutation.v1']",
+        'scope': 'str',
+        'writable_scope_count': 'int',
+    },
+    total=False,
+)
+
+OpenApiAgentViewCreateRequest = TypedDict(
+    'OpenApiAgentViewCreateRequest',
+    {
+        'agent_id': 'int',
+        'allow_audit_mode': 'bool',
+        'allow_remember': 'bool',
+        'allow_verify_fact': 'bool',
+        'allowed_memory_types': "list[Literal['decision', 'preference', 'workflow_result', 'error_log', 'observation']]",
+        'allowed_modes': "list[Literal['fast', 'balanced', 'semantic', 'audit']]",
+        'default_candidate_limit': 'int',
+        'default_context_budget_tokens': 'int',
+        'label': 'str | None',
+        'max_candidate_limit': 'int',
+        'max_context_budget_tokens': 'int',
+        'max_ttl_seconds': 'int | None',
+        'min_required_confidence_q16': 'int',
+        'private_scope': 'str | None',
+        'readable_brains': 'list[int]',
+        'readable_scopes': 'list[str]',
+        'require_citations_by_default': 'bool',
+        'writable_scopes': 'list[str]',
+    },
+    total=False,
+)
+
+OpenApiAgentViewResponse = TypedDict(
+    'OpenApiAgentViewResponse',
+    {
+        'agent_id': 'int',
+        'allow_audit_mode': 'bool',
+        'allow_remember': 'bool',
+        'allow_verify_fact': 'bool',
+        'allowed_memory_types': "list[Literal['decision', 'preference', 'workflow_result', 'error_log', 'observation']]",
+        'allowed_modes': "list[Literal['fast', 'balanced', 'semantic', 'audit']]",
+        'default_candidate_limit': 'int',
+        'default_context_budget_tokens': 'int',
+        'label': 'str | None',
+        'max_candidate_limit': 'int',
+        'max_context_budget_tokens': 'int',
+        'max_ttl_seconds': 'int | None',
+        'min_required_confidence_q16': 'int',
+        'private_scope': 'int | None',
+        'readable_brains': 'list[int]',
+        'readable_scopes': 'list[int]',
+        'require_citations_by_default': 'bool',
+        'schema_version': "Literal['cortexdb.agent_view.v1']",
+        'writable_scopes': 'list[int]',
+    },
+    total=False,
+)
+
+OpenApiAgentViewListResponse = TypedDict(
+    'OpenApiAgentViewListResponse',
+    {
+        'agents': 'list[OpenApiAgentViewResponse]',
+        'schema_version': "Literal['cortexdb.agent_views.v1']",
+    },
+    total=False,
+)
+
+OpenApiHnswNoFallbackProfileRequest = TypedDict(
+    'OpenApiHnswNoFallbackProfileRequest',
+    {
+        'min_recall_q16': 'int',
+        'require_upper_layers': 'bool',
+        'rollout_enabled': 'bool',
+    },
+    total=False,
+)
+
+OpenApiHnswNoFallbackProfileResponse = TypedDict(
+    'OpenApiHnswNoFallbackProfileResponse',
+    {
+        'configured': 'bool',
+        'min_recall_q16': 'int | Any',
+        'require_upper_layers': 'bool | Any',
+        'rollout_enabled': 'bool | Any',
+    },
+    total=False,
+)
+
+OpenApiCheckpointResponse = TypedDict(
+    'OpenApiCheckpointResponse',
+    {
+        'cells_flushed': 'int',
+        'checkpoint_seq': 'int',
+    },
+    total=False,
+)
+
+OpenApiStatsResponse = TypedDict(
+    'OpenApiStatsResponse',
+    {
+        'aql_query_cache': 'OpenApiAqlQueryCacheStatsResponse',
+        'checkpoint_seq': 'int',
+        'compaction_pressure_q16': 'int',
+        'current_seq': 'int',
+        'durable_storage_bytes': 'int',
+        'estimated_context_pack_bytes': 'int',
+        'estimated_index_bytes': 'int',
+        'estimated_memtable_bytes': 'int',
+        'estimated_total_memory_bytes': 'int',
+        'live_segment_bytes': 'int',
+        'live_segment_payload_bytes': 'int',
+        'live_segments': 'int',
+        'logical_payload_bytes': 'int',
+        'memtable_cells': 'int',
+        'memtable_payload_bytes': 'int',
+        'memtable_versions': 'int',
+        'retired_segment_bytes': 'int',
+        'retired_segments': 'int',
+        'space_amplification_q16': 'int',
+        'total_segment_bytes': 'int',
+        'wal_size_bytes': 'int',
+        'wal_writer_batches': 'int',
+        'wal_writer_bytes': 'int',
+        'wal_writer_fsyncs': 'int',
+        'wal_writer_records': 'int',
+        'write_amplification_q16': 'int',
+    },
+    total=False,
+)
+
+OpenApiAqlQueryCacheStatsResponse = TypedDict(
+    'OpenApiAqlQueryCacheStatsResponse',
+    {
+        'catalog_invalidations': 'int',
+        'entries': 'int',
+        'evictions': 'int',
+        'hit_rate_q16': 'int',
+        'hits': 'int',
+        'max_entries': 'int',
+        'misses': 'int',
+    },
+    total=False,
+)
+
+OpenApiValidationResponse = TypedDict(
+    'OpenApiValidationResponse',
+    {
+        'bitmap_indexes_checked': 'int',
+        'cells_checked': 'int',
+        'errors': 'list[str]',
+        'hnsw_graphs_checked': 'int',
+        'lexical_indexes_checked': 'int',
+        'live_segments_checked': 'int',
+        'manifest_ok': 'bool',
+        'ok': 'bool',
+        'vector_indexes_checked': 'int',
+        'wal_ok': 'bool',
+        'wal_records_checked': 'int',
+        'wal_safe_truncate_offset': 'int',
+    },
+    total=False,
+)
+
+OpenApiClusterNodeResponse = TypedDict(
+    'OpenApiClusterNodeResponse',
+    {
+        'address': 'str',
+        'id': 'int',
+    },
+    total=False,
+)
+
+OpenApiClusterStatusResponse = TypedDict(
+    'OpenApiClusterStatusResponse',
+    {
+        'distributed_enabled': 'bool',
+        'local_node': 'int',
+        'nodes': 'list[OpenApiClusterNodeResponse]',
+        'replication_factor': 'int',
+    },
+    total=False,
+)
+
+OpenApiAqlResponse = TypedDict(
+    'OpenApiAqlResponse',
+    {
+        'cells': 'list[OpenApiCell]',
+        'explain': 'OpenApiAqlExplainResponse',
+    },
+    total=False,
+)
+
+OpenApiAqlExplainFilter = TypedDict(
+    'OpenApiAqlExplainFilter',
+    {
+        'expression': 'str',
+        'kind': "Literal['policy', 'liveness', 'where']",
+    },
+    total=False,
+)
+
+OpenApiAqlCandidateCounts = TypedDict(
+    'OpenApiAqlCandidateCounts',
+    {
+        'after_bitmap': 'int',
+        'after_quality': 'int',
+        'agent_allowed': 'int',
+        'estimated_after_bitmap': 'int | None',
+        'live': 'int',
+        'returned_limit': 'int',
+        'universe': 'int',
+    },
+    total=False,
+)
+
+OpenApiAqlCostModelTerm = TypedDict(
+    'OpenApiAqlCostModelTerm',
+    {
+        'document_frequency': 'int',
+        'term': 'str',
+    },
+    total=False,
+)
+
+OpenApiAqlCostModelEstimate = TypedDict(
+    'OpenApiAqlCostModelEstimate',
+    {
+        'cost_units': 'int',
+        'path': "Literal['bitmap-first', 'lexical-first', 'vector-first', 'hybrid', 'pack']",
+    },
+    total=False,
+)
+
+OpenApiAqlCostModel = TypedDict(
+    'OpenApiAqlCostModel',
+    {
+        'estimated_after_bitmap': 'int | None',
+        'estimated_live_rows': 'int',
+        'estimates': 'list[OpenApiAqlCostModelEstimate]',
+        'has_query_vector': 'bool',
+        'rarest_term': 'OpenApiAqlCostModelTerm | Any',
+        'reason': 'str',
+        'recommended_candidate_limit': 'int',
+        'selected_path': "Literal['bitmap-first', 'lexical-first', 'vector-first', 'hybrid']",
+    },
+    total=False,
+)
+
+OpenApiAqlLogicalPlanNode = TypedDict(
+    'OpenApiAqlLogicalPlanNode',
+    {
+        'detail': 'str',
+        'id': 'int',
+        'kind': 'str',
+        'permission_predicate': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiAqlLogicalPlan = TypedDict(
+    'OpenApiAqlLogicalPlan',
+    {
+        'nodes': 'list[OpenApiAqlLogicalPlanNode]',
+        'policy_complete': 'bool',
+    },
+    total=False,
+)
+
+OpenApiAqlExecutionOperator = TypedDict(
+    'OpenApiAqlExecutionOperator',
+    {
+        'actual_input_count': 'int',
+        'actual_output_count': 'int',
+        'elapsed_nanos': 'int',
+        'estimated_output_count': 'int | Any',
+        'input_count': 'int',
+        'name': 'str',
+        'output_count': 'int',
+    },
+    total=False,
+)
+
+OpenApiAqlExecutionTrace = TypedDict(
+    'OpenApiAqlExecutionTrace',
+    {
+        'operators': 'list[OpenApiAqlExecutionOperator]',
+        'total_elapsed_nanos': 'int',
+    },
+    total=False,
+)
+
+OpenApiAqlExplainResponse = TypedDict(
+    'OpenApiAqlExplainResponse',
+    {
+        'bitmap_ops': 'list[str]',
+        'bitmap_plan': 'str',
+        'brain_id': 'int',
+        'budget_tokens': 'int',
+        'candidate_counts': 'OpenApiAqlCandidateCounts',
+        'candidate_limit': 'int',
+        'citations_required': 'bool',
+        'cost_model': 'OpenApiAqlCostModel',
+        'execution_trace': 'OpenApiAqlExecutionTrace',
+        'filters': 'list[OpenApiAqlExplainFilter]',
+        'logical_plan': 'OpenApiAqlLogicalPlan',
+        'policy_rewritten_plan': 'OpenApiAqlLogicalPlan',
+        'selected_mode': "Literal['fast', 'balanced', 'semantic', 'audit']",
+        'task': 'str',
+    },
+    total=False,
+)
+
+OpenApiSearchRoutingDecision = TypedDict(
+    'OpenApiSearchRoutingDecision',
+    {
+        'reason': 'str',
+        'requested_mode': 'str',
+        'selected_strategy': "Literal['keyword', 'vector_exact', 'vector_ann', 'hybrid']",
+        'text_available': 'bool',
+        'vector_available': 'bool',
+    },
+    total=False,
+)
+
+OpenApiSearchResponse = TypedDict(
+    'OpenApiSearchResponse',
+    {
+        'ann_report': 'OpenApiAnnSearchReport | Any',
+        'no_fallback_decision': 'OpenApiAnnNoFallbackDecision | Any',
+        'rerank': "Literal['weighted']",
+        'results': 'list[dict[str, Any]]',
+        'routing': 'OpenApiSearchRoutingDecision | Any',
+        'search_mode': "Literal['keyword', 'vector_exact', 'vector_ann', 'hybrid']",
+    },
+    total=False,
+)
+
+OpenApiAnnSearchReport = TypedDict(
+    'OpenApiAnnSearchReport',
+    {
+        'allowed_candidates': 'int',
+        'fallback_performed': 'bool',
+        'fallback_reason': "Literal['empty_graph', 'invalid_graph', 'stale_graph', 'insufficient_results', 'low_recall', 'visit_budget_exceeded', 'no_persisted_segments', 'uncheckpointed_changes', 'hnsw_disabled'] | Any",
+        'graph_nodes': 'int',
+        'hnsw_ef_construction': 'int',
+        'hnsw_ef_search': 'int',
+        'hnsw_layer_count': 'int',
+        'hnsw_max_neighbors': 'int',
+        'max_visited_candidates': 'int | Any',
+        'min_recall_q16': 'int | Any',
+        'path': "Literal['hnsw_graph', 'exact_fallback']",
+        'production_safe': 'bool',
+        'recall_q16': 'int | Any',
+        'requested_limit': 'int',
+        'require_slo': 'bool',
+        'returned_candidates': 'int',
+        'slo_violations': "list[Literal['empty_graph', 'invalid_graph', 'insufficient_results', 'low_recall', 'visit_budget_exceeded', 'no_persisted_segments', 'uncheckpointed_changes', 'hnsw_disabled', 'recall_below_minimum', 'weak_multi_layer_topology']]",
+        'upper_graph_edges': 'int',
+        'visited_candidates': 'int',
+    },
+    total=False,
+)
+
+OpenApiAnnNoFallbackDecision = TypedDict(
+    'OpenApiAnnNoFallbackDecision',
+    {
+        'allowed': 'bool',
+        'reasons': "list[Literal['rollout_disabled', 'fallback_enabled', 'slo_not_required', 'not_hnsw_graph_path', 'fallback_occurred', 'fallback_reason_present', 'report_not_production_safe', 'slo_violations_present', 'empty_graph', 'no_eligible_candidates', 'no_results', 'weak_multi_layer_topology', 'recall_missing', 'recall_below_minimum', 'search_policy_below_rollout_minimum']]",
+    },
+    total=False,
+)
+
+OpenApiAnnEvaluationResponse = TypedDict(
+    'OpenApiAnnEvaluationResponse',
+    {
+        'ann_report': 'OpenApiAnnSearchReport | Any',
+        'ann_top_k': 'list[int]',
+        'available': 'bool',
+        'exact_top_k': 'list[int]',
+        'no_fallback_decision': 'OpenApiAnnNoFallbackDecision | Any',
+        'overlap_count': 'int',
+        'reason': "Literal['requires_persisted_checkpoint_without_wal_tail'] | Any",
+        'recall_q16': 'int',
+    },
+    total=False,
+)
+
+OpenApiContextPackResponse = TypedDict(
+    'OpenApiContextPackResponse',
+    {
+        'anomalies': 'list[OpenApiContextPackAnomalyResponse]',
+        'answerability_q16': 'int',
+        'cells': 'list[OpenApiContextPackCellResponse]',
+        'citations_required': 'bool',
+        'conflict_visibility_q16': 'int',
+        'estimated_tokens': 'int',
+        'schema_version': "Literal['context_pack.v1']",
+        'token_budget_tokens': 'int',
+        'truncated': 'bool',
+        'visible_conflict_count': 'int',
+    },
+    total=False,
+)
+
+OpenApiContextPackCellResponse = TypedDict(
+    'OpenApiContextPackCellResponse',
+    {
+        'access_decision': 'OpenApiContextAccessDecisionResponse | Any',
+        'cell_id': 'int',
+        'citation': 'str | Any',
+        'estimated_tokens': 'int',
+        'explain': 'OpenApiContextPackExplainResponse | Any',
+        'payload_text': 'str',
+        'provenance': 'OpenApiContextSpanProvenanceResponse | Any',
+        'source_ref': 'OpenApiSourceRefResponse | Any',
+    },
+    total=False,
+)
+
+OpenApiContextAccessDecisionResponse = TypedDict(
+    'OpenApiContextAccessDecisionResponse',
+    {
+        'agent_id': 'int | Any',
+        'auth_role': 'str',
+        'cell_id': 'int',
+        'decision': "Literal['allowed', 'not_recorded']",
+        'policy': 'str',
+        'principal_id': 'str',
+        'reason': 'str',
+        'scope': 'str',
+        'scope_id': 'int',
+    },
+    total=False,
+)
+
+OpenApiContextSpanProvenanceResponse = TypedDict(
+    'OpenApiContextSpanProvenanceResponse',
+    {
+        'source_byte_end': 'int',
+        'source_byte_start': 'int',
+        'source_cell_id': 'int',
+        'source_line_end': 'int',
+        'source_line_start': 'int',
+        'source_ref': 'OpenApiSourceRefResponse | Any',
+    },
+    total=False,
+)
+
+OpenApiContextPackExplainResponse = TypedDict(
+    'OpenApiContextPackExplainResponse',
+    {
+        'base_bm25': 'int',
+        'matched_terms': 'list[str]',
+        'redundancy_penalty': 'int',
+        'score': 'int',
+        'score_components': 'list[OpenApiContextPackScoreComponentResponse]',
+        'source_freshness_bonus': 'int',
+        'source_freshness_category': "Literal['unknown', 'stale', 'older', 'recent', 'current']",
+        'source_freshness_q16': 'int',
+        'source_trust_bonus': 'int',
+        'source_trust_category': "Literal['unknown', 'low', 'medium', 'high', 'official']",
+        'source_trust_q16': 'int',
+        'why_selected': 'str',
+    },
+    total=False,
+)
+
+OpenApiContextPackScoreComponentResponse = TypedDict(
+    'OpenApiContextPackScoreComponentResponse',
+    {
+        'contribution': 'int',
+        'name': 'str',
+        'reason': 'str',
+        'value': 'int',
+    },
+    total=False,
+)
+
+OpenApiSourceRefResponse = TypedDict(
+    'OpenApiSourceRefResponse',
+    {
+        'cell_range': 'str | Any',
+        'confidence_q16': 'int',
+        'document_id': 'str | Any',
+        'json_path': 'str | Any',
+        'page': 'int | Any',
+        'row': 'int | Any',
+        'source_id': 'str',
+        'source_url': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiContextPackAnomalyResponse = TypedDict(
+    'OpenApiContextPackAnomalyResponse',
+    {
+        'cell_id': 'int | Any',
+        'code': "Literal['redundant_cell', 'missing_citation', 'token_overload', 'scope_mismatch', 'insufficient_context', 'visible_conflict']",
+        'message': 'str',
+        'why_excluded': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiContextRequest = TypedDict(
+    'OpenApiContextRequest',
+    {
+        'embed_query': 'bool',
+        'query_text': 'str | Any',
+        'retrieve_aql': 'str',
+    },
+    total=False,
+)
+
+OpenApiContextTraceRequest = TypedDict(
+    'OpenApiContextTraceRequest',
+    {
+        'retrieve_aql': 'str',
+        'verify_aql': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiContextTraceResponse = TypedDict(
+    'OpenApiContextTraceResponse',
+    {
+        'context': 'OpenApiContextPackResponse',
+        'schema_version': "Literal['context_trace.v1']",
+        'trace': 'OpenApiContextPipelineTrace',
+        'verification': 'OpenApiVerificationReportResponse | Any',
+    },
+    total=False,
+)
+
+OpenApiContextPipelineTrace = TypedDict(
+    'OpenApiContextPipelineTrace',
+    {
+        'cells': 'list[OpenApiContextPipelineCellTrace]',
+        'schema_version': "Literal['context_pipeline_trace.v1']",
+        'stages': 'list[OpenApiContextPipelineStageTrace]',
+        'total_duration_ms': 'int | Any',
+        'verification': 'OpenApiContextPipelineVerificationTrace | Any',
+    },
+    total=False,
+)
+
+OpenApiContextPipelineStageTrace = TypedDict(
+    'OpenApiContextPipelineStageTrace',
+    {
+        'duration_ms': 'int | Any',
+        'input_items': 'int',
+        'name': "Literal['retrieve', 'pack', 'verify']",
+        'notes': 'list[str]',
+        'output_items': 'int',
+    },
+    total=False,
+)
+
+OpenApiContextPipelineCellTrace = TypedDict(
+    'OpenApiContextPipelineCellTrace',
+    {
+        'access_decision': "Literal['allowed', 'not_recorded'] | Any",
+        'cell_id': 'int',
+        'citation_present': 'bool',
+        'estimated_tokens': 'int',
+        'matched_terms': 'list[str]',
+        'packed_rank': 'int',
+        'provenance_present': 'bool',
+        'score': 'int | Any',
+        'score_components': 'list[OpenApiContextPipelineScoreComponentTrace]',
+        'why_selected': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiContextPipelineScoreComponentTrace = TypedDict(
+    'OpenApiContextPipelineScoreComponentTrace',
+    {
+        'contribution': 'int',
+        'name': 'str',
+        'reason': 'str',
+        'value': 'int',
+    },
+    total=False,
+)
+
+OpenApiContextPipelineVerificationTrace = TypedDict(
+    'OpenApiContextPipelineVerificationTrace',
+    {
+        'contradicting_cell_ids': 'list[int]',
+        'contradicting_evidence_count': 'int',
+        'evidence_cell_ids': 'list[int]',
+        'evidence_count': 'int',
+        'fact': 'str',
+        'guard_count': 'int',
+        'numeric_conflict_count': 'int',
+        'status': "Literal['supported', 'insufficient', 'contradicted', 'mixed_evidence']",
+    },
+    total=False,
+)
+
+OpenApiLlmInferenceRequest = TypedDict(
+    'OpenApiLlmInferenceRequest',
+    {
+        'api_key': 'str | Any',
+        'context_pack': 'dict[str, Any]',
+        'enabled': 'bool',
+        'model': "Literal['deterministic-echo-v1']",
+        'prompt': 'str',
+        'provider': "Literal['test_double']",
+        'schema_version': "Literal['cortexdb.llm_inference.smoke_request.v1']",
+    },
+    total=False,
+)
+
+OpenApiLlmInferenceAuditResponse = TypedDict(
+    'OpenApiLlmInferenceAuditResponse',
+    {
+        'context_pack_only': 'bool',
+        'prompt_body_logged': 'bool',
+        'secrets_logged': 'bool',
+    },
+    total=False,
+)
+
+OpenApiLlmInferenceResponse = TypedDict(
+    'OpenApiLlmInferenceResponse',
+    {
+        'audit': 'OpenApiLlmInferenceAuditResponse',
+        'citations': 'list[str]',
+        'grounding': 'OpenApiAnswerGroundingReportResponse',
+        'model': "Literal['deterministic-echo-v1']",
+        'output': 'str',
+        'provider': "Literal['test_double']",
+        'schema_version': "Literal['cortexdb.llm_inference.smoke_response.v1']",
+        'used_context_cell_ids': 'list[int]',
+    },
+    total=False,
+)
+
+OpenApiAnswerGroundingReportResponse = TypedDict(
+    'OpenApiAnswerGroundingReportResponse',
+    {
+        'answer_supported': 'bool',
+        'rejected': 'bool',
+        'spans': 'list[OpenApiAnswerGroundingSpanResponse]',
+        'support_q16': 'int',
+        'supported_span_count': 'int',
+        'unsupported_span_count': 'int',
+    },
+    total=False,
+)
+
+OpenApiAnswerGroundingSpanResponse = TypedDict(
+    'OpenApiAnswerGroundingSpanResponse',
+    {
+        'citations': 'list[str]',
+        'covered_terms': 'list[str]',
+        'end_byte': 'int',
+        'missing_terms': 'list[str]',
+        'start_byte': 'int',
+        'support_q16': 'int',
+        'supported': 'bool',
+        'supported_by_cell_ids': 'list[int]',
+        'text': 'str',
+    },
+    total=False,
+)
+
+OpenApiGuardResponse = TypedDict(
+    'OpenApiGuardResponse',
+    {
+        'cell_id': 'int | Any',
+        'code': "Literal['missing_citation', 'numeric_mismatch']",
+        'message': 'str',
+    },
+    total=False,
+)
+
+OpenApiRememberResponse = TypedDict(
+    'OpenApiRememberResponse',
+    {
+        'cell_id': 'int',
+        'seq': 'int',
+        'ttl_seconds': 'int | Any',
+    },
+    total=False,
+)
+
+OpenApiVerificationReportResponse = TypedDict(
+    'OpenApiVerificationReportResponse',
+    {
+        'confidence_q16': 'int',
+        'contradicting': 'list[OpenApiVerificationEvidenceResponse]',
+        'contradicting_evidence': 'list[OpenApiVerificationEvidenceResponse]',
+        'evidence': 'list[OpenApiVerificationEvidenceResponse]',
+        'fact': 'str',
+        'guards': 'list[OpenApiGuardResponse]',
+        'numeric_conflicts': 'list[OpenApiNumericConflictResponse]',
+        'status': 'str',
+        'supporting': 'list[OpenApiVerificationEvidenceResponse]',
+        'verdict': 'str',
+    },
+    total=False,
+)
+
+OpenApiNumericConflictResponse = TypedDict(
+    'OpenApiNumericConflictResponse',
+    {
+        'left': 'str',
+        'metric': 'str',
+        'right': 'str',
+    },
+    total=False,
+)
+
+OpenApiConflictIndexResponse = TypedDict(
+    'OpenApiConflictIndexResponse',
+    {
+        'conflict_count': 'int',
+        'conflicts': 'list[OpenApiConflictRecordResponse]',
+        'schema_version': 'str',
+        'scope': 'str',
+    },
+    total=False,
+)
+
+OpenApiConflictRecordResponse = TypedDict(
+    'OpenApiConflictRecordResponse',
+    {
+        'cell_id': 'int',
+        'entity': 'str | Any',
+        'fact': 'str',
+        'metric': 'str | Any',
+        'relation_cell_id': 'int | Any',
+        'source': 'str | Any',
+        'source_cell_id': 'int | Any',
+        'source_trust_category': 'str',
+        'source_trust_q16': 'int',
+    },
+    total=False,
+)
+
+OpenApiVerificationEvidenceResponse = TypedDict(
+    'OpenApiVerificationEvidenceResponse',
+    {
+        'cell_id': 'int',
+        'citation': 'str | Any',
+        'match_kind': "Literal['exact_text', 'semantic_entailment', 'numeric_entailment', 'semantic_contradiction', 'numeric_contradiction', 'graph_contradiction']",
+        'match_score_q16': 'int',
+        'matched_terms': 'int',
+        'payload_text': 'str',
+        'source_trust_category': "Literal['unknown', 'low', 'medium', 'high', 'official']",
+        'source_trust_q16': 'int',
+    },
+    total=False,
+)
+
+OpenApiIngestResponse = TypedDict(
+    'OpenApiIngestResponse',
+    {
+        'chunks_ingested': 'int',
+        'facts_ingested': 'int',
+        'first_cell_id': 'int | Any',
+        'job_id': 'int | Any',
+        'rows_ingested': 'int',
+        'validation_report': 'OpenApiIngestionValidationReport',
+    },
+    total=False,
+)
+
+OpenApiIngestionValidationReport = TypedDict(
+    'OpenApiIngestionValidationReport',
+    {
+        'cells_seen': 'int',
+        'invalid_metadata_records': 'int',
+        'processed_records': 'int',
+        'skipped_items': 'list[OpenApiIngestionSkippedItem]',
+        'skipped_records': 'int',
+        'source_refs': 'list[OpenApiIngestionSourceRefReport]',
+        'warnings': 'list[OpenApiIngestionValidationIssue]',
+    },
+    total=False,
+)
+
+OpenApiIngestionValidationIssue = TypedDict(
+    'OpenApiIngestionValidationIssue',
+    {
+        'cell_id': 'int | Any',
+        'chunk_id': 'str | Any',
+        'code': 'str',
+        'message': 'str',
+    },
+    total=False,
+)
+
+OpenApiIngestionSkippedItem = TypedDict(
+    'OpenApiIngestionSkippedItem',
+    {
+        'input_ref': 'str | Any',
+        'reason': 'str',
+    },
+    total=False,
+)
+
+OpenApiIngestionSourceRefReport = TypedDict(
+    'OpenApiIngestionSourceRefReport',
+    {
+        'cell_id': 'int',
+        'cell_range': 'str | Any',
+        'chunk_id': 'str | Any',
+        'confidence_q16': 'int | Any',
+        'document_id': 'str | Any',
+        'has_source_ref': 'bool',
+        'json_path': 'str | Any',
+        'page': 'int | Any',
+        'row': 'int | Any',
+        'source_id': 'str | Any',
+        'source_url': 'str | Any',
+    },
+    total=False,
+)
+
+OpenApiIngestionProgress = TypedDict(
+    'OpenApiIngestionProgress',
+    {
+        'completed_items': 'int',
+        'failed_items': 'int',
+        'job_id': 'int',
+        'label': 'str',
+        'last_cell_id': 'int | Any',
+        'max_retries': 'int',
+        'message': 'str | Any',
+        'retry_count': 'int',
+        'status': "Literal['queued', 'running', 'completed', 'failed', 'cancelled']",
+        'total_items': 'int | Any',
+    },
+    total=False,
+)
+
+OpenApiErrorResponse = TypedDict(
+    'OpenApiErrorResponse',
+    {
+        'code': "Literal['not_found', 'bad_request', 'unauthorized', 'forbidden', 'payload_too_large', 'rate_limited', 'quota_exceeded', 'service_unavailable', 'internal', 'invalid_aql', 'unknown_field', 'unsupported_operator', 'permission_denied', 'database_busy', 'storage_corruption', 'invalid_tenant']",
+        'error': 'str',
+        'message': 'str',
+    },
+    total=False,
+)
+
+OpenApiMetricsResponse = TypedDict(
+    'OpenApiMetricsResponse',
+    {
+        'actor_queue_capacity': 'int',
+        'actor_queue_depth': 'int',
+        'actor_queue_wait_latency_ms': 'OpenApiLatencyHistogramResponse',
+        'actor_queue_wait_p95_ms': 'int',
+        'ann_fallbacks': 'int',
+        'ann_graph_nodes': 'int',
+        'ann_has_checkpoint': 'bool',
+        'ann_has_uncheckpointed_changes': 'bool',
+        'ann_no_fallback_allowed': 'int',
+        'ann_no_fallback_blocked': 'int',
+        'ann_no_fallback_requests': 'int',
+        'ann_persisted_segments': 'int',
+        'ann_search_latency_ms': 'OpenApiLatencyHistogramResponse',
+        'ann_search_requests': 'int',
+        'ann_total_edges': 'int',
+        'aql_query_cache': 'OpenApiAqlQueryCacheStatsResponse',
+        'backup_latest_age_seconds': 'int',
+        'checkpoint_seq': 'int',
+        'compaction_cells_compacted': 'int',
+        'compaction_duration_ms_total': 'int',
+        'compaction_input_bytes': 'int',
+        'compaction_pressure_q16': 'int',
+        'compactions_completed': 'int',
+        'compactions_triggered': 'int',
+        'current_seq': 'int',
+        'durable_storage_bytes': 'int',
+        'estimated_context_pack_bytes': 'int',
+        'estimated_index_bytes': 'int',
+        'estimated_memtable_bytes': 'int',
+        'estimated_total_memory_bytes': 'int',
+        'live_segment_bytes': 'int',
+        'live_segment_payload_bytes': 'int',
+        'live_segments': 'int',
+        'logical_payload_bytes': 'int',
+        'memtable_cells': 'int',
+        'memtable_payload_bytes': 'int',
+        'memtable_versions': 'int',
+        'principal_quota_body_bytes_allowed': 'int',
+        'principal_quota_body_bytes_rejected': 'int',
+        'principal_quota_queue_acquired': 'int',
+        'principal_quota_queue_rejected': 'int',
+        'principal_quota_requests_allowed': 'int',
+        'principal_quota_requests_rejected': 'int',
+        'request_count': 'int',
+        'request_duration_ms_total': 'int',
+        'request_id_client_provided': 'int',
+        'request_id_generated': 'int',
+        'request_rejected': 'int',
+        'retired_segment_bytes': 'int',
+        'retired_segments': 'int',
+        'space_amplification_q16': 'int',
+        'total_segment_bytes': 'int',
+        'validation_failures': 'int',
+        'wal_size_bytes': 'int',
+        'wal_writer_batches': 'int',
+        'wal_writer_bytes': 'int',
+        'wal_writer_fsyncs': 'int',
+        'wal_writer_records': 'int',
+        'write_amplification_q16': 'int',
+    },
+    total=False,
+)
+
+OpenApiLatencyHistogramResponse = TypedDict(
+    'OpenApiLatencyHistogramResponse',
+    {
+        'count': 'int',
+        'gt_1000_ms': 'int',
+        'le_1000_ms': 'int',
+        'le_100_ms': 'int',
+        'le_10_ms': 'int',
+        'le_500_ms': 'int',
+        'le_50_ms': 'int',
+        'sum_ms': 'int',
+    },
+    total=False,
+)
+
+OpenApiCompactionResponse = TypedDict(
+    'OpenApiCompactionResponse',
+    {
+        'cells_compacted': 'int',
+        'compacted': 'bool',
+        'duration_ms': 'int',
+        'input_bytes': 'int',
+        'output_bytes': 'int',
+        'segments_after': 'int',
+        'segments_before': 'int',
+    },
+    total=False,
+)
+
+OpenApiCompactionMetricsResponse = TypedDict(
+    'OpenApiCompactionMetricsResponse',
+    {
+        'compaction_cells_compacted': 'int',
+        'compaction_duration_ms_total': 'int',
+        'compaction_input_bytes': 'int',
+        'compactions_completed': 'int',
+        'compactions_triggered': 'int',
+    },
+    total=False,
+)
+
+OpenApiCompactorStatusResponse = TypedDict(
+    'OpenApiCompactorStatusResponse',
+    {
+        'compaction': 'OpenApiCompactionMetricsResponse',
+        'live_segments': 'int',
+        'retired_segments': 'int',
+    },
+    total=False,
+)
+
+OpenApiCompactorControlResponse = TypedDict(
+    'OpenApiCompactorControlResponse',
+    {
+        'background_enabled': 'bool',
+        'interval_seconds': 'int',
+        'paused': 'bool',
+    },
+    total=False,
+)
+
+OpenApiAnnMetricsResponse = TypedDict(
+    'OpenApiAnnMetricsResponse',
+    {
+        'deleted_vectors': 'int',
+        'graph_nodes': 'int',
+        'has_checkpoint': 'bool',
+        'has_uncheckpointed_changes': 'bool',
+        'persisted_segments': 'int',
+        'rebuild_count': 'int',
+        'total_edges': 'int',
+    },
+    total=False,
+)
+
+OpenApiSearchExplainResponse = TypedDict(
+    'OpenApiSearchExplainResponse',
+    {
+        'query_terms': 'list[str]',
+        'results': 'list[dict[str, Any]]',
+        'routing': 'OpenApiSearchRoutingDecision',
+        'search_mode': 'str',
+    },
+    total=False,
+)