eai

defmodule Eai do
  @moduledoc false

  def help do
    IO.puts("""
    ═══════════════════════════════════════════════
       EAI 命令速查（全部公开 API）
    ═══════════════════════════════════════════════

    ## 对话入口
    Eai.Chat.talk(content: "msg", mod: :h|:f, model: :deepseek, prompt: :momoka, chat_session: "id", timeout: 30_000)
      返回 {:ok, reply} | {:error, reason} | {:error, :busy, msg}
    Eai.Chat.talk(content: "msg", mod: :f, chat_session: "y", pty_session_id: "x", model: :gpt4o, prompt: :coder)
      返回 {:ok, reply} | {:error, reason} | {:error, :busy, msg}

    ## 会话管理
    Eai.Chat.get_history()                    → 当前会话消息列表
    Eai.Chat.get_history("session")           → 指定会话消息列表
    Eai.Chat.list_chat_sessions()             → %{session_id => %{message_count, status}}
    Eai.Chat.interrupt!()                     → 设置中断标记，下次 get_task_result 轮询时注入 Ctrl+C
    Eai.Chat.interrupt!("session")            → 中断指定会话

    ## 让模型"主动停手"（中断 loop）
    当模型陷入多余的工具循环（反复轮询、栈大量小命令）时，可用 timeout 窗口：
    Eai.ResultCollector.trigger_timeout_window("pty_session_id", 1)
      → 下一轮 LLM 请求会看到一条 user 提示："The timeout you set has been reached.
        Please safely stop what you're doing and reply now."
      → depth 是连续提示的轮数（1 = 提示一次；2 = 连续两轮都提示）。
    Eai.ResultCollector.check_timeout_window("pty_session_id")  → 内部使用
    Eai.Chat.close_chat_session("session")    → 关闭会话
    Eai.Chat.export_history("path.gz")        → {:ok, path} | {:error, reason}
    Eai.Chat.export_history("path.gz", "session")
    Eai.Chat.replace_history("path.gz", "session", "converse|openai|anthropic")
      返回 {:ok, count} | {:error, reason}

    ## 模型查询
    Eai.Models.names()        #{inspect(Eai.Models.names())}
    Eai.Models.all()          → 全部条目详情列表
    Eai.Models.default()      → 默认模型条目
    Eai.Models.get(:gpt4o)    → 模型条目 | nil
    Eai.Models.get!(:gpt4o)   → 模型条目 (or raise)
    Eai.Models.vision_models()→ 视觉模型列表
    Eai.Models.default_vision()→ 第一个视觉模型
    Eai.Models.api_key(entry) → 读取环境变量中的 key
    Eai.Models.to_run_opts(entry) → 转为 run 用 opts map

    ## 提示词查询
    Eai.Prompts.names()       #{inspect(Eai.Prompts.names())}
    Eai.Prompts.list()        → 打印名称 + 描述
    Eai.Prompts.default()     → 默认提示词条目
    Eai.Prompts.get(:coder)   → 条目 | nil
    Eai.Prompts.get!(:coder)  → 条目 (or raise)
    Eai.Prompts.content(:momoka) → 提示词文本

    ## 数据清洗
    Eai.Utils.sanitize_value(term)       → 递归清洗非法 UTF-8
    Eai.Utils.sanitize_messages(messages) → 清洗消息列表

    ## 共享 Git 仓库
    Eai.Git.init_shared_repo()          → {:ok, :created|:already_exists} | {:error, ...}
    Eai.Git.get_shared_repo_path()      → 仓库路径

    ## 背景记录
    Eai.Record.start_link("dir", "session")  → GenServer 启动
    Eai.Record.stop()                        → 停止记录

    ## 外部 CLI 工具（通过 execute_script 调用）
    mcporter          — MCP 客户端 (npm install -g mcporter)
      mcporter list [server]    → 列出 MCP 服务器/工具
      mcporter call srv.tool key=value ...  → 调用 MCP 工具
      mcporter serve --stdio    → 暴露为 MCP bridge
    agent-browser     — 无头浏览器 CLI (npm install -g agent-browser)
      agent-browser open <url>  → 打开页面
      agent-browser snapshot -i → 快照（紧凑 @eN 引用）
      agent-browser click @e1   → 交互

    ## 工具函数（LLM 或用户直接调用）
    #{tool_table()}

    ## 高级：PTY 池直接操作
    alias Eai.PTY
    Eai.PTY.exec_async(session, cmd, task_id)   → {:ok, task_id} | {:error, :busy}
    Eai.PTY.list_sessions()                     → 所有 PTY 会话状态
    Eai.PTY.write_raw(session, raw_string)      → :ok
    Eai.PTY.interrupt_task(session)             → :ok
    Eai.PTY.force_reset(session)                → :ok
    Eai.PTY.clear_task(session, task_id)        → :ok

    ## 高级：LLM 直接调用
    Eai.LLM.Direct.run(messages, pty_session_id, opts)
      opts: %{model: :gpt4o, system_prompt: :coder, chat_session_id: "id", ...}

    ## Hook 管理
    Eai.Hub.reload!()                           → :ok (hot-reload hooks from config/hooks/)
    Eai.Hub.Loader.print_hooks()                → 打印当前注册的 hooks 及优先级
    Eai.Hub.Loader.list_files()                 → {:ok, ["01_example.exs", ...]}
    Eai.Hub.Loader.current_hooks()              → [{ModuleName, priority}, ...]
    :persistent_term.erase(:eai_hooks); Eai.Hub.reload!()  → 强制全量重载

    ## 自动快照回滚（内置 hook）
    config/hooks/03_auto_snapshot.exs (priority=5)
      每次 LLM 请求前自动快照会话历史；请求失败时自动回滚到干净状态。
      防止重复 tool_call_id 导致的上下文污染（如连续 assistant tool_use 消息）。

    ## 思考段空输出修复（内置 hook）
    config/hooks/04_fix_empty_thinking.exs (priority=25)
      当 LLM 返回推理/思考内容但无文本输出且无工具调用时，
      自动将 thinking 内容注入 text 块，防止 OpenAI 400 错误。

    ## AWS Bedrock Converse (SigV4 signing)
    AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY  (必需)
    AWS_REGION=us-east-1                       (可选，默认 us-east-1)
    AWS_SESSION_TOKEN                          (可选，临时凭证)

    ## 调试环境变量
    EAI_DEBUG_PTY=1           原始 PTY 输出
    EAI_DEBUG_LLM_REQUEST=1   打印完整 LLM 请求体
    EAI_WORK_DIR=/path        自定义 PTY 工作根目录
    OPENAI_API_KEY / DEEPSEEK_API_KEY / ANTHROPIC_API_KEY
    """)
  end

  defp tool_table do
    tools = [
      {"Eai.Hub.reload!()", "Hot-reload all hooks", "Hook management"},
      {"Eai.Hub.Loader.print_hooks()", "List registered hooks + priorities", "Hook management"},
      {"execute_script", "%{\"script\"=>\"...\"} -> task_id", "Eai.Tool.ExecuteScript"},
      {"get_task_result", "%{\"task_id\"=>\"...\"} -> 结果", "Eai.Tool.GetTaskResult"},
      {"write_to_session", "%{\"input\"=>\"y\\\\n\"} -> ok", "Eai.Tool.WriteToSession"},
      {"list_pty_sessions", "{} -> 会话列表", "Eai.Tool.ListPtySessions"},
      {"reset_session", "%{\"pty_session_id\"=>\"...\"} -> ok", "Eai.Tool.ResetSession"},
      {"force_complete_task", "%{\"task_id\"=>\"...\"} -> 输出", "Eai.Tool.ForceCompleteTask"},
      {"call_subagent", "%{\"message\"=>\"...\"} -> subagent_task_id", "Eai.Tool.CallSubagent"},
      {"get_subagent_result", "%{\"subagent_task_id\"=>\"...\"} -> 结果",
       "Eai.Tool.GetSubagentResult"},
      {"set_config",
       "%{\"namespace\"=>\"app_env|persistent_term\", \"key\"=>\"...\", \"value\"=>...} -> ok | list",
       "Eai.Tool.SetConfig"},
      {"get_local_time", "{} -> UTC ISO8601", "Eai.Tool.GetLocalTime"},
      {"read_media_file", "%{\"file_path\"=>\"...\", \"inject\"=>true, ...} -> 媒体/inject",
       "Eai.Tool.ReadMediaFile"},
      {"export_chat_session_context", "%{\"file_path\"=>\"...\"} -> ok",
       "Eai.Tool.ExportChatSessionContext"},
      {"replace_chat_session_context",
       "%{\"file_path\"=>\"...\", \"format\"=>\"converse\"} -> ok",
       "Eai.Tool.ReplaceChatSessionContext"},
      {"export_global_context", "%{\"file_path\"=>\"...\"} -> ok",
       "Eai.Tool.ExportGlobalContext"},
      {"replace_global_context", "%{\"file_path\"=>\"...\"} -> ok",
       "Eai.Tool.ReplaceGlobalContext"},
      {"list_chat_sessions", "{} -> 会话列表", "Eai.Tool.ListChatSessions"},
      {"hub_reload", "{} -> %{hooks, models, cards}", "Eai.Tool.HubReload"}
    ]

    header =
      String.pad_trailing("工具", 22) <>
        String.pad_trailing("参数示例（调用 Eai.Tool.XXX.execute(map, pty, chat)）", 54) <> "模块"

    rows =
      Enum.map_join(tools, "\n", fn {name, params, mod} ->
        "  #{String.pad_trailing(name, 22)} #{String.pad_trailing(params, 52)} #{mod}"
      end)

    header <> "\n" <> rows
  end
end