`gj^UUdZddlmZddlZddlZddlmZmZmZm Z ddl m Z m Z m Z mZmZddlmZmZej&eZddd d d d d d d ddd iddddd d ee de dd ee dedd dd ddd ddd d dd d dgddZd ed!<d3d"Zd4d#Zd4d$Zd5d%Zd&Zd6d'Zd7d(Zd8d)Z d9d*Z!d:d+Z"d,Z# d;d-Z$d3d.Z%ejLdd/ee"egd0d1e%2 y)/``. 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.zs r7_read_configured_video_modelrCs6 # % ) )' 2E%%++-{{} rAc ddlm}ddlm}||D]} |j ry y#t $rY%wxYw#t $rYywxYw)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_registryrEhermes_cli.pluginsrG is_availabler1)rErGr:s r7#check_video_generation_requirementsrKsk  ;A"$&( H ((*+         s5A6AA AAAA AAc ddlm}ddlm}||}||d|}|S#t$r }t j d|Yd}~yd}~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_providerrFNT)forcez(video_gen provider resolution failed: %s)rHrMrIrGr1r2r3)rMrGr:r6s r7_resolve_active_providerrOsX @A"$&(   &T 2*,H  ?Es-0 AAAc|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)rRrS)jsondumpsr ) configuredmsgs r7_missing_provider_errorrYsi":,/& ' zz.";    D ::n6 rAcT||dk(ry t|S#ttf$rYywxYw)N)int TypeError ValueErrorr>s r7 _coerce_intr_s6 } 5z z "s ''c|yt|tr|St|tr(|jj }|dvry|dvryy)N>1onyestrueT>0noofffalseF)r.boolr<r=lower)r?vs r7 _coerce_boolrlsR }% % KKM   ! * * + + rAc|yt|tr|g}t|ttfsyg}|D]C}t|ts|j s%|j |j E|xsdS)N)r.r<listtupler=append)r?outitems r7_normalize_reference_imagesrs(sp }% edE] +C% dC TZZ\ JJtzz| $% ;$rAc |jdxsdj}|jdxsdjxsd}t|jd}t|jd}|jdxstjxst}|jdxst jxst }|jdxsdjxsd}t |jd } t|jd } |jd xsdjxsd} |s td Sd |vsd|vr tdSt} t} | t| S| xstxs| j}|t| ||||||| | d }|jDcic] \}}| || }}} | jdd|i|}t1|t2s2t)j*t-ddt'| dd|xsd|St)j*|Scc}}w#t $rm}t"j%dt'| dd|t)j*t-dt'| ddddt'| dd|xsd|cYd}~Sd}~wt.$ro}t"j%dt'| dd|t)j*t-dt'| ddd|dt'| dd|xsd|cYd}~Sd}~wwxYw)Nrr[rrrrrr 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"zBvideo_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)rRrSr:r#rz"video_gen provider '%s' raised: %sz ' error: provider_exceptionz#Provider returned a non-dict result)r0r=rsr_r r rlrr@rOrYrC default_modelrirgenerater]r2warninggetattrrUrVr r1r.r/)args_kwrrrrrrr r!r"model_overriderWr:r#kwargskrkresultr6s r7_handle_video_generater6sKhhx &B - - /F+&,"335=I6txx@V7WX488J/0HHH^,D0DKKMeQeL((<(>,>EEG]K]Jxx 128b??AITO '* +E txx' (Dhhw'-2446>$N CDDdkT1 U  12J')H&z22  X:< X@V@V@XE$($8 4$ * F &||~ ?tq!ad ?F ? """;&;F;@ fd #zz.7*Xvr2+2     ::f Y@    P Hfc *C zz.WXvs;<=()+Xvr2+2       0 Hfc *C zz.wx=>iuM+Xvr2+2     s>) I(4I(=I.. M7A"KM M+A$MMMu[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).cg}t|jdxsg}|jd}|r|j|d|vrd|vr|jd|Sd|vrd|vr|jd|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)setr0addrp) model_meta backend_capscaveatsrrs r7_format_model_caveatsrsGZ^^L17R8J~~j)Hx *z!9 /  N : '"; M  NrAc tg}t}t}|$|jdddj |iS |j xsi} |jxsg}|xs|j t fd|Di}|j}d|} r|d z }|j|t||D]}|jd|t|jdxsg} d | vr&d | vr"|jd s|jd |jd r&|jddj |d |jdr&|jddj |d|jdr/|jdr|jd|dd|dd|jdr|jd|jdr|jd|jdxsd} | r|jd| d|jdk(r6|jd  dd!lm} | d"} | r|jd$| ddj |iS#t $ri}Y[wxYw#t $rg}YXwxYw#t $rd#} YZwxYw)%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 available. Calls will return an error until the user picks one via `hermes tools` → Video Generation.r c3nK|],}t|ts|jdk(s)|.yw)idN)r.r/r0).0m active_models r7 z._build_dynamic_video_schema..s)RqjD1aeeDk\6QRs 555z 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_DESCRIPTIONrCrOrpjoin capabilitiesr1 list_modelsr|next display_namerrr0r&tools.xai_httpr)partsconfigured_modelr:capsmodelsr backend_labellinecrmax_refsrnoticers @r7_build_dynamic_video_schemars--E35()H  P tyy/00$$&,"%%'-2$?x'='='?LRFR J ))M   /D +l^,, LL#:t 4 r!X TXXl+1r2J : 5jnnZ>X  G  xx  / $:O0P/QRS xx  -dii]8K.L-MNO xxDHH^$<  n!5 6a^8L7MQ O  xx ! WX xx*+ 34xx./41H 5hZwGH}}     >,[9F  LL;vh/ 0 499U+ ,,A  n F s6J%J7.K % J43J47 KK KKr,Fu🎬) r&toolsetschemahandlercheck_fn requires_envis_asyncemojidynamic_schema_overrides)returnr()r Optional[str])rri)rWrrr<)r?rrz Optional[int])r?rrzOptional[bool])r?rrzOptional[List[str]])rr(rrrr<)rr(rr(rz List[str])'__doc__ __future__rrUloggingtypingrrrragent.video_gen_providerrr r r r tools.registryr r getLogger__name__r2rnr)__annotations__r8r@rCrKrOrYr_rlrsrrrrregisterr{rAr7rs(T# ,,0   8 $ ]!<!J   (+J %"*!120!/0.!C "J""!;WT jJoXb)~bT 6*4  Y\ 8" :\-H   " 0  8 rA