feat(mcp): 新增仓库出入库明细与在库物品查询三工具

- warehouse.out.details.list.query / warehouse.in.details.list.query / warehouse.hardstock.list.query
- 出库明细硬过滤 query_flag=0 + order_state=3，入库明细 order_state=3，hardstock 固定 stock_state=0
- dateType 三态 + 缺省最近180天、跨度上限180天；固定排序不提供排序参数
- PermissionService 新增 details 级行权限变体与 HardSockLife 变体（对齐 getWarehouseAuth）
- REQ-20261105-0020

xiaoqu-agent-service/doc/agent-mcp-tools-reference.md

@@ -1105,6 +1105,55 @@
 
 ---
 
+## 46. warehouse.out.details.list.query
+
+出库明细分页查询（m2 `warehouse_out_details`，纯 MySQL），对应老 `/warehouseOutStatis/listByPage`。**只查已完成订单**：硬过滤 `soft_delete=0` + `query_flag=0` + `order_state=3`（王恒 2026-11-05 拍板，不下发 orderState 参数）。固定 `out_date DESC, id DESC`。
+
+- 分类：warehouse ｜ 类型：读
+- 入参（全部可选）：`dateType`（0=出库日期默认 1=创建时间 2=确认出库时间）+ `startDate`/`endDate`
+  （yyyy-MM-dd，缺省最近 180 天，跨度上限 180 天）；`warehouseId`/`warehouseTypeId`/`outOrderNo`/
+  `allocationOrderNo`/`mallOrderNo`/`materialNo`/`pickupOrderNo`/`agentId`/`useCustomerType`/`useCustomerId`
+  （精确）；`snCode`/`materielFullName`/`specifications`/`useCustomerName`/`deliveryOrderNo`/`installOrderNo`
+  （模糊）；`materielIndexIds`（IN）；`page`/`rows` 默认 1/20 上限 100（超出截断 + notice）。
+- 返回 `total/page/rows/[notice]/records`，record 含 id/outOrderNo/warehouseOutId/agentId+agentName/
+  warehouseId+warehouseName/warehouseTypeId+warehouseTypeName/物料四件套/snCode/outCount/price/allMoney/
+  outDate/orderState+orderStateText/applyUserName/outConfirmTime+outConfirmUserName/
+  useCustomerType+useCustomerTypeText/useCustomerName/allocationOrderNo/mallOrderNo/deliveryOrderNo/
+  installOrderNo/pickupOrderNo/createTime。不返回 schedulePeople（拍板）。
+- 行级权限：`applyWarehouseOutDetailsRowFilter`——总部/服务主体全量；代理身份 = 代理范围明细行 OR
+  可见仓库（`warehouse.agent_id/manager_agent_id` 命中）涉及行 OR 本人参与审批（`warehouse_out_audit_process`）主单下行。
+
+## 47. warehouse.in.details.list.query
+
+入库明细分页查询（m2 `warehouse_in_details`，纯 MySQL），对应老 `/warehouseInStatis/listByPage`。**只查已完成订单**：硬过滤 `soft_delete=0` + `order_state=3`（入库明细无 query_flag）。固定 `in_date DESC, id DESC`。
+
+- 分类：warehouse ｜ 类型：读
+- 入参与出库明细对称：`dateType`（0=入库日期默认 1=创建时间 2=确认入库时间）+ 180 天口径；
+  `warehouseId`/`warehouseTypeId`/`inOrderNo`/`allocationOrderNo`/`materialNo`/`agentId`/`installOrderNo`/
+  `pickupOrderNo`/`withdrawOrderNo`（精确）；`snCode`/`materielFullName`/`specifications`/`mallOrderNo`/
+  `outOrderNo`/`lineMemo`（模糊）；`materielIndexIds`（IN）。
+- record 含 id/inOrderNo/warehouseInId/agentId+agentName/warehouseId+warehouseName/warehouseTypeId+warehouseTypeName/
+  物料四件套/snCode/inCount/inDate/orderState+orderStateText/goodInState+goodInStateText（0入库中 1已入库 2已出库 3已撤销）/
+  applyUserName/inConfirmTime+inConfirmUserName/allocationOrderNo/mallOrderNo/outOrderNo/deliveryOrderNo/
+  installOrderNo/pickupOrderNo/withdrawOrderNo/memo/lineMemo/createTime。
+- 行级权限：`applyWarehouseInDetailsRowFilter`，与出库明细同口径（audit 表换 `warehouse_in_audit_process`）。
+
+## 48. warehouse.hardstock.list.query
+
+库存物品详情分页查询（m0 视图 `hard_sock_life`，纯 MySQL），对应老 `/warehouseHardStock/listByPage`。**固定只查在库**：硬过滤 `soft_delete=0` + `stock_state=0`（王恒拍板，不留参数）。固定 `id DESC`。
+
+- 分类：warehouse ｜ 类型：读
+- 入参（全部可选）：`agentId`/`assetOwnerId`（精确）；`warehouseIds`/`materielIndexIds`（IN）；
+  `materialNo`/`materielFullName`/`specifications`/`snCode`（模糊）；`page`/`rows` 默认 1/20 上限 100。
+- record 含 id/snCode/lifeSnCode（组装后设备编号）/agentId+agentName/warehouseId+warehouseName/
+  warehouseOwnerId+warehouseOwnerName/assetOwnerId+assetOwnerName/物料四件套/stockState+stockStateText/
+  currentInventory/assembleState+assembleStateText/chargeFlag+chargeFlagText/replaceState+replaceStateText/
+  useCustomerType+useCustomerTypeText/useCustomerName/outInOrderNo/outInDate/createTime。
+- 行级权限：`applyHardSockLifeRowFilter`，1:1 对齐老 `WrapperUtils.getWarehouseAuth`
+  （`agent_id`/`warehouse_owner_id` IN 自己+授权代管，与 warehouse.stock.list.query 同语义）。
+
+三个工具详细设计见 [warehouse-details-stock-mcp-design](warehouse-details-stock-mcp-design.md)。
+
 ---
 
 ## 附录：在线查看工具清单