sj|dZddlmZddlZddlmZddlmZddlm Z dd Z Gd d e Z ddZ e dddddde dddddd Z ee dS)aMeta Model API (Muse Spark) provider plugin for Hermes Agent. Provider profile for Meta Superintelligence Labs' Muse Spark family, served via the OpenAI-compatible Meta Model API at ``https://api.meta.ai/v1``. Bundled from https://github.com/albertodepaola/hermes-meta-provider. Hermes' provider discovery (``providers/__init__.py``) imports it on first ``get_provider_profile()`` / ``list_providers()`` call, and the module-level ``register_provider()`` below wires it into the registry. Design notes ------------ * **Zero core edits.** Everything rides on ``ProviderProfile`` hooks. No changes to hermes' ``model_metadata.py`` / ``models.py`` / ``run_agent.py`` are needed: - Context window (1M), reasoning and vision capabilities already resolve from models.dev for the muse-spark family, so no static ctx table entry is required. - The reasoning dial is emitted as a **top-level ``reasoning_effort``** kwarg (returned in the ``top_level`` slot of ``build_api_kwargs_extras``), which the chat-completions transport merges unconditionally. This deliberately avoids the ``extra_body.reasoning`` path, whose emission is gated by a hardcoded host allowlist in core (``AIAgent._supports_reasoning_extra_body``) that a third-party plugin must not edit. * **Meta 400 on ``reasoning_effort: "none"``.** Muse rejects ``none``; disabling reasoning maps to ``"minimal"`` instead. * **``default_max_tokens=16384``.** Muse spends completion budget on hidden reasoning tokens first; small caps can finish with empty content. ) annotationsN)Any)register_provider)ProviderProfilereasoning_config dict | Nonereturnstrc |pi}|ddurdSt|dpd}|dvr |dkrdndSd d lm}m}|||}||vr|ndS) a!Map Hermes' reasoning_config to a Meta-safe ``reasoning_effort`` value. Meta's vocabulary (minimal..xhigh; rejects ``none``) is declared in agent.reasoning_effort. Disabled/"none" maps to ``minimal`` (the closest Meta has to off); unset/bespoke levels fall to ``medium``. enabledFminimaleffort>rnonermediumr)META_AI_EFFORTS clamp_effort)getr striploweragent.reasoning_effortrr)rrcrrrclampeds L/home/agent/.hermes/hermes-agent/plugins/model-providers/meta-ai/__init__.py_resolve_effortr&s  RB vviE!!y !!'R ( ( . . 0 0 6 6 8 8F "f,,yy(:DDDDDDDDl6?33G0077h>c"eZdZdZddddd ZdS) MetaAIProfileu>Meta Model API — top-level reasoning_effort, self-contained.NF)rsupports_reasoningrrrboolcontextrr %tuple[dict[str, Any], dict[str, Any]]c (idt|ifS)aiEmit ``reasoning_effort`` as a top-level api kwarg. We ignore the core ``supports_reasoning`` gate on purpose: that flag is driven by a host allowlist in core we cannot (and should not) edit from an out-of-tree plugin. Muse Spark always accepts ``reasoning_effort``, so we resolve it from ``reasoning_config`` directly. reasoning_effort)r)selfrrr!s rbuild_api_kwargs_extrasz%MetaAIProfile.build_api_kwargs_extras=s&8H(I(IJJJr)rrrr r!rr r")__name__ __module__ __qualname____doc__r&rrrr:sHHH )-#( KKKKKKKKrrcTtjddpdS)zGAllow a base-URL override via ``META_BASE_URL`` without editing config. META_BASE_URLrzhttps://api.meta.ai/v1)osgetenvrr+rr _base_urlr0Ns& 9_b ) ) / / 1 1 M5MMrzmeta-ai)metamusez muse-sparkz model-apimslzMeta Model APIz4Meta Muse Spark family (Meta Superintelligence Labs)zhttps://developer.meta.com/ai/) MODEL_API_KEY META_API_KEYMETA_MODEL_API_KEYr-api_keycodex_responsesTmuse-spark-1.2-contributori@)zmuse-spark-1.2r9) namealiases display_name description signup_urlenv_varsbase_url auth_typeapi_modesupports_visiondefault_aux_modeldefault_max_tokensfallback_models)rrr r )r r )r* __future__rr.typingr providersrproviders.baserrrr0meta_air+rrrLs'8#""""" ''''''******????(KKKKKOKKK(NNNN -  >!F/ U Y[[39   D'r