Agent/cyber_agent/tools/builtin/__init__.py

"""
内置基础工具 - 参考 opencode 实现

这些工具参考 vendor/opencode/packages/opencode/src/tool/ 的设计，
在 Python 中重新实现核心功能。

参考版本：opencode main branch (2025-01)
"""

from cyber_agent.tools.builtin.file.read import read_file
from cyber_agent.tools.builtin.file.read_images import read_images
from cyber_agent.tools.builtin.file.edit import edit_file
from cyber_agent.tools.builtin.file.write import write_file
from cyber_agent.tools.builtin.glob_tool import glob_files
from cyber_agent.tools.builtin.file.grep import grep_content
from cyber_agent.tools.builtin.bash import bash_command
from cyber_agent.tools.builtin.skill import skill, list_skills
from cyber_agent.tools.builtin.subagent import agent, evaluate
from cyber_agent.tools.builtin.task_protocol import (
    review_task_result,
    submit_task_report,
    update_task_progress,
)
# sandbox 工具已废弃（2026-04）；search.py / crawler.py 已重构为 content/ 工具族（2026-04）
from cyber_agent.tools.builtin.knowledge import(knowledge_search,knowledge_save,knowledge_save_pending,knowledge_list,knowledge_update,knowledge_batch_update,knowledge_slim)
# Memory / Dream（见 cyber_agent/docs/framework/runtime/memory.md）
from cyber_agent.tools.builtin.memory import dream
# 知识上传/查询已统一到 agent 工具：
#   agent(agent_type="remote_librarian", task=...)         # 查询
#   agent(agent_type="remote_librarian_ingest", task=...)  # 上传（异步）
#   agent(agent_type="remote_research", task=...)          # 深度调研
from cyber_agent.tools.builtin.context import get_current_context, read_context_ref
from cyber_agent.tools.builtin.candidate import manage_candidate
from cyber_agent.tools.builtin.toolhub import toolhub_health, toolhub_search, toolhub_call
from cyber_agent.tools.builtin.resource import resource_list_tools, resource_get_tool
from cyber_agent.tools.builtin.content import (
    content_platforms, content_search, content_detail, content_suggest,
    extract_video_clip, import_content,
)
from cyber_agent.trace.goal_tool import goal
# 导入浏览器工具以触发注册 (因 P1 流水线不需要，且加载缓慢，暂时全局屏蔽)
# import cyber_agent.tools.builtin.browser  # noqa: F401

import cyber_agent.tools.builtin.feishu
import cyber_agent.tools.builtin.im

__all__ = [
    # 文件操作
    "read_file",
    "read_images",
    "edit_file",
    "write_file",
    "glob_files",
    "grep_content",
    # 系统工具
    "bash_command",
    "skill",
    # 知识管理：统一通过 agent(agent_type="remote_librarian" / "remote_librarian_ingest" / "remote_research")
    # 知识管理（旧架构 - 直接 HTTP API，仅供 Knowledge Manager 内部使用）
    # "knowledge_search",
    # "knowledge_save",
    # "knowledge_list",
    # "knowledge_update",
    # "knowledge_batch_update",
    # "knowledge_slim",
    "list_skills",
    "agent",
    "evaluate",
    "submit_task_report",
    "review_task_result",
    "update_task_progress",
    "manage_candidate",
    # 内容工具族（重构自 search.py + crawler.py）
    "content_platforms",
    "content_search",
    "content_detail",
    "content_suggest",
    # 上下文工具
    "get_current_context",
    "read_context_ref",
    # ToolHub 远程工具库
    "toolhub_health",
    "toolhub_search",
    "toolhub_call",
    # image_uploader / image_downloader 已内化到 toolhub_call 的图片管线中，不再单独暴露
    # 资源查询
    "resource_list_tools",
    "resource_get_tool",
    # 媒体 / 导入
    "extract_video_clip",
    "import_content",
    # Goal 管理
    "goal",
    # Memory & Knowledge 提取审核
    "knowledge_save_pending",  # 反思侧分支暂存（core 组默认可见）
    "dream",                    # memory-bearing Agent 整理长期记忆（memory 组）
]