1.0 KiB
1.0 KiB
Brief: single-react-mysql-readonly-tool
Background
阶段 3A 提供了统一 ToolBoundary 和 canonical invocation store，阶段 3B 提供了 RAG/日志投影。3C 需要独立实现安全敏感的只读 MySQL Tool，避免 Agent 生成的 SQL 直接进入数据库。
Goals
- 使用 JSqlParser 对保守 SELECT 子集进行 fail-closed AST 校验。
- 使用逻辑数据源和 schema/table/column 精确 allowlist 授权。
- 使用参数绑定、只读 JDBC、超时、取消和结果预算。
- 通过阶段 3A boundary 投影为冻结的
MysqlToolResult。 - 清理查询脚本的写入分支和默认连接风险。
Non-goals
- 不接入公开 Agent/Chat 入口。
- 不提供元数据发现、动态授权、租户/行级权限或生产 datasource provisioning。
- 不查询 Agent 自身持久化数据库。
Classification
- Scale: complex
- Interface impact: L2 internal Harness tool/adapter, plus build dependency and script safety behavior
- Issue: ISS-014 stage 3C
- Change slug:
single-react-mysql-readonly-tool