工具箱 (0.1.3)

建一个空工具箱。metadata_type 决定这个箱子装哪类工具，建成后不可更改 （编辑接口的 metadata_type 是可选的，传了才校验）。

openapi 类型的箱子必须给 box_svc_url——箱内工具的请求都发往这个地址。

按业务域分页列出工具箱。metadata_type 过滤用于「函数工具工作台只列函数 工具箱」这类场景。

条目里的 tools 是工具名字符串数组，不是工具对象也不是 ID——要工具详情 得再调 GET /tool-box/{box_id}/tools/list。

与 /operator/names、/skills/names 同契约：不存在的 ID 静默略过、不占位， 调用方自己比对哪些没回来。

取工具箱详情，含箱内工具的完整定义。

更新走 POST 不是 PUT。box_name / box_desc / box_category 都是必填 ——这是整体覆盖，不是部分更新，不传就报必填错误。

metadata_type 反而是可选的：工具箱建成后类型不会变，带了才校验取值。

响应里的 edit_tools 列出因本次更新而受影响的工具及其新状态。

删除工具箱及其下全部工具。已被 Agent 挂载的工具箱删除后调用方会拿到 404。

发布 / 下架工具箱。工具箱只有三个状态（unpublish / published / offline），没有算子那边的 editing。

往箱子里加工具。metadata_type 决定必填字段：function 走 function_input（代码约定见 function.yaml，入口函数必须叫 handler），openapi 走 data（OpenAPI 原文）。

一次可以建出多个工具：一份 OpenAPI 文档里有几个操作就建几个工具， 所以响应是 success_count / failure_count 的批量结果，部分成功是常态 ——failure_count 非 0 时接口仍返回 200，失败明细在 failures 里。

取单个工具的完整定义，含元数据、全局参数与使用规则。

更新走 POST 不是 PUT。 name、description、metadata_type 都是必填 ——整体覆盖，不是部分更新。

列出工具箱里的工具。

**响应的数据字段叫 tools 不是 data**，还多一个 box_id——与本服务其他 分页接口（含同模块的 /tool-box/market/tools）不一致，解析时注意。

排序字段这里可选 create_time / update_time / tool_name，默认 create_time（工具箱列表默认的是 update_time）。

按 ID 批量删除工具箱里的工具。

请求体是数组，一次改多个工具的启停。工具的状态只有 enabled / disabled 两个值——与工具箱的发布状态是两套，别混。

禁用的工具不会出现在 Agent 可用的工具列表里，但仍留在箱子中。

用给定参数真实调用一次工具。与 /proxy/{tool_id} 的差别只在语义与审计 ——调试面向开发期，代理面向生产调用。请求与响应结构一致。

参数按 HTTP 的四个位置分开传：header / query / path / body。

生产调用入口：由平台代为执行工具并返回结果，调用方不必知道工具背后打的是 哪个地址。与调试接口的差别在于会走权限校验与审计日志。

返回的是被调服务的原始响应（status_code / headers / body）， 不是平台自己的信封——上游返 500 时本接口仍是 200，status_code 里才是 500。

拿一个已注册的算子，在指定工具箱里生成对应的工具。算子与工具之间保留血缘， 算子更新后工具可随之更新。

路径挂在 /operator/ 下但归工具箱模块管——它产出的是工具。

「能力包」注册：给一份 OpenAPI 3.0 文档，一次性把里面每个操作注册成算子， 再转换成工具放进工具箱，两者血缘打通。省掉逐个注册再逐个转换。

box_id 与 box_name 二选一：给 box_id 就往已有箱子里加， 给 box_name 就新建一个箱子。

部分失败是常态：接口返回 200，failure_count 与 failures 说明哪些 操作没建成。links 给出算子与工具的对应关系。

已发布工具箱的列表。过滤条件比工作区列表少了 status 与 metadata_type。

跨工具箱按名称搜工具。

tool_name 是必填的——不传直接 400 （AgentOperatorIntegration.BadRequest.ValidationRequired）。这不是「列出 全部市场工具」的接口，是「按名字找工具」。

响应的数据字段是 data（与同模块 /tool-box/{box_id}/tools/list 的 tools 不同）。

市场视角的工具箱详情，结构与 GET /tool-box/{box_id} 一致。

与 MCP 的 /mcp/market/batch/{mcp_ids}/{fields} 同一套路子：两个参数都走 路径、都是逗号分隔。注意这里的路径段名叫 box_id，但接受的是 ID 列表（服务端字段就叫 BoxIDs）。

响应是按 fields 投影后的对象数组，未选中的字段不出现。