{"openapi":"3.1.0","info":{"title":"AML Suspicious Activity Detection Agent","description":"Dynamic AML query planning over HI-Small, grounded by the separate SAML-D knowledge and validation dataset.","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["ops"],"summary":"Health","description":"Liveness probe.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Health Get"}}}}}}},"/ready":{"get":{"tags":["ops"],"summary":"Ready","description":"Readiness probe that verifies both governed analytical tables.","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Ready Ready Get"}}}}}}},"/ingest":{"post":{"tags":["ops"],"summary":"Ingest","description":"Ingest both datasets while preserving separate DuckDB tables.","operationId":"ingest_ingest_post","parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Ingest Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stats":{"get":{"tags":["data"],"summary":"Dataset Stats","description":"Return high-level statistics for both persisted tables.","operationId":"dataset_stats_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Dataset Stats Stats Get"}}}}}}},"/model-card":{"get":{"tags":["ml"],"summary":"Model Card","description":"Return truthful, reproducible metadata for the active anomaly model.","operationId":"model_card_model_card_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Model Card Model Card Get"}}}}}}},"/model-card/drift":{"get":{"tags":["ml"],"summary":"Model Drift","description":"Compare the current HI-Small batch to the model's training baseline.","operationId":"model_drift_model_card_drift_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":100,"default":1000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Model Drift Model Card Drift Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/investigations":{"get":{"tags":["workflow"],"summary":"Investigations","operationId":"investigations_investigations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"dataset_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InvestigationSummary"},"title":"Response Investigations Investigations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/investigations/{investigation_id}":{"get":{"tags":["workflow"],"summary":"Investigation Detail","operationId":"investigation_detail_investigations__investigation_id__get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigationRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/investigations/{investigation_id}/aws-status":{"get":{"tags":["workflow"],"summary":"Investigation Aws Status","description":"Expose real publish status and a short-lived private report download.","operationId":"investigation_aws_status_investigations__investigation_id__aws_status_get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Investigation Aws Status Investigations  Investigation Id  Aws Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/investigations/{investigation_id}/retry-aws":{"post":{"tags":["workflow"],"summary":"Retry Investigation Aws","operationId":"retry_investigation_aws_investigations__investigation_id__retry_aws_post","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Retry Investigation Aws Investigations  Investigation Id  Retry Aws Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/queue/summary":{"get":{"tags":["workflow"],"summary":"Review Queue Summary","operationId":"review_queue_summary_queue_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"integer"},"type":"object","title":"Response Review Queue Summary Queue Summary Get"}}}}}}},"/queue":{"get":{"tags":["workflow"],"summary":"Review Queue","operationId":"review_queue_queue_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Review Queue Queue Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/queue/{alert_id}/assign":{"post":{"tags":["workflow"],"summary":"Assign Queue Item","operationId":"assign_queue_item_queue__alert_id__assign_post","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueAssignmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertQueueItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/queue/{alert_id}/disposition":{"post":{"tags":["workflow"],"summary":"Disposition Queue Item","operationId":"disposition_queue_item_queue__alert_id__disposition_post","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueDispositionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertQueueItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/queue/{alert_id}/notes":{"post":{"tags":["workflow"],"summary":"Note Queue Item","operationId":"note_queue_item_queue__alert_id__notes_post","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueNoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertQueueItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/audit":{"get":{"tags":["governance"],"summary":"Audit Trail","description":"Read immutable audit records; external audit insertion is prohibited.","operationId":"audit_trail_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Audit Trail Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/policy":{"get":{"tags":["governance"],"summary":"Policy","description":"Return the effective read-only risk policy used by the engines.","operationId":"policy_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Policy Policy Get"}}}}}}},"/datasets":{"get":{"tags":["data"],"summary":"Datasets","description":"Return every governed dataset workspace.","operationId":"datasets_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DatasetInfo"},"type":"array","title":"Response Datasets Datasets Get"}}}}}}},"/datasets/inspect":{"post":{"tags":["data"],"summary":"Inspect Dataset","description":"Inspect an upload without registering or activating it.","operationId":"inspect_dataset_datasets_inspect_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_inspect_dataset_datasets_inspect_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Inspect Dataset Datasets Inspect Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/datasets/upload":{"post":{"tags":["data"],"summary":"Upload Dataset","description":"Validate and ingest an upload into an isolated DuckDB schema.","operationId":"upload_dataset_datasets_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_dataset_datasets_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetUploadResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/datasets/{dataset_id}":{"get":{"tags":["data"],"summary":"Dataset Detail","operationId":"dataset_detail_datasets__dataset_id__get","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["data"],"summary":"Delete Registered Dataset","operationId":"delete_registered_dataset_datasets__dataset_id__delete","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Delete Registered Dataset Datasets  Dataset Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/datasets/{dataset_id}/activate":{"post":{"tags":["data"],"summary":"Activate Registered Dataset","operationId":"activate_registered_dataset_datasets__dataset_id__activate_post","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetSwitchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/customers":{"get":{"tags":["evidence"],"summary":"Customers","description":"Return paginated customer activity ranked by current workflow risk.","operationId":"customers_customers_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Search"}},{"name":"risk_label","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Label"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Customers Customers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/customers/{account_id}":{"get":{"tags":["evidence"],"summary":"Customer Detail","description":"Return consolidated behavior, counterparties, and alerts for an account.","operationId":"customer_detail_customers__account_id__get","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transactions/payment-formats":{"get":{"tags":["evidence"],"summary":"Transaction Payment Formats","operationId":"transaction_payment_formats_transactions_payment_formats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Response Transaction Payment Formats Transactions Payment Formats Get"}}}}}}},"/transactions":{"get":{"tags":["evidence"],"summary":"Transactions","description":"Return a bounded evidence page with query-aware filters.","operationId":"transactions_transactions_get","parameters":[{"name":"account_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Account Id"}},{"name":"direction","in":"query","required":false,"schema":{"type":"string","default":"both","title":"Direction"}},{"name":"payment_format","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Payment Format"}},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Min Amount"}},{"name":"max_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Max Amount"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"laundering_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Laundering Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Transactions Transactions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/exports/investigations/{investigation_id}/entities":{"get":{"tags":["export"],"summary":"Export Investigation Entities","operationId":"export_investigation_entities_exports_investigations__investigation_id__entities_get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json","xlsx"],"type":"string","default":"csv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/entities":{"get":{"tags":["export"],"summary":"Export Entities","description":"Export flagged entities from one immutable investigation record.","operationId":"export_entities_export_entities_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json","xlsx"],"type":"string","default":"csv","title":"Format"}},{"name":"investigation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/sar/{entity_id}":{"get":{"tags":["export"],"summary":"Export Sar","description":"Export a human-review-only SAR draft for one flagged entity.","operationId":"export_sar_export_sar__entity_id__get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["txt","pdf"],"type":"string","default":"txt","title":"Format"}},{"name":"investigation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/investigation/{investigation_id}":{"get":{"tags":["export"],"summary":"Export Investigation","operationId":"export_investigation_export_investigation__investigation_id__get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","md","pdf"],"type":"string","default":"pdf","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/exports/investigations/{investigation_id}":{"get":{"tags":["export"],"summary":"Export Investigation","operationId":"export_investigation_exports_investigations__investigation_id__get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","md","pdf"],"type":"string","default":"pdf","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/trace/{investigation_id}":{"get":{"tags":["export"],"summary":"Export Trace","operationId":"export_trace_export_trace__investigation_id__get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"csv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/exports/investigations/{investigation_id}/trace":{"get":{"tags":["export"],"summary":"Export Trace","operationId":"export_trace_exports_investigations__investigation_id__trace_get","parameters":[{"name":"investigation_id","in":"path","required":true,"schema":{"type":"string","title":"Investigation Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"csv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/model-card":{"get":{"tags":["export"],"summary":"Export Active Model Card","operationId":"export_active_model_card_export_model_card_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","md","pdf"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/audit":{"get":{"tags":["export"],"summary":"Export Audit","operationId":"export_audit_export_audit_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json"],"type":"string","default":"csv","title":"Format"}},{"name":"from_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From Date"}},{"name":"to_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export/eda":{"get":{"tags":["export"],"summary":"Export Eda","operationId":"export_eda_export_eda_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["json","html","pdf"],"type":"string","default":"json","title":"Format"}},{"name":"investigation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Investigation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/query":{"post":{"tags":["agent"],"summary":"Query","description":"Run intent extraction, planning, and the current tool implementations.","operationId":"query_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AgentResponse":{"properties":{"investigation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Investigation Id"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"dataset_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Name"},"query":{"type":"string","title":"Query"},"intent":{"$ref":"#/components/schemas/IntentResult"},"plan":{"$ref":"#/components/schemas/PlanResult"},"execution_trace":{"items":{"$ref":"#/components/schemas/ExecutionStep"},"type":"array","title":"Execution Trace"},"top_entities":{"items":{"$ref":"#/components/schemas/FlaggedEntity"},"type":"array","title":"Top Entities"},"summary_stats":{"$ref":"#/components/schemas/SummaryStats"},"eda_summary":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Eda Summary"},"charts":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Charts"},"graph":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Graph"},"aggregation":{"anyOf":[{"$ref":"#/components/schemas/AggregationResult"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["query","intent","plan","execution_trace"],"title":"AgentResponse","description":"Complete structured response returned by ``AgentRunner`` and FastAPI."},"AggregationResult":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/AggregationRow"},"type":"array","title":"Rows"},"total_groups":{"type":"integer","minimum":0.0,"title":"Total Groups","default":0},"filter_applied":{"type":"object","title":"Filter Applied"},"group_by_field":{"type":"string","title":"Group By Field"}},"additionalProperties":false,"type":"object","required":["group_by_field"],"title":"AggregationResult","description":"Structured response for direct grouped/count threshold questions."},"AggregationRow":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"txn_count":{"type":"integer","minimum":0.0,"title":"Txn Count"},"total_amount":{"type":"number","minimum":0.0,"title":"Total Amount"},"avg_amount":{"type":"number","minimum":0.0,"title":"Avg Amount"},"min_amount":{"type":"number","minimum":0.0,"title":"Min Amount"},"max_amount":{"type":"number","minimum":0.0,"title":"Max Amount"},"date_first":{"type":"string","title":"Date First"},"date_last":{"type":"string","title":"Date Last"},"distinct_counterparties":{"type":"integer","minimum":0.0,"title":"Distinct Counterparties"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score","default":0.0},"risk_label":{"type":"string","enum":["low","medium","high"],"title":"Risk Label","default":"low"}},"additionalProperties":false,"type":"object","required":["entity_id","txn_count","total_amount","avg_amount","min_amount","max_amount","date_first","date_last","distinct_counterparties"],"title":"AggregationRow","description":"One ranked group returned by a threshold aggregation query."},"AlertQueueItem":{"properties":{"alert_id":{"type":"string","title":"Alert Id"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"entity_id":{"type":"string","title":"Entity Id"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score"},"risk_label":{"type":"string","enum":["low","medium","high"],"title":"Risk Label"},"escalation_action":{"type":"string","enum":["monitor","flag_for_review","report"],"title":"Escalation Action"},"saml_d_typology":{"type":"string","title":"Saml D Typology","default":""},"created_at":{"type":"string","title":"Created At"},"sla_hours":{"type":"integer","minimum":1.0,"title":"Sla Hours"},"age_hours":{"type":"number","minimum":0.0,"title":"Age Hours"},"assigned_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"},"status":{"type":"string","enum":["new","in_review","escalated","closed"],"title":"Status"},"disposition":{"anyOf":[{"type":"string","enum":["pending","true_positive","false_positive","escalated","sar_filed"]},{"type":"null"}],"title":"Disposition","default":"pending"},"investigation_id":{"type":"string","title":"Investigation Id"},"notes":{"type":"string","title":"Notes","default":""}},"additionalProperties":false,"type":"object","required":["alert_id","entity_id","risk_score","risk_label","escalation_action","created_at","sla_hours","age_hours","status","investigation_id"],"title":"AlertQueueItem","description":"One persistent alert in the analyst review queue."},"Body_inspect_dataset_datasets_inspect_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_inspect_dataset_datasets_inspect_post"},"Body_upload_dataset_datasets_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"display_name":{"type":"string","title":"Display Name","default":""},"dataset_type":{"type":"string","enum":["primary","knowledge","kyc"],"title":"Dataset Type","default":"primary"},"force":{"type":"boolean","title":"Force","default":false}},"type":"object","required":["file"],"title":"Body_upload_dataset_datasets_upload_post"},"CounterpartySummary":{"properties":{"account_id":{"type":"string","title":"Account Id"},"transaction_count":{"type":"integer","minimum":0.0,"title":"Transaction Count"},"total_amount":{"type":"number","minimum":0.0,"title":"Total Amount"},"direction":{"type":"string","enum":["inbound","outbound"],"title":"Direction"}},"additionalProperties":false,"type":"object","required":["account_id","transaction_count","total_amount","direction"],"title":"CounterpartySummary"},"CustomerDetail":{"properties":{"summary":{"$ref":"#/components/schemas/CustomerSummary"},"payment_formats":{"additionalProperties":{"type":"integer"},"type":"object","title":"Payment Formats"},"currencies":{"items":{"type":"string"},"type":"array","title":"Currencies"},"known_laundering_transactions":{"type":"integer","minimum":0.0,"title":"Known Laundering Transactions","default":0},"top_counterparties":{"items":{"$ref":"#/components/schemas/CounterpartySummary"},"type":"array","title":"Top Counterparties"},"alerts":{"items":{"$ref":"#/components/schemas/AlertQueueItem"},"type":"array","title":"Alerts"}},"additionalProperties":false,"type":"object","required":["summary"],"title":"CustomerDetail","description":"One customer profile with counterparties, payment mix, and alerts."},"CustomerSummary":{"properties":{"account_id":{"type":"string","title":"Account Id"},"primary_bank":{"type":"string","title":"Primary Bank"},"outbound_count":{"type":"integer","minimum":0.0,"title":"Outbound Count"},"inbound_count":{"type":"integer","minimum":0.0,"title":"Inbound Count"},"total_sent":{"type":"number","minimum":0.0,"title":"Total Sent"},"total_received":{"type":"number","minimum":0.0,"title":"Total Received"},"max_transaction":{"type":"number","minimum":0.0,"title":"Max Transaction"},"distinct_counterparties":{"type":"integer","minimum":0.0,"title":"Distinct Counterparties"},"first_seen":{"type":"string","title":"First Seen"},"last_seen":{"type":"string","title":"Last Seen"},"alert_count":{"type":"integer","minimum":0.0,"title":"Alert Count"},"open_alert_count":{"type":"integer","minimum":0.0,"title":"Open Alert Count"},"max_risk_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Max Risk Score"},"risk_label":{"type":"string","enum":["unscored","low","medium","high"],"title":"Risk Label"}},"additionalProperties":false,"type":"object","required":["account_id","primary_bank","outbound_count","inbound_count","total_sent","total_received","max_transaction","distinct_counterparties","first_seen","last_seen","alert_count","open_alert_count","risk_label"],"title":"CustomerSummary","description":"Aggregated customer/account activity with current workflow risk."},"DatasetInfo":{"properties":{"dataset_id":{"type":"string","title":"Dataset Id"},"display_name":{"type":"string","title":"Display Name"},"source_file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source File"},"dataset_type":{"type":"string","enum":["primary","knowledge","kyc"],"title":"Dataset Type"},"file_size_bytes":{"type":"integer","minimum":0.0,"title":"File Size Bytes","default":0},"row_count":{"type":"integer","minimum":0.0,"title":"Row Count","default":0},"laundering_count":{"type":"integer","minimum":0.0,"title":"Laundering Count","default":0},"laundering_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Laundering Rate","default":0.0},"date_min":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Min"},"date_max":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Max"},"schema_version":{"type":"string","title":"Schema Version","default":"1.0"},"md5_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Md5 Fingerprint"},"ingested_at":{"type":"string","title":"Ingested At"},"is_active":{"type":"boolean","title":"Is Active","default":false},"notes":{"type":"string","title":"Notes","default":""},"column_map":{"additionalProperties":{"type":"string"},"type":"object","title":"Column Map"},"schema_detected":{"type":"string","title":"Schema Detected","default":""}},"additionalProperties":false,"type":"object","required":["dataset_id","display_name","dataset_type","ingested_at"],"title":"DatasetInfo","description":"Governed metadata for one isolated analytical dataset."},"DatasetSwitchResult":{"properties":{"previous_dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Dataset Id"},"active_dataset_id":{"type":"string","title":"Active Dataset Id"},"row_count":{"type":"integer","minimum":0.0,"title":"Row Count"},"message":{"type":"string","title":"Message"}},"additionalProperties":false,"type":"object","required":["active_dataset_id","row_count","message"],"title":"DatasetSwitchResult"},"DatasetUploadResult":{"properties":{"dataset_id":{"type":"string","title":"Dataset Id"},"display_name":{"type":"string","title":"Display Name"},"row_count":{"type":"integer","minimum":0.0,"title":"Row Count"},"schema_detected":{"type":"string","title":"Schema Detected"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"eda_summary":{"type":"object","title":"Eda Summary"}},"additionalProperties":false,"type":"object","required":["dataset_id","display_name","row_count","schema_detected"],"title":"DatasetUploadResult"},"ExecutionStep":{"properties":{"tool":{"type":"string","title":"Tool"},"status":{"type":"string","enum":["run","skipped"],"title":"Status"},"duration_ms":{"type":"number","minimum":0.0,"title":"Duration Ms","default":0.0},"reason":{"type":"string","title":"Reason"}},"additionalProperties":false,"type":"object","required":["tool","status","reason"],"title":"ExecutionStep","description":"One run/skip entry in the observable execution trace."},"FlaggedEntity":{"properties":{"entity_id":{"type":"string","title":"Entity Id"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score"},"risk_label":{"type":"string","enum":["low","medium","high"],"title":"Risk Label"},"escalation_action":{"type":"string","enum":["monitor","flag_for_review","report"],"title":"Escalation Action"},"rule_flags":{"items":{"type":"string"},"type":"array","title":"Rule Flags"},"rule_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Rule Score","default":0.0},"stat_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Stat Score","default":0.0},"ml_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Ml Score","default":0.0},"saml_d_typology":{"type":"string","title":"Saml D Typology","default":""},"explanation":{"type":"string","title":"Explanation","default":""},"sar_draft":{"type":"string","title":"Sar Draft","default":""},"citation":{"type":"string","title":"Citation","default":""},"risk_contributions":{"anyOf":[{"$ref":"#/components/schemas/RiskContribution"},{"type":"null"}]},"top_transactions":{"items":{"$ref":"#/components/schemas/TransactionEvidence"},"type":"array","title":"Top Transactions"},"txn_count":{"type":"integer","minimum":0.0,"title":"Txn Count","default":0},"total_amount":{"type":"number","minimum":0.0,"title":"Total Amount","default":0.0},"observation_window":{"anyOf":[{"prefixItems":[{"type":"string"},{"type":"string"}],"type":"array","maxItems":2,"minItems":2},{"type":"null"}],"title":"Observation Window"},"distinct_counterparties":{"type":"integer","minimum":0.0,"title":"Distinct Counterparties","default":0}},"additionalProperties":false,"type":"object","required":["entity_id","risk_score","risk_label","escalation_action"],"title":"FlaggedEntity","description":"Stable response contract for a suspicious entity."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IntentFilters":{"properties":{"date_range":{"anyOf":[{"prefixItems":[{"type":"string"},{"type":"string"}],"type":"array","maxItems":2,"minItems":2},{"type":"null"}],"title":"Date Range"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"},"from_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Country"},"payment_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Format"},"min_amount":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Min Amount"},"max_amount":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Max Amount"},"min_count":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Min Count"}},"additionalProperties":false,"type":"object","title":"IntentFilters","description":"Filters extracted from the natural-language query."},"IntentResult":{"properties":{"intent":{"type":"string","enum":["pattern_search","aggregation","entity_lookup","broad_eda"],"title":"Intent"},"pattern_type":{"anyOf":[{"type":"string","enum":["structuring","smurfing","layering","rapid_cashout","behavioural_change","cycle","fan_in","fan_out","single_large","deposit_send","cash_withdrawal","bipartite","gather_scatter","scatter_gather"]},{"type":"null"}],"title":"Pattern Type"},"filters":{"$ref":"#/components/schemas/IntentFilters"},"entities":{"items":{"type":"string"},"type":"array","title":"Entities"},"require_ml":{"type":"boolean","title":"Require Ml","default":false},"require_graph":{"type":"boolean","title":"Require Graph","default":false},"require_eda":{"type":"boolean","title":"Require Eda","default":false}},"additionalProperties":false,"type":"object","required":["intent"],"title":"IntentResult","description":"Validated output from intent extraction."},"InvestigationRecord":{"properties":{"investigation_id":{"type":"string","title":"Investigation Id"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"dataset_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Name"},"query":{"type":"string","title":"Query"},"intent":{"type":"string","title":"Intent"},"pattern_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pattern Type"},"status":{"type":"string","enum":["open","in_review","escalated","closed"],"title":"Status"},"disposition":{"anyOf":[{"type":"string","enum":["pending","true_positive","false_positive","escalated","sar_filed"]},{"type":"null"}],"title":"Disposition","default":"pending"},"flagged_count":{"type":"integer","minimum":0.0,"title":"Flagged Count","default":0},"high_risk_count":{"type":"integer","minimum":0.0,"title":"High Risk Count","default":0},"alert_count":{"type":"integer","minimum":0.0,"title":"Alert Count","default":0},"response":{"$ref":"#/components/schemas/AgentResponse"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["investigation_id","query","intent","status","response","created_at","updated_at"],"title":"InvestigationRecord","description":"Persisted investigation metadata returned by the workflow API."},"InvestigationSummary":{"properties":{"investigation_id":{"type":"string","title":"Investigation Id"},"dataset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"},"dataset_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Name"},"query":{"type":"string","title":"Query"},"intent":{"type":"string","title":"Intent"},"pattern_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pattern Type"},"status":{"type":"string","enum":["open","in_review","escalated","closed"],"title":"Status"},"disposition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disposition"},"flagged_count":{"type":"integer","minimum":0.0,"title":"Flagged Count","default":0},"high_risk_count":{"type":"integer","minimum":0.0,"title":"High Risk Count","default":0},"alert_count":{"type":"integer","minimum":0.0,"title":"Alert Count","default":0},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["investigation_id","query","intent","status","created_at","updated_at"],"title":"InvestigationSummary","description":"Compact investigation list item; detail is loaded on demand."},"PlanResult":{"properties":{"steps":{"items":{"type":"string"},"type":"array","title":"Steps"},"skipped":{"items":{"$ref":"#/components/schemas/SkippedTool"},"type":"array","title":"Skipped"},"reasoning":{"type":"string","title":"Reasoning"}},"additionalProperties":false,"type":"object","required":["steps","reasoning"],"title":"PlanResult","description":"Ordered tool plan produced by the dynamic planner."},"QueryRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"dataset_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Dataset Id"}},"additionalProperties":false,"type":"object","required":["query"],"title":"QueryRequest","description":"FastAPI request body for ``POST /query``."},"QueueAssignmentRequest":{"properties":{"assigned_to":{"type":"string","maxLength":120,"minLength":1,"title":"Assigned To"},"actor":{"type":"string","maxLength":120,"minLength":1,"title":"Actor","default":"demo.analyst"}},"additionalProperties":false,"type":"object","required":["assigned_to"],"title":"QueueAssignmentRequest","description":"Analyst assignment request for one queue item."},"QueueDispositionRequest":{"properties":{"disposition":{"type":"string","enum":["true_positive","false_positive","escalated"],"title":"Disposition"},"actor":{"type":"string","maxLength":120,"minLength":1,"title":"Actor","default":"demo.analyst"}},"additionalProperties":false,"type":"object","required":["disposition"],"title":"QueueDispositionRequest","description":"Controlled disposition transition for one queue item."},"QueueNoteRequest":{"properties":{"note":{"type":"string","maxLength":4000,"minLength":1,"title":"Note"},"actor":{"type":"string","maxLength":120,"minLength":1,"title":"Actor","default":"demo.analyst"}},"additionalProperties":false,"type":"object","required":["note"],"title":"QueueNoteRequest","description":"Append-only analyst note request."},"RiskContribution":{"properties":{"rule_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Rule Score"},"rule_weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Rule Weight"},"rule_contribution":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Rule Contribution"},"stat_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Stat Score"},"stat_weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Stat Weight"},"stat_contribution":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Stat Contribution"},"ml_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Ml Score"},"ml_weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Ml Weight"},"ml_contribution":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Ml Contribution"},"country_boost":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Country Boost"},"active_detector_count":{"type":"integer","minimum":0.0,"title":"Active Detector Count"},"final_risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Final Risk Score"},"formula":{"type":"string","title":"Formula"}},"additionalProperties":false,"type":"object","required":["rule_score","rule_weight","rule_contribution","stat_score","stat_weight","stat_contribution","ml_score","ml_weight","ml_contribution","country_boost","active_detector_count","final_risk_score","formula"],"title":"RiskContribution","description":"Fully reconcilable detector-level risk score breakdown."},"SkippedTool":{"properties":{"tool":{"type":"string","title":"Tool"},"reason":{"type":"string","title":"Reason"}},"additionalProperties":false,"type":"object","required":["tool","reason"],"title":"SkippedTool","description":"A tool omitted from a plan and the policy reason for omitting it."},"SummaryStats":{"properties":{"total_analyzed":{"type":"integer","minimum":0.0,"title":"Total Analyzed","default":0},"flagged":{"type":"integer","minimum":0.0,"title":"Flagged","default":0},"high_risk":{"type":"integer","minimum":0.0,"title":"High Risk","default":0}},"additionalProperties":false,"type":"object","title":"SummaryStats","description":"Query-slice summary returned with every agent response."},"TransactionEvidence":{"properties":{"txn_id":{"type":"string","title":"Txn Id"},"timestamp":{"type":"string","title":"Timestamp"},"amount":{"type":"number","minimum":0.0,"title":"Amount"},"payment_format":{"type":"string","title":"Payment Format","default":""},"to_account":{"type":"string","title":"To Account","default":""},"from_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Country"},"to_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To Country"},"triggered_rules":{"items":{"type":"string"},"type":"array","title":"Triggered Rules"}},"additionalProperties":false,"type":"object","required":["txn_id","timestamp","amount"],"title":"TransactionEvidence","description":"A transaction supporting an entity-level risk decision."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}