j.:0UdZddlmZddlmZidddddd d d d d ddddddddddddddddddd d!d"d#d$d%id&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d'd5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHiZdIedJ<ddOZdPZdQdRdSifdTdUdSd@fdVdWdXdYd+fdZd[d\d]d^d_d`dfdadbdcd\d]d^d_d fdddedfdgd\d]dhdidjd^d_dkd`d fdldmdndDfdPZ doedp<iddqd drddsddtddud"dvd$dwd&dxd,dyddzdd{dd|dGd}d2d~d4dd;dd=ddddddddddddd Z dddddddddddddddZ dZ idddddddddddddddddddddddd2dd2dd2dd2dd2dd=idd=ddddddddddddddddddddGddGdd7dd7dd4dd4dd;d;d&d&d"d$d$dZ dS)aDeepy Zero's tool catalog: the only built-in tools and parameters that Deepy Zero's own model sees. Every built-in assistant tool also serves the MCP toolbox of Deepy Prime and external agents, which see all of them. Deepy Zero is the lightweight assistant: its whole tool list is part of every prefill and of its context window. A tool or parameter added for the toolbox therefore stays out of Zero until it is listed here on purpose, and wording written for agents goes to agent_description, which Zero never reads. Plugin tools registered for Deepy Zero are explicit Zero tools and are not listed. Zero discovers most of its tools progressively, as Prime does: only ZERO_DIRECT tools are in its prompt, with the short texts of ZERO_DIRECT_TEXT; the other catalog tools sit behind one `toolbox` tool, which lists them (ZERO_TOOLBOX_SUMMARIES), describes one on demand (its full schema plus ZERO_TOOLBOX_NOTES) and runs them. Small models (Qwen3.5 4B and 9B) keep the common path direct. ) annotations)Anyadd_to_gallery)pathpaths append_text) file_pathtextcreate_color_frame)widthheightcolorboxes box_coloredit)r old_string new_string replace_all edit_image)media_idpromptr r num_inference_stepsextra_settings extract_audio)rstart_send_s duration_s start_frame end_frame num_framesaudio_track_no extract_image)rframe_notime_s extract_video)rrrrrrr gen_image)rr r rr custom_filegen_song)lyrics music_captionduration_secondsrlorasr'gen_speech_from_description)rvoice_descriptionr+rgen_speech_from_sample)rrr+r gen_video) r image_start image_endr r r r+fpsrrr,r'gen_video_with_refs)rr1r2r r r r+r3rrr,r' image_refs video_refsgen_video_with_speech) rr1audio_media_idr r r r+r3rrr,get_default_settings)tool_id get_loras)r:nameget_media_details)rget_selected_media) media_type inspect_media)rquestionr# inspect_video)rrrrAmid_res_samplingmin_gap_frames min_gap_s list_files)rpatternr?limitcursor summary_onlyload_doc_section)doc_idsection merge_videos) media_ids transitions transition_s mute_videonotify)messagetitlepostprocessing)rprocess parameters query_file)r replace_audio)video_idaudio_id resize_crop) rr r crop_leftcrop_top crop_right crop_bottom crop_unit crop_anchorstretch_to_fitresolve_media_reference) referencer?rg) arguments search_doc)queryrL side_by_side)rOlayoutlegendstranscribe_media)rtimestamp_typer!zdict[str, tuple[str, ...]]ZERO_TOOL_PARAMETERStoolsdict[str, dict[str, Any]]returnNonec (tD]u\}||vrtd|d||dfdD}fdD}|s|rtd|d|d|d vd S) zlFail at import when an entry names a missing tool or parameter, or leaves out a parameter its tool requires.z'Deepy Zero catalog lists unknown tool 'z'.rXcg|]}|v| Srw).0 parameterdeclareds AC:\Users\johnn\OneDrive\Documents\AI\shared\deepy\zero_catalog.py z&check_zero_catalog..>s#VVVIX.?sbDDDDQ[]aHbHbDgpyChChC9hChChCr}zDeepy Zero catalog entry 'z#' does not match the tool: unknown z, required but missing .N)rpitems RuntimeError)rqr<unknownmissingrzrXs @@r{check_zero_catalogr8s06688QQj u  QQQQRR R;|,VVVVjVVVDDDDHNN4D4DDDD  Qg Q PD P Pel P PFM P P PQQ Q Q QQr})r>rer@r&rr0rizThe media selected in the Gallery: only when the user says this, selected or current. For last, latest or previous media use resolve_media_reference.r?zimage, video, audio, 3d or all.zjThe media_id of the last, latest or previous media, or of one the user describes (not for selected media).z9What the user said, e.g. last, previous, the cat picture.zJLook at an image (or one frame of a video) and answer a question about it.zThe image or video media_id.zWhat to look for.z%Frame of a video (default the first).zCGenerate an image from a prompt with the configured image template.z"Detailed description of the image.z4Width in pixels, only when the user asks for a size.z5Height in pixels, only when the user asks for a size.zSteps, only when the user asks.zOOther template settings by their exact names from toolbox get_default_settings.zEExtra input file, only when get_default_settings reports custom_file.zChange a still image and get a still image back (add, remove, restyle). Never for a video: to animate a picture use gen_video with image_start.zThe image to edit.z&The edit to make, described precisely.zMake a video: from a prompt alone, or animating a picture (image_start = its media_id), optionally ending on another picture (image_end).ziDetailed description of the shot: subject, action, camera, sound or speech when the template makes sound.z"media_id of the first frame image.z!media_id of the last frame image.z%Frame count; prefer duration_seconds.z*Length in seconds when the user gives one.z.Frames per second (15 to 60), only when asked.zlOnly when the user asks for LoRAs: [{"name": a file name returned by toolbox get_loras, "multiplier": 1.0}].zSearch WanGP's documentation, only to answer a question about how WanGP works (never to carry out a request). The LoRAs installed for a tool are listed by toolbox get_loras, not by the docs.zWords to search for.zMOptional: getting_started, overview, processing, prompts, loras or finetunes.z%dict[str, tuple[str, dict[str, str]]]ZERO_DIRECT_TEXTzbVideo keeping the look of reference images (a character, a product) or following reference videos.zITalking or singing video driven by an existing speech or song audio clip.z.Speech audio from text with a described voice.z5Speech audio from text in the voice of a sample clip.z.Song or music from lyrics and a music caption.zMSettings, inputs and extra settings of the template behind a generation tool.z&LoRAs available for a generation tool.zBSize, duration, fps, frame count and audio tracks of a media item.zJAnswer a question about a time range of a video (compares sampled frames).z&Save one frame of a video as an image.zCut a clip from a video.z/Take or cut the audio of a video or audio item.z3Transcript of the speech in an audio or video item.z9Join videos one after another, with optional transitions.zRemove the sound of a video.z"Replace the soundtrack of a video.z!Resize or crop an image or video.z@Put images or videos next to each other in one picture or video.z?Solid colour image of an exact size (black frame, colour card).z^Upscale, refine, interpolate or clean media (call with media_id alone to list the operations).zSend the user a notification.z"Add existing files to the Gallery.z"List authorized folders and files.zMetadata or text of one file.z0Search file names or text in authorized folders.zReplace text in a text file.z0Append text to a text file (created if missing).z*Load one section of WanGP's documentation.) rkr rVrSrrFrYrgrrrKzFor a subject, character or product that must keep its look, or a motion to follow: image_refs=[media_id] (video_refs when supported). Read get_default_settings once for the template's input guidance. Use gen_video when there are only start or end images.zUse when a speech or song clip already exists; for a talking video from text only, gen_video can speak the words when its template makes sound.zEFor standalone speech or when a separate speech clip is needed first.z`For standalone speech in the voice of a sample; if the voice is in a video, extract_audio first.zklyrics in sections ([verse], [chorus]) and a music_caption with genre, instruments, vocals, mood and tempo.aInspection only: never copy unchanged defaults back into a generation call. A setting the user asks for that is not a direct parameter must appear in extra_settings here, under that exact name; otherwise it is not available: tell the user and do not generate.zzCopy the returned identifiers exactly (with subfolders) and keep the user's multipliers, including ',' and ';' separators.zbFor the selected frame of a selected video, use get_selected_media's current_time_seconds exactly.zrUse time arguments (start_s, end_s, duration_s) or frame arguments (start_frame, end_frame, num_frames), not both.zyTime arguments for audio or video, frame arguments for video; audio_track_no when get_media_details shows several tracks.z0timestamp_type: segment (default), word or none.zRead get_media_details first. Crop values in pixels or percent; crop_anchor keeps a side or corner; stretch_to_fit only when the user asks to stretch.zCall with media_id only to list the operations and their parameters, then with one returned process and parameters. Never guess a process.z'layout and legends only when requested.)r4r7r-r/r(r9r;r"r%rrnr]rVrkzMore tools: run one directly with toolbox(action=..., arguments={...}). Actions with their arguments (* required): {actions}. With an action and no arguments it returns that action's description and rules; with no arguments, one line per action.cut cut_videotrim trim_videoclip clip_video screenshotframe get_frame trim_audio cut_audiojoinconcat concatenatemergecombine_videoscropresizesongmusic generate_song gen_musicspeechttsvoice gen_speech clone_voice transcribe transcriptupscaleenhancemute remove_audio add_audio) set_audiodetails media_detailssettingsr, list_lorasN)rqrrrsrt)__doc__ __future__rtypingrrp__annotations__r ZERO_DIRECTrZERO_TOOLBOX_SUMMARIESZERO_TOOLBOX_NOTESZERO_TOOLBOX_DESCRIPTIONZERO_TOOLBOX_SYNONYMSrwr}r{rs    #"""""$4'$4($4L$4 D $4 d $4  $47$4m$4f$4i$4"#h$4Z$4u$4[$4w$4 L!$4"$#$4$4$%$4&/'$4(9)$4*t+$4,V-$4.-/$40@1$42-3$44 "5$46;7$48)9$4:-;$4<W=$4>:?$4@ .A$4B%C$4D6E$4$4FHG$4$4$$$$N Q Q Q QG s7u9:!MP7O9O9 :c2';e=e=>X6GI@k^ Z`Z`ae(:GI@k gmgmn^};8GI=H?@kD^ `` `` aT'aVcVcdK(;(;((((Vh"#SU  @  k 9]a=/FMO0 9!"6#$W[v-:61 < *ED9B]o#jA}bNyJQJlc="S  ? ' :@/ S_ap rx{J LXZi / #*O =H/ [gix {FHW  N %n 7D^ V]^l oAO  M  $] 5;J IPQ[ ^mnx {FHR   +  .34Q  T[\y  |HJg  +  .:;M  P\]o  r{}M  OXZj  L ), 9D_  ds@Sfy&K   r}