interdeep

Instructions

Implementation Reference

• src/interdeep/server.py:208-234 (handler)

  The handler function `_handle_research_status` which executes the logic for the `research_status` tool. It checks for library availability, retrieves plugin version information, and returns the server's status.

  async def _handle_research_status(arguments: dict) -> list[TextContent]:
      trafilatura_available = False
      try:
          import trafilatura  # noqa: F401
          trafilatura_available = True
      except ImportError:
          pass
  
      pw_available = playwright_ext.is_available()
  
      # Read version from plugin.json rather than hardcoding
      version = "unknown"
      plugin_json = _os.path.join(_os.path.dirname(__file__), "..", "..", ".claude-plugin", "plugin.json")
      try:
          with open(_os.path.normpath(plugin_json)) as f:
              version = json.load(f).get("version", version)
      except (OSError, json.JSONDecodeError):
          pass
  
      return _ok({
          "extraction": {
              "trafilatura": trafilatura_available,
              "playwright": pw_available,
          },
          "tools": ["extract_content", "extract_batch", "compile_report", "research_status"],
          "version": version,
      })

• src/interdeep/server.py:147-154 (schema)

  The definition and input schema for the `research_status` tool inside the `list_tools` function.

  Tool(
      name="research_status",
      description="Show extraction capabilities and companion plugin readiness.",
      inputSchema={
          "type": "object",
          "properties": {},
      },
  ),

• src/interdeep/server.py:245-245 (registration)

  Registration of the `research_status` tool handler within the `_HANDLERS` dictionary mapping.

  "research_status": _handle_research_status,