yj [UdZddlmZddlZddlZddlmZmZmZm 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 ddd d dd d dgdd Zd!ed"<dCd$ZdDd&ZdDd'ZdEd)Zd*ZdFd-ZdGd1ZdHd3Z dId5Z!dJd8Z"d9Z#dKd=Z$dCd>Z%ej&dd?ee"egd@dAe%B dS)Lu 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, and reference-to-video - with a compact schema: prompt text instruction (required) image_url drives image-to-video 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. Video edit and video extend are intentionally not exposed here; providers with those workflows should expose separate tools. ) 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 descriptiona Optional public HTTPS 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. For xAI chaining, use the `image` or `public_url` HTTPS URL from a prior Imagine result.arrayrzOptional list of public HTTPS reference image URLs (style or character refs). For xAI chaining, use `image` or `public_url` from prior Imagine results.)ritemsrintegerzDesired video duration in seconds. Providers clamp to their supported range (commonly 4-15s). Omit to use the provider's default.zrAs r9_read_configured_video_modelrFsO # % % ) )' 2 2E%%++--{{}} 4rDboolc ddlm}ddlm}||D]*} |rdS#t $rY'wxYwn#t $rYnwxYwdS)zReturn True when at least one registered provider reports available. Triggers plugin discovery (idempotent) so user-installed plugins are visible to the toolset gate. r)list_providers_ensure_plugins_discoveredTF)agent.video_gen_registryrIhermes_cli.pluginsrK is_availabler3)rIrKr=s r9#check_video_generation_requirementsrOs  ;;;;;;AAAAAA""$$$&((  H ((** 44             5s6"A=AA A A A  A AAc ddlm}ddlm}||}||d|}|S#t$r&}t d|Yd}~dSd}~wwxYw)uReturn the active provider object or None. Forces plugin discovery before checking the registry — handles cases where a long-lived session was started before a plugin was installed. r)get_active_providerrJNT)forcez(video_gen provider resolution failed: %s)rLrQrMrKr3r4r5)rQrKr=r8s r9_resolve_active_providerrSs @@@@@@AAAAAA""$$$&&((   & &T 2 2 2 2**,,H  ?EEEttttts9< A,A''A, configuredr?c|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)rWrX)jsondumpsr )rTmsgs r9_missing_provider_errorr]s   ': ' ' ' z.";       D :n6  rDrBr Optional[int]cf||dkrdS t|S#ttf$rYdSwxYw)N)int TypeError ValueErrorrAs r9 _coerce_intrdsL } t5zz z "tts 00Optional[bool]c|dSt|tr|St|tr2|}|dvrdS|dvrdSdS)N>1onyestrueT>0noofffalseF)r0rGr?r@lower)rBvs r9 _coerce_boolrq%su }t% % KKMM   ! ! * * *4 + + +5 4rDOptional[List[str]]c,|dSt|tr|g}t|ttfsdSg}|D]R}t|tr;|r'||S|pdSN)r0r?listtupler@append)rBoutitems r9_normalize_reference_imagesrz3s }t% edE] + +tC%% dC  %TZZ\\ % JJtzz|| $ $ $ ;$rDargs_kwc P|dpd}|dpdpd}t|d}|d}ddlm}||||\}}}||St |d}|d pt pt } |d ptpt} |d pdpd} t|d } t |d } t|d}|dpdpd}|stdSd|vsd|vrtdSt}t}|t|S|p!tp|}|t||||| | | | | |d }d|D} |jd!d|i|}n#t$$r}t&dt+|dd|t-jt1dt+|ddddt+|dd|pd|cYd}~Sd}~wt2$r}t&dt+|dd|t-jt1dt+|ddd|dt+|dd|pd|cYd}~Sd}~wwxYwt5|t6s7t-jt1d dt+|dd|pd|St-j|S)"Nrr`rrtask_idr)_confine_source_imagesrrrr r!r"r#r$z'prompt is required for video generation operation video_urlzvideo_generate only supports text-to-video, image-to-video, and reference-to-video; use a provider-specific tool for video edit/extend) r$_model_override_explicitrrrrrr r!r"r#ci|] \}}||| Srt).0krps r9 z*_handle_video_generate..{s ? ? ?tq!arDzBvideo_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)rWrXr=r$rz"video_gen provider '%s' raised: %sz ' error: provider_exceptionz#Provider returned a non-dict resultr)r2r@rztools.image_generation_toolrrdr r rqrrCrSr]rF default_modelrGrgeneraterbr4warninggetattrrZr[r r3r0r1)r{r|rrrr~r confine_errorrrrr r!r"r#model_overriderTr=r$kwargsresultr8s r9_handle_video_generaterAshhx  &B - - / /F+&&,"3355=I6txx@V7W7WXXggi  G CBBBBB5K5K'62622I#] 488J//00HHH^,,D0DKKMMeQeL((<((>,>EEGG]K]Jxx 1228b??AAITO '** + +E txx'' ( (D488I..//Ghhw''-24466>$N ECDDDdkT11 U   122J'))H&z222  X:<< X@V@V@X@XE$($8$8 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"J33 O=A4L71O7 OA6O:OOu[Generate a video from a text prompt (text-to-video), animate a still image (image-to-video), or guide generation with reference images. Pass `image_url` to animate an image or `reference_image_urls` for reference-to-video. Video edit/extend workflows are not part of this unified surface; use a dedicated provider-specific tool when one is available. 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 the result in the `video` field — either an HTTP URL or an absolute file path. To show it to the user, reference that path/URL in your response using the file-delivery convention for the current platform (your platform guidance describes how files are delivered here). 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)setr2addrw)rrcaveatsrrs r9_format_model_caveatsrsGZ^^L117R88J~~j))H!x   *z!9!9 /     :  '";"; M    NrDcztg}t}t}|,|ddd|iS |pi}n#t $ri}YnwxYw |pg}n#t $rg}YnwxYw|p|tfd|Di}|j }d|}r|dz }||t||D]}|d|t| d pg} | d } | r| | | p#t| d pg} d | vrd | vr|d | dr1|dd|d| dr1|dd|d| d| d} | d| d} | r| r|d| d| d| dr|d| dr|d| dpd}|r|d|d|jd krT|d! dd"lm}|d#}n#t $rd$}YnwxYw|r|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. Nu| No video backend is available. Calls will return an error until the user picks one via `hermes tools` → Video Generation.r c3xK|]4}t|t|dk0|V5dS)idN)r0r1r2)rm active_models r9 z._build_dynamic_video_schema..sFRRqjD11RaeeDkk\6Q6Q6Q6Q6Q6QRRrDz Active backend: u · 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_imagesrz- reference_image_urls: up to z imagesxaiz- chaining: for edit/extend pass the public HTTPS MP4 in `video` or `public_url` from the prior Imagine result (files-cdn). For image-to-video / reference-to-video pass public image URLs the same way)xai_storage_notice_textr.r`z - storage: )_GENERIC_DESCRIPTIONrFrSrwjoin capabilitiesr3 list_modelsrnext display_namerrr2rr'tools.xai_httpr)partsconfigured_modelr=capsmodelsr backend_labellinecmodel_modalitiesreffective_modalitiesrrmax_refsrnoticers @r9_build_dynamic_video_schemars--E355())H  P   tyy//00$$&&," %%''-2 $?x'='='?'?LRRRRFRRR J )M / / /D- ,l,,, LL#:t 4 4 X!XX :>>,77=2>>~~j))H'X&&&+Ps488L3I3I3OR/P/P %%%'5I*I*I  G    xx  T R $:O0P0PRRSSS xx P Ndii]8K.L.LNNOOO>>.$((>2J2JKKL>>.$((>2J2JKKL   ? ? ? ? ? ?    xx !!Y WXXX xx*++5 3444xx.//41HI GhGGGHHH}       > > > > > >,,[99FF   FFF   1 LL/v// 0 0 0 499U++ ,,s6A,, A;:A;?B B%$B%(M:: N N r.Fu🎬) r'toolsetschemahandlercheck_fn requires_envis_asyncemojidynamic_schema_overrides)r+r))r+r;)r+rG)rTr;r+r?)rBrr+r^)rBrr+re)rBrr+rr)r{r)r|rr+r?)rr)rr)r+r)'__doc__ __future__rrZloggingtypingrrrragent.video_gen_providerrr r r r tools.registryr r getLogger__name__r4rur*__annotations__r:rCrFrOrSr]rdrqrzrrrrregisterrrDr9rsy(((T#""""" ,,,,,,,,,,,,0///////  8 $ $ ]!<!J    (+J %%"*!1220!/00.!C  "J"""#  !;m_ _ @JEccm)m)mmmmj    6*4        ffffv 8":b-b-b-b-T   " 0  8      rD