class DeleteHeadhaulDocumentTool:
    name = 'delete_headhaul_document'
    route_path = '/mcp/tools/deleteHeadhaulDocument'

    def __init__(self, api_client=None):
        self.api_client = api_client

    def metadata(self):
        return {
            'name': self.name,
            'description': (
                '使用场景：用户要删除一份已经查到的头程文档时，必须使用查询返回的'
                'document_ref。一次只删一份，硬删文档行、关联行和OSS对象。'
                '禁止使用：按文件名或单号盲删、批量删除、行内编辑改成删除。'
                '参数只用于工具内部调用；最终回答只能展示中文业务名称。'
            ),
            'input_schema': {
                'type': 'object',
                'properties': {
                    'document_ref': {
                        'type': 'string',
                        'minLength': 1,
                        'maxLength': 500,
                        'description': '查询返回的文档身份，不能手填内部ID。',
                    },
                },
                'required': ['document_ref'],
                'additionalProperties': False,
            },
        }

    def call(
        self,
        document_ref,
        request_id='rq_delete_headhaul_document',
    ):
        if self.api_client is None:
            raise RuntimeError(
                'api client is required for delete_headhaul_document'
            )
        reference = str(document_ref or '').strip()
        if not reference or len(reference) > 500:
            raise ValueError('document_ref is invalid')
        return self.api_client.call_tool(
            self.name,
            self.route_path,
            {'document_ref': reference},
            request_id,
        )