PL j RUdZddlmZddlZddlZddlmZmZmZm Z ddl m Z m Z m Z mZmZddlmZmZejeZddd d d d d d d ddd iddddd d ee de dd ee dedd dd ddd ddd d dd d dgddZd ed!<dBd#ZdCd%ZdCd&ZdDd(Zd)ZdEd,ZdFd0ZdGd2Z dHd4Z!dId7Z"d8Z#dJd<Z$dBd=Z%ej&dd>ee"egd?d@e%A dS)Ku> Video Generation Tool ===================== Single ``video_generate`` tool that dispatches to a plugin-registered video generation provider. Mirrors the ``image_generate`` design: - ``agent/video_gen_provider.py`` defines the :class:`VideoGenProvider` ABC. - ``agent/video_gen_registry.py`` holds the active providers (populated by plugins at import time). - Each provider lives under ``plugins/video_gen//``. The tool itself is intentionally backend-agnostic and ships **no in-tree provider** — turn on a backend by enabling a plugin (``hermes plugins enable video_gen/``) and selecting it in ``hermes tools`` → Video Generation. Unified surface --------------- One tool covers the common cases — text-to-video, image-to-video, video edit, video extend — with a compact schema: prompt text instruction (required for generate/edit) operation "generate" | "edit" | "extend" image_url drives image-to-video when operation=generate video_url source video for edit/extend reference_image_urls list, up to provider-declared cap duration seconds (provider clamps) aspect_ratio "16:9" | "9:16" | "1:1" | ... resolution "480p" | "540p" | "720p" | "1080p" negative_prompt optional (Pixverse/Kling style) audio optional (Veo3/Pixverse pricing tier) seed optional model optional, override the active provider's default Providers ignore parameters they do not support. The tool layer does **lightweight** validation (type/required-prompt) and lets each provider do its own clamping inside :meth:`VideoGenProvider.generate` — that keeps the tool surface stable as new providers ship with different capabilities. ) annotationsN)AnyDictListOptional)COMMON_ASPECT_RATIOSCOMMON_RESOLUTIONSDEFAULT_ASPECT_RATIODEFAULT_RESOLUTIONerror_response)registry tool_errorvideo_generateuG(rebuilt at get_definitions() time — see _build_dynamic_video_schema)objectstringz\Text instruction describing the desired video, motion, subject, style, camera movement, etc.)type descriptionzOptional public URL of a still image. When provided, the active backend routes to its image-to-video endpoint (animate the image); when omitted, it routes to text-to-video. Pass either a URL the user supplied or a path/URL from the conversation.arrayrzOptional list of reference image URLs (style or character refs). Only supported by some backends; the active backend's description below indicates whether this is honored and what the max is.)ritemsrintegerzDesired video duration in seconds. Providers clamp to their supported range (commonly 4-15s). Omit to use the provider's default.zc|r*d|d}tjt|d|Sd}tjt|dS)Nzvideo_gen.provider='u' is set but no plugin registered that name. Run `hermes plugins list` to see installed video gen backends, or `hermes tools` → Video Generation to pick one.provider_not_registered)error error_typer<u{No video generation backend is configured. Run `hermes tools` → Video Generation to enable one (xAI, FAL, or Google Veo).no_provider_configured)rVrW)jsondumpsr )rSmsgs r8_missing_provider_errorr\s   ': ' ' ' z.";       D :n6  rCrAr Optional[int]cf||dkrdS t|S#ttf$rYdSwxYw)N)int TypeError ValueErrorr@s r8 _coerce_intrcsL } t5zz z "tts 00Optional[bool]c|dSt|tr|St|tr2|}|dvrdS|dvrdSdS)N>1onyestrueT>0noofffalseF)r/rFr>r?lower)rAvs r8 _coerce_boolrpsu }t% % KKMM   ! ! * * *4 + + +5 4rCOptional[List[str]]c,|dSt|tr|g}t|ttfsdSg}|D]R}t|tr;|r'||S|pdSN)r/r>listtupler?append)rAoutitems r8_normalize_reference_imagesry(s }t% edE] + +tC%% dC  %TZZ\\ % JJtzz|| $ $ $ ;$rCargs_kwc `|dpd}|dpdpd}t|d}t|d}|dptpt}|dpt pt }|dpdpd}t |d } t|d } |d pdpd} |std St} t} | t| S| p!tp| }|||||||| | d }d| D} | jdd|i|}n#t$r}t dt%| dd|t'jt+dt%| ddddt%| dd|pd|cYd}~Sd}~wt,$r}t dt%| dd|t'jt+dt%| ddd|dt%| dd|pd|cYd}~Sd}~wwxYwt/|t0s7t'jt+ddt%| dd|pd|St'j|S)Nrr_rrrrrr r!r"r#z'prompt is required for video generation) r#rrrrrr r!r"ci|] \}}||| Srs).0kros r8 z*_handle_video_generate..]s ? ? ?tq!arCzBvideo_gen provider '%s' rejected kwargs (signature too narrow): %sr&?z Provider 'z\' signature is out of date with the video_generate schema. Report this to the plugin author.provider_contract)rVrWr<r#rz"video_gen provider '%s' raised: %sz ' error: provider_exceptionz#Provider returned a non-dict resultr~)r1r?ryrcr r rprrBrRr\rE default_modelrgeneraterar3warninggetattrrYrZr r2r/r0)rzr{rrrrrrr r!r"model_overriderSr<r#kwargsresultr7s r8_handle_video_generater6shhx  &B - - / /F+&&,"3355=I6txx@V7W7WXX488J//00HHH^,,D0DKKMMeQeL((<((>,>EEGG]K]Jxx 1228b??AAITO '** + +E txx'' ( (Dhhw''-24466>$N ECDDD122J'))H&z222  X:<< X@V@V@X@XE 4$ *  F@ ?v||~~ ? ? ?F "";;&;F;;      P Hfc * *C   z.)WXvs;;)))+Xvr22+2            0 Hfc * *C   z.Mwx==MMMM+Xvr22+2              fd # # z.7*Xvr22+2        :f  s2*H;; M A4J?9M ? M  A6MM M uGenerate a video from a text prompt (text-to-video) or animate a still image (image-to-video) using the user's configured video generation backend. Pass `image_url` to animate that image; omit it to generate from text alone. The backend auto-routes to the right endpoint. The backend and model family are user-configured via `hermes tools` → Video Generation; the agent does not pick them. Long-running generations may take 30 seconds to several minutes — the call blocks until the video is ready. Returns either an HTTP URL or an absolute file path in the `video` field; display it with markdown ![description](url-or-path) and the gateway will deliver it. model_meta backend_caps List[str]c g}t|dpg}|d}|r||d|vrd|vr|dnd|vrd|vr|d|S)uPull human-readable caveats out of one model's catalog metadata. Only surfaces things that meaningfully differ from the backend's overall capabilities — repeating defaults is noise. modalitiesmodalityimagetextu]this model is image-to-video only — image_url is REQUIRED; text-only calls will be rejectedu?this model is text-to-video only — image_url is not supported)setr1addrv)rrcaveatsrrs r8_format_model_caveatsrsGZ^^L117R88J~~j))H!x   *z!9!9 /     :  '";"; M    NrCctg}t}t}|s,|ddd|iS ddlm}ddlm}|||}n#t$rd}YnwxYw|0|d|d dd|iS | pi}n#t$ri}YnwxYw | pg}n#t$rg}YnwxYw|p| tfd |Di}|j} d| } r| d z } || t||D]} |d | t!|d pg} d| vr.d| vr*|ds|d|dr1|dd|d|dr1|dd|d|dr=|dr(|d|dd|dd|dr|d|dr|d|d pd} | r|d!| d"dd|iS)#a\Build a description that reflects the active backend's actual surface. Cheap: reads config (already memoized by the caller), asks the active provider for `capabilities()` and the active model's catalog entry, and formats a few lines of prose. Falls back to the generic description when no provider is configured or registered. u} No video backend is configured. Calls will return an error until the user picks one via `hermes tools` → Video Generation.r r) get_providerrINz Active backend: uI (plugin not yet loaded — the tool will retry discovery on first call).c3xK|]4}t|t|dk0|V5dS)idN)r/r0r1)rm active_models r8 z._build_dynamic_video_schema..sFRRqjD11RaeeDkk\6Q6Q6Q6Q6Q6QRRrCu · model: z- rrrruk- supports both text-to-video (omit image_url) and image-to-video (pass image_url) — routes automatically aspect_ratiosz- aspect_ratio choices: z, resolutionsz- resolution choices: min_duration max_durationz- duration range: -ssupports_audioz@- audio: pass `audio=true` to enable native audio (pricing tier)supports_negative_promptz- negative_prompt: supportedmax_reference_imagesz- reference_image_urls: up to z images)_GENERIC_DESCRIPTIONrBrErvjoinrKrrLrJr2 capabilities list_modelsrnext display_namerrr1)partsrSconfigured_modelrrJr<capsmodelsr backend_labellinecrmax_refsrs @r8_build_dynamic_video_schemarsC--E022J355 1  P   tyy//00999999AAAAAA""$$$< ++   9 9 9 9   tyy//00$$&&," %%''-2 $?x'='='?'?LRRRRFRRR J )M / / /D- ,l,,, LL#:t 4 4 X!XX TXXl++1r22J : 5 5jnnZ>X>X 5  G    xx  T R $:O0P0PRRSSS xx P Ndii]8K.L.LNNOOO xx DHH^$<$<  On!5 O O^8L O O O    xx !!Y WXXX xx*++5 3444xx.//41HI GhGGGHHH 499U++ ,,s6!A77 BB<C C"!C"&C== D  D r-Fu🎬) r&toolsetschemahandlercheck_fn requires_envis_asyncemojidynamic_schema_overrides)r*r()r*r:)r*rF)rSr:r*r>)rArr*r])rArr*rd)rArr*rq)rzr(r{rr*r>)rr(rr(r*r)'__doc__ __future__rrYloggingtypingrrrragent.video_gen_providerrr r r r tools.registryr r getLogger__name__r3rtr)__annotations__r9rBrErNrRr\rcrpryrrrrregisterr~rCr8rsd'''R#""""" ,,,,,,,,,,,,0///////  8 $ $ ]!<!;    (+; % %"*!1220!/00.!C  "J""!;YU U lJqYYc)c)ccccV    6*4        SSSSP L:W-W-W-W-~   " 0  8      rC