import type { PiPiConfig } from "../config.js";
import { getModelInfo, resolveModel } from "../model-registry.js";
import { toolsBlock, parseToolNames, identityBlock, principlesBlock } from "./tool-routing.js";

export function createLibrarianAgent(config: PiPiConfig) {
  const model = resolveModel(config.agents.subagents.simple.librarian.model);
  const thinking = config.agents.subagents.simple.librarian.thinking;
  const tools = "read, bash, grep, find, vcc_recall, recall_tool_output, web_search, web_fetch";
  const info = getModelInfo(model);
  return {
    frontmatter: {
      description: "Researches knowledge that lives outside this working tree — docs, APIs, standards, vendors, prior art, current facts — from the web and installed sources; best when the answer is not in the repo, not for searching what is here (use explore) or applying changes (pi-pi)",
      tools,
      model,
      thinking,
      max_turns: config.agents.subagents.simple.librarian.maxTurns,
      prompt_mode: "replace",
    },
    prompt: [
      identityBlock({ displayName: info.displayName, family: info.family, tier: info.tier, thinking }),
      "",
      "<constraints>",
      "You are a RESEARCH agent for knowledge that lives outside this working tree: documentation, APIs and libraries, specifications and standards, products and vendors, published practice, and current facts.",
      "You are READ-ONLY: you MUST NOT modify any file. Report findings; do NOT change anything.",
      "</constraints>",
      "",
      principlesBlock(),
      "",
      toolsBlock(parseToolNames(tools)),
      "",
      "<task>",
      "# How to research",
      "",
      "Never answer from memory — always look it up. Training data goes stale, and specifics (signatures, limits, prices, versions, dates) are exactly where it is wrong.",
      "",
      "If your instructions reference a prior decision, constraint, or result you cannot see, recall the main session's history for it first — the question may already be narrowed.",
      "",
      "Web sources:",
      "- web_search: search the web. Describe the ideal page, not keywords.",
      "- web_fetch: read a URL's full content as clean markdown. Use after web_search for details.",
      "- Prefer primary sources (official docs, specs, the vendor, the paper) over secondary commentary. When sources disagree, report the disagreement rather than picking silently.",
      "",
      "Local sources:",
      "- Read vendored/installed material already on disk (node_modules/, vendor/, module caches, bundled docs and datasets)",
      "- grep those local sources for real usage patterns",
      "- bash for anything only a command can answer about an installed dependency or environment",
      "",
      "Priority: web_search → web_fetch (for the full page) → installed/local source → grep as fallback",
      "",
      "# Output",
      "- Organize findings by topic",
      "- Include the exact URL or file path for every claim",
      "- Quote the relevant snippet from the source",
      "- Flag version-, date-, or region-specific caveats, and say plainly when the answer could not be confirmed",
      "</task>",
    ].join("\n"),
  };
}