MCP 服务器

Plumbline — a trust layer for LLM answers

com.lattice-sys.plumbline/mcp

此 MCP 可以做什么

Queries verified workforce and payroll facts, grounds answers in SQL and evidence, checks answer provenance, and reports trust verdicts and compliance metadata.

ask_prepare
BYO: Prepare Grounded Prompt
BYO step 1 of 2: run the server-side trust plane for a business question (plan, SQL-verified facts, evidence retrieval, answerability gate, prompt composition) and return the composed prompt plus a single-use prepare_key (a signed handoff token; echo it back VERBATIM and in full, or use the short ask_id alias; in prose always say the ask_id, never the token). Read-only: prepare holds no server state and is safe to run without confirmation — the receipt is minted only at ask_submit_draft. Pass the user's question VERBATIM: do not expand, narrow, or reword it — the server plans coverage itself, and an unrequested rewrite misleads the user about what was asked. If you must revise it (e.g. to fold in essential conversation context), you MUST also pass the user's exact wording in original_question so the panel can disclose the revision. YOU (the connected model) then write the draft answer from that prompt and submit it with ask_submit_draft — generation happens on your side, so no LLM credential ever reaches this server. An unanswerable question still receives a prompt for reference; its draft is force-refused at submit and can never earn a verified verdict. Only a policy refusal stops at prepare. Recommended drafting path on this deployment.
只读
输入模式
{'type': 'object', 'required': ['question'], 'properties': {'history': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'optional prior conversation turns (role user|assistant) to thread into the composed prompt for follow-up questions'}, 'question': {'type': 'string', 'description': "the business question to ground, in the USER'S OWN WORDS, verbatim; do not expand, narrow, or reword it â\x80\x94 the server plans coverage itself. The server plans, computes SQL facts, retrieves evidence, gates answerability, and composes the prompt YOU should answer from"}, 'original_question': {'type': 'string', 'description': "REQUIRED IF question is not the user's exact wording: the user's original question, verbatim, so the panel can display your revision as a revision. Omit when question is verbatim"}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'ask_id': {'type': 'string'}, 'refusal': {'type': ['null', 'object'], 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'messages': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'question': {'type': 'string'}, 'session_id': {'type': 'string'}, 'prepare_key': {'type': 'string'}, 'instructions': {'type': 'string'}, 'max_output_tokens': {'type': 'integer'}, 'original_question': {'type': 'string'}, 'expires_in_seconds': {'type': 'integer'}}, 'additionalProperties': False}
ask_result
BYO: Fetch Published Verdict
Fetch the published verdict for an ask_prepare session (status: pending, published, or unknown). This is the app panel's polling surface, so the verified answer renders inside the panel that prepared the question. As the connected model you normally never need it: write your draft and call ask_submit_draft. Exception: if you are asked to submit for a session whose composed prompt is no longer in your context, call this with include_prompt true to receive that session's exact prompt again, then draft and submit.
只读
输入模式
{'type': 'object', 'required': ['prepare_key'], 'properties': {'prepare_key': {'type': 'string', 'description': 'the session_id value returned by the prepare tool'}, 'include_prompt': {'type': 'boolean', 'description': "set true to receive the pending session's composed prompt messages again, e.g. when the ask_prepare result is no longer in your context; the same caller already received this prompt at prepare time"}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['status'], 'properties': {'result': {'type': ['null', 'object'], 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'permalink_url': {'type': 'string', 'description': 'Public URL of the full evidence receipt for this answer.'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'status': {'type': 'string'}, 'pending': {'type': 'boolean'}, 'messages': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'override': {'type': 'string'}, 'instructions': {'type': 'string'}, 'decline_reason': {'type': 'string'}, 'max_output_tokens': {'type': 'integer'}, 'expires_in_seconds': {'type': 'integer'}}, 'additionalProperties': False}
ask_submit_draft
BYO: Verify Client Draft
BYO step 2 of 2: verify the draft you wrote for an ask_prepare prompt. The server runs the SAME post-answer guards the strict path uses (facts presence, tagged claims, concept binding, earner-name grounding) against its own SQL facts and publishes the trust envelope; a draft that fails any guard is refused. Pass the prepare_key token back VERBATIM and in full. Handoffs are single-use per verdict and expire.
只读 幂等
输入模式
{'type': 'object', 'required': ['prepare_key'], 'properties': {'model': {'type': 'string', 'description': 'optional: the model that wrote the draft, recorded in the trace'}, 'raw_answer': {'type': 'string', 'description': "your COMPLETE raw draft answer to the composed prompt (including any structured answer/claims JSON the prompt's contract asked for). Omit ONLY when you are declining, in which case decline_reason is required"}, 'prepare_key': {'type': 'string', 'description': 'the session_id value returned by the prepare tool'}, 'decline_reason': {'type': 'string', 'description': 'use INSTEAD of raw_answer when you are choosing not to submit a draft: state plainly why, in one or two sentences addressed to the user. The reason is shown to them in the panel, the handoff stays open for them to override, and nothing is verified or published'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'permalink_url': {'type': 'string', 'description': 'Public URL of the full evidence receipt for this answer.'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
compare_departments
Compare Departments (Verified)
Compare two departments by headcount and compensation. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.
只读
输入模式
{'type': 'object', 'required': ['a', 'b'], 'properties': {'a': {'type': 'string', 'description': 'the first department'}, 'b': {'type': 'string', 'description': 'the second department'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
cross_check
Cross-Check a Figure
Corroborate a figure you obtained (e.g. from run_sql) against the verified fact store: it re-derives the named value_key from the same SQL the verified pipeline uses and compares. AGREE lifts an otherwise-unverified session to 'corroborated'; DISAGREE marks a CONFLICT (worse than unverified). This is the only way a raw figure earns trust back, and it can only ever agree with a number the fact store itself computed. Resolvable keys cover the single-snapshot fact concepts plus temporal and per-department growth keys (e.g. indexed_people.<dept>); per-question keys (a named department's median, one person's direct-report count) return unmapped.
只读
输入模式
{'type': 'object', 'required': ['value_key', 'value'], 'properties': {'value': {'type': 'string', 'description': 'the figure you obtained (e.g. from run_sql) to corroborate against the verified fact store'}, 'value_key': {'type': 'string', 'description': 'the claimable fact key naming the verified concept to re-derive, e.g. people, indexed_active_people, median_income_cents, or a per-department growth key like indexed_people.engineering (the keys a verified answer exposes as CLAIMABLE FACT KEYS)'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}
describe_fact_capabilities
Discover Fact Capabilities
List safe metadata for the registered fact queries available on the server-pinned dataset: IDs, labels, parameters, and result shapes, never SQL. Use this when a question appears relevant but a selected route produced no facts; a route miss is not evidence that the underlying records are absent.
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['contract_version', 'snapshot_id', 'queries', 'guidance'], 'properties': {'queries': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'version', 'label', 'result_schema'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'version': {'type': 'string'}, 'parameters': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'value': True, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}, 'server_owned': {'type': 'boolean'}}, 'additionalProperties': False}}, 'result_schema': {'type': 'string'}}, 'additionalProperties': False}}, 'guidance': {'type': 'string'}, 'snapshot_id': {'type': 'integer'}, 'contract_version': {'type': 'string'}, 'dataset_namespace': {'type': 'string'}}, 'additionalProperties': False}
find_payroll_anomalies
Payroll Anomalies (Verified)
Surface payroll and deduction anomalies in the latest snapshot. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_ai_act_transparency
EU AI Act Transparency Descriptor
Return the Art. 13 transparency descriptor: intended purpose, capabilities, limitations, human oversight, logging mechanism, and article mapping.
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['system_name', 'provider_identity', 'intended_purpose', 'capabilities', 'limitations', 'accuracy_posture', 'human_oversight', 'logging_mechanism', 'article_13_mapping', 'retention', 'operator_configured'], 'properties': {'retention': {'type': 'object', 'required': ['minimum_months', 'policy', 'exportable'], 'properties': {'policy': {'type': 'string'}, 'exportable': {'type': 'boolean'}, 'minimum_months': {'type': 'integer'}}, 'additionalProperties': False}, 'limitations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'system_name': {'type': 'string'}, 'capabilities': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'human_oversight': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'accuracy_posture': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'intended_purpose': {'type': 'string'}, 'logging_mechanism': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'provider_identity': {'type': 'string'}, 'article_13_mapping': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['article', 'tag', 'applies_to', 'requirement'], 'properties': {'tag': {'type': 'string'}, 'article': {'type': 'string'}, 'rationale': {'type': 'string'}, 'applies_to': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'requirement': {'type': 'string'}}, 'additionalProperties': False}}, 'operator_configured': {'type': 'boolean'}}, 'additionalProperties': False}
get_answer_queries
Show the SQL Behind an Answer
Show the SQL behind one answer you already received, addressed by its correlation_id. Returns only the recorded fact queries (id, version, label, SQL, parameters, result schema, dataset version) for that answer: no rows, no evidence text, no answer text, no envelope, and no way to list the catalog. Recorded SQL has its arguments inlined as literals, so a query that filters on a specific value discloses that value; the built-in workforce queries inline only snapshot ids. Requires the persisted compliance log and the same session that produced the answer. Absent from the no-auth public demo.
只读
输入模式
{'type': 'object', 'required': ['correlation_id'], 'properties': {'correlation_id': {'type': 'string', 'description': 'the correlation_id published on the answer whose queries you want to see; obtained from that answer, never guessed'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['correlation_id', 'snapshot_id', 'queries'], 'properties': {'queries': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'sql'], 'properties': {'sql': {'type': 'string'}, 'label': {'type': 'string'}, 'version': {'type': 'string'}, 'query_id': {'type': 'string'}, 'parameters': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'value': True, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}, 'server_owned': {'type': 'boolean'}}, 'additionalProperties': False}}, 'editable_sql': {'type': 'string'}, 'editable_note': {'type': 'string'}, 'result_schema': {'type': 'string'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'correlation_id': {'type': 'string'}}, 'additionalProperties': False}
get_evidence_document
Show an Evidence Document Behind an Answer
Show ONE retrieved evidence document behind an answer you already received, addressed by that answer's correlation_id plus a document_id from its evidence_documents references. Returns the full stored document (title, body, metadata, embedding_text) with the retrieval rank and scores the answer recorded; never the raw embedding vector. Only documents the addressed answer actually recorded resolve: there is no fetch-by-id in general and no way to browse the store. Requires the persisted compliance log and the same session that produced the answer. Absent from the no-auth public demo.
只读
输入模式
{'type': 'object', 'required': ['correlation_id', 'document_id'], 'properties': {'document_id': {'type': 'integer', 'description': "the document_id of one entry in that answer's evidence_documents references"}, 'correlation_id': {'type': 'string', 'description': 'the correlation_id published on the answer whose evidence you want to inspect; obtained from that answer, never guessed'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['correlation_id', 'document'], 'properties': {'note': {'type': 'string'}, 'document': {'type': 'object', 'required': ['document_id', 'snapshot_id', 'source_type', 'title', 'body', 'rank', 'score'], 'properties': {'body': {'type': 'string'}, 'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': True}, 'overlaps': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}, 'embedding_text': {'type': 'string'}}, 'additionalProperties': False}, 'correlation_id': {'type': 'string'}}, 'additionalProperties': False}
get_manager_chain
Manager & Reporting Chain (Verified)
Return the management/reporting chain for an employee. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.
只读
输入模式
{'type': 'object', 'required': ['employee'], 'properties': {'employee': {'type': 'string', 'description': 'the employee whose management chain to return'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
query_fact
Run Registered Fact Query
Execute a registered, versioned read-only fact query against the server-pinned dataset. Provide query_id and version only: SQL is approved by the domain pack, never caller-supplied. Returns normalized rows plus a reproducible trust receipt containing the dataset and query versions.
只读
输入模式
{'type': 'object', 'required': ['query_id', 'version'], 'properties': {'version': {'type': 'string', 'description': 'immutable registered query version'}, 'query_id': {'type': 'string', 'description': 'registered fact-query id; SQL is resolved by the server and must not be supplied here'}, 'parameters': {'type': 'object', 'description': 'optional typed values for parameters declared by the registered query', 'additionalProperties': True}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}
run_code
Run Sandboxed JavaScript (Unverified)
Run YOUR OWN JavaScript in the in-tenant coderunner sandbox with the read-only, snapshot-scoped plumb.query() SDK. No filesystem, environment, or general network access. Read plumbline://sandbox-api.d.ts before writing code. The raw-SQL server opt-in is enabled, but results still bypass the trust path and are UNVERIFIED. Returns stdout/stderr plus metadata-only host-call trace evidence.
只读
输入模式
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': "JavaScript source to execute in the in-tenant coderunner sandbox. No filesystem, environment, or general network access. When the server explicitly enables raw SQL and uses the local grant-capable runner, a read-only snapshot-scoped SDK is preloaded as global 'plumb' and plumbline://sandbox-api.d.ts is listed; otherwise the sandbox is airtight and plumb is undefined. console.log output is returned as stdout."}, 'concepts': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'optional: the fact concepts this code computes, as claimable fact keys (e.g. median_income_cents) or free-form names. The server reports per concept whether a registered seed exists (cross_check can corroborate figures) or not (cross_check will return unmapped: the verified store can never corroborate them).'}, 'acknowledge_unverified': {'type': 'boolean', 'description': 'set true to confirm you understand results BYPASS the trust plane and are UNVERIFIED, and that you will label them so to the user. On deployments with the acknowledgment gate the FIRST raw call of a session is refused without it; one acknowledgment covers the rest of the session.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}
run_sql
Run Read-Only SQL (Unverified)
Run YOUR OWN single read-only SELECT/WITH over the virtual snapshot_* relations. The query is statically verified against an allowlist, rewritten to the active snapshot, and run read-only. This BYPASSES the planner, grounding gate, and answer-facts reconciliation, so results are UNVERIFIED and labelled as such. Deployments may refuse the FIRST raw call of a session pending acknowledge_unverified: true (the refusal says how to proceed). Optionally declare `concepts` to learn which figures the fact store could corroborate via cross_check.
只读
输入模式
{'type': 'object', 'required': ['sql'], 'properties': {'sql': {'type': 'string', 'description': 'a single read-only SELECT/WITH over the VIRTUAL snapshot_* relations (e.g. snapshot_employees, snapshot_pay_statements, snapshot_departments). Bare physical table names are rejected. Discover the columns first with introspect_schema.'}, 'concepts': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'optional: the fact concepts this query computes, as claimable fact keys (e.g. median_income_cents) or free-form names. The server reports per concept whether a registered seed exists (cross_check can corroborate figures) or not (cross_check will return unmapped: the verified store can never corroborate them).'}, 'acknowledge_unverified': {'type': 'boolean', 'description': 'set true to confirm you understand results BYPASS the trust plane and are UNVERIFIED, and that you will label them so to the user. On deployments with the acknowledgment gate the FIRST raw call of a session is refused without it; one acknowledgment covers the rest of the session.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}
search_docs
Search Plumbline Docs
Search Plumbline's own product and architecture documentation (how the verification, refusal, and trust layer itself works). Returns ranked, citable doc passages; does NOT touch employment data, and returns an empty result set honestly when nothing matches.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'max passages to return (default 5, capped at 10)'}, 'query': {'type': 'string', 'description': 'a how-does-this-work question about Plumbline itself, e.g. the verification gate, snapshots and temporal drift, or the cross-provider corpus'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['query', 'hits'], 'properties': {'hits': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['source', 'title', 'heading', 'excerpt', 'score'], 'properties': {'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source': {'type': 'string'}, 'excerpt': {'type': 'string'}, 'heading': {'type': 'string'}}, 'additionalProperties': False}}, 'note': {'type': 'string'}, 'query': {'type': 'string'}}, 'additionalProperties': False}
search_employee
Search Employee (Verified)
Search the employment fact store for a person and return a grounded, verified answer. NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'the employee name or search terms'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
summarize_benefits
Benefits Summary (Verified)
Summarize benefit enrollments, optionally scoped (e.g. a department or plan). NOTE: internal drafting is disabled on this deployment. If your client supports MCP sampling, this tool asks YOUR model to draft in the same call (verified server-side); otherwise it returns an explicit refusal, and you should use ask_prepare then ask_submit_draft to draft with your own model.
只读
输入模式
{'type': 'object', 'properties': {'scope': {'type': 'string', 'description': 'optional scope such as a department or benefit plan'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['answer'], 'properties': {'answer': {'type': 'string'}, 'claims': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value', 'tier'], 'properties': {'key': {'type': 'string'}, 'tier': {'type': 'string'}, 'value': {'type': 'string'}, 'result': {'type': ['null', 'object'], 'required': ['set_key', 'row'], 'properties': {'row': {'type': 'integer'}, 'column': {'type': 'string'}, 'set_key': {'type': 'string'}, 'query_id': {'type': 'string'}}, 'additionalProperties': False}, 'derived': {'type': 'boolean'}, 'expected': {'type': 'string'}}, 'additionalProperties': False}}, 'refused': {'type': 'boolean'}, 'coverage': {'type': ['null', 'object'], 'required': ['status'], 'properties': {'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'source_counts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'content_grounding': {'type': 'string'}, 'required_evidence': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'matched_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_source_types': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'question': {'type': 'string'}, 'recovery': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}, 'reason': {'type': 'string'}, 'restart': {'type': 'boolean'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}}, 'answer_id': {'type': 'string'}, 'grounding': {'type': ['null', 'object'], 'required': ['answerable'], 'properties': {'reason': {'type': 'string'}, 'answerable': {'type': 'boolean'}, 'best_vector': {'type': 'number'}, 'lexical_rank': {'type': 'number'}, 'route_family': {'type': 'string'}, 'vector_floor': {'type': 'number'}, 'facts_present': {'type': 'boolean'}, 'lexical_matches': {'type': 'integer'}, 'route_confident': {'type': 'boolean'}, 'route_similarity': {'type': 'number'}, 'lexical_rank_floor': {'type': 'number'}, 'generated_results_present': {'type': 'boolean'}}, 'additionalProperties': False}, 'confidence': {'type': ['null', 'object'], 'required': ['quantitative_claims', 'store_verified'], 'properties': {'derived': {'type': 'integer'}, 'conflicts': {'type': 'integer'}, 'corroborated': {'type': 'integer'}, 'weakest_tier': {'type': 'string'}, 'route_headroom': {'type': ['null', 'number']}, 'store_verified': {'type': 'integer'}, 'quantitative_claims': {'type': 'integer'}}, 'additionalProperties': False}, 'data_as_of': {'type': 'string'}, 'drafted_by': {'type': 'string'}, 'facts_used': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['value_key', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'source': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}, 'query_id': {'type': 'string'}, 'authority': {'type': 'string'}, 'value_key': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'effective_at': {'type': ['null', 'string']}, 'derivation_id': {'type': 'string'}, 'source_references': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'kind'], 'properties': {'id': {'type': 'string'}, 'uri': {'type': 'string'}, 'kind': {'type': 'string'}, 'provider': {'type': 'string'}, 'external_id': {'type': 'string'}, 'observed_at': {'type': ['null', 'string']}, 'content_hash': {'type': 'string'}}, 'additionalProperties': False}}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified': {'type': 'boolean'}, 'attribution': {'type': ['null', 'object'], 'required': ['method', 'note'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'in_prompt'], 'properties': {'spans': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'start': {'type': 'integer'}, 'figure': {'type': 'boolean'}}, 'additionalProperties': False}}, 'figures': {'type': 'integer'}, 'in_prompt': {'type': 'boolean'}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'document_id': {'type': 'integer'}}, 'additionalProperties': False}}, 'sentences': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['index', 'start', 'end', 'text'], 'properties': {'end': {'type': 'integer'}, 'text': {'type': 'string'}, 'index': {'type': 'integer'}, 'start': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'disclosures': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'headline'], 'properties': {'kind': {'type': 'string'}, 'detail': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'headline': {'type': 'string'}}, 'additionalProperties': False}}, 'result_sets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'columns', 'rows'], 'properties': {'key': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': ['null', 'array'], 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'quantity': {'type': ['null', 'object'], 'required': ['value', 'unit'], 'properties': {'unit': {'type': 'string'}, 'scale': {'type': 'integer'}, 'value': {'type': 'string'}, 'asset_id': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'label': {'type': 'string'}, 'columns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'query_id': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'dataset_version_id': {'type': 'string'}}, 'additionalProperties': False}}, 'snapshot_id': {'type': 'integer'}, 'snapshot_name': {'type': 'string'}, 'stage_timings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['stage', 'ms'], 'properties': {'ms': {'type': 'integer'}, 'stage': {'type': 'string'}}, 'additionalProperties': False}}, 'correlation_id': {'type': 'string'}, 'figure_origins': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['figure', 'origin'], 'properties': {'figure': {'type': 'string'}, 'origin': {'type': 'string'}, 'snippet': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'document_title': {'type': 'string'}}, 'additionalProperties': False}}, 'reconciliation': {'type': ['null', 'object'], 'required': ['conflict'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'derived': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['claim', 'operator', 'left', 'right', 'exact'], 'properties': {'key': {'type': 'string'}, 'left': {'type': 'string'}, 'claim': {'type': 'string'}, 'exact': {'type': 'string'}, 'right': {'type': 'string'}, 'operands': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'operator': {'type': 'string'}}, 'additionalProperties': False}}, 'details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'conflict': {'type': 'boolean'}, 'answer_details': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'claim_mismatches': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['key', 'declared', 'expected'], 'properties': {'key': {'type': 'string'}, 'declared': {'type': 'integer'}, 'expected': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'refusal_reason': {'type': 'string'}, 'composed_prompt': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['role', 'content'], 'properties': {'role': {'type': 'string'}, 'content': {'type': 'string'}}, 'additionalProperties': False}}, 'drafted_by_source': {'type': 'string'}, 'evidence_documents': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['document_id', 'rank', 'score'], 'properties': {'rank': {'type': 'integer'}, 'score': {'type': 'number'}, 'title': {'type': 'string'}, 'source_id': {'type': 'string'}, 'text_score': {'type': 'number'}, 'document_id': {'type': 'integer'}, 'snapshot_id': {'type': 'integer'}, 'source_type': {'type': 'string'}, 'vector_score': {'type': 'number'}}, 'additionalProperties': False}}, 'model_observations': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggested_questions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['intent', 'label', 'question'], 'properties': {'label': {'type': 'string'}, 'intent': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'unverified_disclaimer': {'type': 'string'}, 'model_reported_evidence': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['evidence_id', 'use'], 'properties': {'use': {'type': 'string'}, 'document_id': {'type': 'integer'}, 'evidence_id': {'type': 'string'}, 'answer_sentence_indexes': {'type': ['null', 'array'], 'items': {'type': 'integer'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
trust_finalize
Finalize Trust Verdict
Return the session's graded trust verdict: the tier (verified / registered-query / generated-sql / corroborated / unverified / conflict / refused), which trusted steps were skipped across the session, the deterministic confidence (k of n figures store-verified, weakest figure tier, conflicts), the per-figure provenance, the per-call ledger, and the at-your-own-risk disclaimer.
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['prompto'], 'properties': {'value': {}, 'prompto': {'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}
已添加
trust_finalize
2026年9月17日 12:35
已添加
summarize_benefits
2026年9月17日 12:35
已添加
search_employee
2026年9月17日 12:35
已添加
search_docs
2026年9月17日 12:35
已添加
run_sql
2026年9月17日 12:35
已添加
run_code
2026年9月17日 12:35
已添加
query_fact
2026年9月17日 12:35
已添加
get_manager_chain
2026年9月17日 12:35
已添加
get_evidence_document
2026年9月17日 12:35
已添加
get_answer_queries
2026年9月17日 12:35
已添加
get_ai_act_transparency
2026年9月17日 12:35
已添加
find_payroll_anomalies
2026年9月17日 12:35
已添加
describe_fact_capabilities
2026年9月17日 12:35
已添加
cross_check
2026年9月17日 12:35
已添加
compare_departments
2026年9月17日 12:35
已添加
ask_submit_draft
2026年9月17日 12:35
已添加
ask_result
2026年9月17日 12:35
已添加
ask_prepare
2026年9月17日 12:35