+ Q(i/G^RIHt^RIHt^RIHt^RIHtHtRRlt RRlt RR R llt R R lt RRlt RRRlltRRRlltR #)) annotations) defaultdict)Any) JsonRefError replace_refsc V^8dQhRRRR/#)defsdict[str, Any]returnbool)formats"c/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/utilities/json_schema.py __annotate__r s,O,ON,Ot,Oc`aaaaaaaa S'gR#\\4oRVV3RlloSP4F wrS!W!4K ^^^uooo\\4o RVVVVVVV 3Rllo\;QJd!VVV 3RlS4F 'gK R# R#!VVV 3RlS44#)u6Check whether any definitions in ``$defs`` form a reference cycle. A cycle means a definition directly or transitively references itself (e.g. Node → children → Node, or A → B → A). ``jsonref.replace_refs`` silently produces Python-level object cycles for these, which Pydantic's serializer rejects. Fc$V^8dQhRRRRRR/#)r objrsourcestrr Noner)rs"rr'_defs_have_cycles..__annotate__s! , ,3 , , ,rc<\V\4'dVPR4p\V\4'dFVP R4'd/SV,P VP R4R,4VP4F pS!W14K R#\V\4'dVF pS!WA4K R#R#)$ref#/$defs//N) isinstancedictgetr startswithaddsplitvalueslist)rrrefvitem _collect_refsedgess&& rr*(_defs_have_cycles.._collect_refss c4 ''&/C#s##z(B(Bf !!#))C."45ZZ\a(" T " "d+#rc V^8dQhRRRR/#)r noderr r r)rs"rrr)s    rc<SSV&SPVR4F>pVS9dK SV,S8XdR#SV,S8XgK-S!V4'gK=R# SSV&R#)TFr)r!) r.neighborDONEIN_STACK UNVISITED _has_cycler r+states & rr4%_defs_have_cycles.._has_cycle)sbd  $+Ht#X(*X)+ 80D0D ,d rc3\<"TF!pSV,S8H;'d S!V4xK# R#5iNr).0namer3r4r5s& r $_defs_have_cycles..5s*NuT{i'<>> schema = { ... "$defs": {"Category": {"enum": ["a", "b"], "type": "string"}}, ... "properties": {"cat": {"$ref": "#/$defs/Category", "default": "a"}} ... } >>> resolved = dereference_refs(schema) >>> # Result: {"properties": {"cat": {"enum": ["a", "b"], "type": "string", "default": "a"}}} $defsF)proxies lazy_load) rBr!resolve_root_refr_merge_ref_siblingsrr r>r)rE dereferencedr mergedkr(s& rdereference_refsrO8sBGR011''($FEUK zz'2&$V4@&$''''  l "-9-?-?-AR-ATQQ'\DAD-ALRS ( ''(s*A B/ B)B)$B/)B//CCNc ,V^8dQhRRRRRRRRRR/#) r originalrrLr r visitedset[str] | Noner r)rs"rrrvsA@@@@ @ @  @rc Vf \4p\V\4'Ed%\V\4'EdRV9dVR,pVP4UUu/uFwrVVR9gKWVbK ppp\V\4'dVVP R4'd?VP R4R,pW9d!W9d\W(,WW80,4pV'd\V4p V PV4V #V#/p VP4F&wrW9d\W ,WV4W&K"WV &K( V #\V\4'dp\V\4'dZ\\V4\V44p \VRV VRV RR7UUu.uFwr\WW#4NK uppWR,#V#uuppiuuppi) aMerge sibling keywords from original $ref nodes into dereferenced schema. When jsonref resolves $ref, it replaces the entire node with the referenced definition, losing any sibling keywords like description, default, or examples. This function walks both trees in parallel and merges those siblings back. Args: original: The original schema with $ref and potential siblings dereferenced: The schema after jsonref processing defs: The $defs from the original schema, for looking up referenced definitions visited: Set of definition names already being processed (prevents cycles) Returns: The dereferenced schema with sibling keywords restored NrrrF)strict)rrGr) r=rr r>rr"r$rKupdater&minlenzip)rQrLr rRr'rNr(siblingsdef_namerMresultkeyvaluemin_lenods&&&& rrKrKvs*%(D!!jt&D&D X 6"C)1)9X)9QFW=W)9HX#s##z(B(B99S>"-#(?#6 Gj s G0G+Gc V^8dQhRRRR/#rDr)rs"rrrs$$^$$rcRV9dRV9d|RV9duVR,p\V\4'dVVPR4'd?VPR4R,pVR,pW#9d\ W2,4pW4R&V#V#)a;Resolve $ref at root level to meet MCP spec requirements. MCP specification requires outputSchema to have "type": "object" at the root level. When Pydantic generates schemas for self-referential models, it uses $ref at the root level pointing to $defs. This function resolves such references by inlining the referenced definition while preserving $defs for nested references. Args: schema: JSON schema dict that may have $ref at root level Returns: A new schema dict with root-level $ref resolved, or the original schema if no resolution is needed Example: >>> schema = { ... "$defs": {"Node": {"type": "object", "properties": {...}}}, ... "$ref": "#/$defs/Node" ... } >>> resolved = resolve_root_ref(schema) >>> # Result: {"type": "object", "properties": {...}, "$defs": {...}} rrGtyperrr)rrr"r$r )rEr'r[r resolveds& rrJrJs}0Gv-&2FVn c3  CNN:$>$>yy~b)H'?D/$(! Mrc$V^8dQhRRRRRR/#)r rEr paramrr r)rs"rrrs!rcVPR/4pVPVR4pVfV#W R&WPR.49d9VR,PV4VR,'gVPR4V#)zoReturn a new schema with *param* removed from `properties`, `required`, and (if no longer referenced) `$defs`. propertiesNrequired)r!popremove)rErgpropsremoveds&& r _prune_paramrosx JJ|R (Eiit$G !< :r**z!!%(j!! JJz " Mrc ,V^8dQhRRRRRRRRRR/#)r rEr prune_titlesr prune_additional_properties prune_defsr r)rs"rrrsAjj jj"&j j  jrcaaaaaa a S'gS'g S'gV#\4o \\4oVPR4pR RVVVVV V 3Rlllo S !VRR7S'dV'dVP 4FwrVS !WeR7K R RVVV 3R lllo\VP 44F$pS!V4'dKVP V4K& V'gVP RR4V#) a Optimize JSON schemas in a single traversal for better performance. This function combines three schema cleanup operations that would normally require separate tree traversals: 1. **Remove unused definitions** (prune_defs): Finds and removes `$defs` entries that aren't referenced anywhere in the schema, reducing schema size. 2. **Remove titles** (prune_titles): Strips `title` fields throughout the schema to reduce verbosity while preserving functional information. 3. **Remove restrictive additionalProperties** (prune_additional_properties): Removes `"additionalProperties": false` constraints to make schemas more flexible. **Performance Benefits:** - Single tree traversal instead of multiple passes (2-3x faster) - Immutable design prevents shared reference bugs - Early termination prevents runaway recursion on deeply nested schemas **Algorithm Overview:** 1. Traverse main schema, collecting $ref references and applying cleanups 2. Traverse $defs section to map inter-definition dependencies 3. Remove unused definitions based on reference analysis Args: schema: JSON schema dict to optimize (not modified) prune_titles: Remove title fields for cleaner output prune_additional_properties: Remove "additionalProperties": false constraints prune_defs: Remove unused $defs entries to reduce size Returns: A new optimized schema dict Example: >>> schema = { ... "type": "object", ... "title": "MySchema", ... "additionalProperties": False, ... "$defs": {"UnusedDef": {"type": "string"}} ... } >>> result = _single_pass_optimize(schema, prune_titles=True, prune_defs=True) >>> # Result: {"type": "object", "additionalProperties": False} rGNc ,V^8dQhRRRRRRRRR R /#) r r.objectcurrent_def_namez str | Noneskip_defs_sectionr depthr?r rr)rs"rr+_single_pass_optimize..__annotate__2sH@L@L@L$@L @L @L  @Lrc<aV^28dR#\S\4'EdS 'dSPR4p\V\4'dbVP R4'dKVP R4R ,pV'dS V,P V4MS PV4S 'dYRS9dR\;QJdV3RlR 4F 'gK RM RM!V3RlR 44'dSPR4S 'd'SPR 4RJdSPR 4SP4F`wrgV'd VR 8XdKVR9d3\V\4'dVFpS!WV^,R 7K KOS!WqV^,R 7Kb R#\S\4'dSFpS!WV^,R 7K R#R#)zATraverse schema tree, collecting $ref info and applying cleanups.Nrrrtitlec3.<"TF pVS9xK R#5ir8r)r9rNr.s& rr;D_single_pass_optimize..traverse_and_clean..Os  I sTFadditionalPropertiesrG)ryr)rdrirr>allOfoneOfanyOfrj)rrr) rr r!rr"r$appendr#r@rkr>r&)r.rwrxryr'referenced_defr]r^r)def_dependenciesrrrsrq root_refstraverse_and_cleansf&&& rr1_single_pass_optimize..traverse_and_clean2s{ 2:  dD ! !hhv&c3''CNN:,F,F%(YYs^B%7N'(8??@PQ" n5 43   333     HHW%,HH34=/0#jjl $55*UD:Q:Q %*4QRS!&'ueaiP+d # #"4K$rT)rx)rwc$V^8dQhRRRRRR/#)r r[rvisitingrSr r r)rs"rrrz}s!  #  D rc<VS9dR#SPV.4pV'dBVf \4pW9dR#W0,pVFpW19gK S!W14'gKR# R#)z.is_def_used}ss9$ 033HbA #"uH' #j0(8O&6;'<< $ (8 r)NFrr8)r=rr&r!r>keysrk) rErqrrrsr r[ def_schemarrrrs &fff @@@@r_single_pass_optimizersd ,*E %I4? 5 ::g D@L@LFv6d$(JJL H z E%1  4TYY[)Hx(("*  JJw % Mrc 0V^8dQhRRRRRRRRRRR R/#) r rEr prune_paramszlist[str] | Nonerrr rq dereferencer r)rs"rrrsD(( ("("&( (  (  (rcV'd \V4p\V4pT;'g.Fp\WR7pK \VVVRR7pV#)a Compress and optimize a JSON schema for MCP compatibility. Args: schema: The schema to compress prune_params: List of parameter names to remove from properties prune_additional_properties: Whether to remove additionalProperties: false. Defaults to False to maintain MCP client compatibility, as some clients (e.g., Claude) require additionalProperties: false for strict validation. prune_titles: Whether to remove title fields from the schema dereference: Whether to dereference $ref by inlining definitions. Defaults to False; dereferencing is typically handled by middleware at serve-time instead. )rgT)rqrrrs)rOrJror)rErrrrqrrgs&&&&& rcompress_schemars]*!&)f %F###f2$ #!$? F Mrr8)FFT)NFFF) __future__r collectionsrtypingrjsonrefrrrBrOrKrJrorrrrrrsA"#.,O^;(|@F$N*jZ((r