OKi;LSrSSKJr SSKrSSKrSSKJrJr SSKJ r SSK J r J r J r JrJrJrJrJr SSKJrJr SSKJrJr SS KJrJr \ (aSS KJrJr SS KJ r \"S 5r!\S r""SS\#5r$"SS\$5r%"SS\$5r&S#Sjr'\"SS9"SS\ \!55r(\"SS9"SS\ \!55r)\"SS9"SS\ \!55r*\"SS\ \!55r+\"SS \ \!55r,"S!S"\ \!5r-\)\!\*\!-\-\!-r.g)$z)Types for setting agent response formats.) annotationsN) dataclass is_dataclass) UnionType) TYPE_CHECKINGAnyGenericLiteralTypeVarUnionget_args get_origin)BaseToolStructuredTool) BaseModel TypeAdapter)Self is_typeddict)CallableIterable) AIMessageSchemaT)pydanticr typeddict json_schemac$\rSrSr%SrS\S'Srg)StructuredOutputError#z(Base class for structured output errors.r ai_messageN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r d/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/langchain/agents/structured_output.pyrr#s 2r(rc0^\rSrSrSrSU4SjjrSrU=r$)MultipleStructuredOutputsError)zZRaised when model returns multiple structured output tool calls when only one is expected.cb>XlX l[TU] SSR U5S35 g)zInitialize `MultipleStructuredOutputsError`. Args: tool_names: The names of the tools called for structured output. ai_message: The AI message that contained the invalid multiple tool calls. z:Model incorrectly returned multiple structured responses (z, z) when only one is expected.N) tool_namesrsuper__init__join)selfr.r __class__s r)r0'MultipleStructuredOutputsError.__init__,s9%$   *%&&B D r()rr.)r.z list[str]rrreturnNoner!r"r#r$r%r0r' __classcell__r3s@r)r+r+)sd   r(r+c0^\rSrSrSrSU4SjjrSrU=r$)StructuredOutputValidationError<zXRaised when structured output tool call arguments fail to parse according to the schema.cV>XlX lX0l[TU]SUSUS35 g)zInitialize `StructuredOutputValidationError`. Args: tool_name: The name of the tool that failed. source: The exception that occurred. ai_message: The AI message that contained the invalid structured output. z,Failed to parse structured output for tool 'z': .N) tool_namesourcerr/r0)r2r?r@rr3s r)r0(StructuredOutputValidationError.__init__?s5# $ G {RUV\U]]^_`r()rr@r?)r?strr@ Exceptionrrr5r6r7r9s@r)r;r;<sb a ar(r;cUS:XaU$[U5nURU5$![a/n[US[ U55nSUSU3n[ U5UeSnAff=f)aeParse data using for any supported schema type. Args: schema: The schema type (Pydantic model, `dataclass`, or `TypedDict`) schema_kind: One of `'pydantic'`, `'dataclass'`, `'typeddict'`, or `'json_schema'` data: The data to parse Returns: The parsed instance according to the schema type Raises: ValueError: If parsing fails rr!zFailed to parse data to z: N)rvalidate_pythonrCgetattrrB ValueError)schema schema_kinddataadaptere schema_namemsgs r)_parse_with_schemarOMsq"m# %(3F(;&&t,, %fj#f+> ( Rs;o1$%s& A*AAF)initc\rSrSr%SrS\S'S\S'S\S'S\S 'S \S 'S rS \S'S S S S.SSjjrSrg ) _SchemaSpeciz%Describes a structured output schema.type[SchemaT] | dict[str, Any]rHrBname description SchemaKindrIdict[str, Any]rN bool | Nonestrict)rUrVrZc XlU(aX lO[U[5(aC[ UR SS[ [ R"55SS355UlO=[ [USS[ [ R"55SS355UlU=(d= [U[5(aUR SS5O[USS5=(d SUl X@l [U[5(aS Ul Xl g[U[5(a2[U[5(aS Ul UR!5Ul g[#U5(a&S Ul [%U5R5Ul g['U5(a&S Ul [%U5R5Ul gS [U5S3n[)U5e)a>Initialize `SchemaSpec` with schema and optional parameters. Args: schema: Schema to describe. name: Optional name for the schema. description: Optional description for the schema. strict: Whether to enforce strict validation of the schema. Raises: ValueError: If the schema type is unsupported. titleresponse_format_Nr!rVr%rrrrzUnsupported schema type: zS. Supported types: Pydantic models, dataclasses, TypedDicts, and JSON schema dicts.)rHrU isinstancedictrBgetuuiduuid4rFrVrZrIrtype issubclassrmodel_json_schemarrrrG)r2rHrUrVrZrNs r)r0_SchemaSpec.__init__s& I  % %FJJw2B3tzz|CTUWVWCXBY0Z[\DIGFJ:J3tzz|K\]_^_K`Ja8bcdDI& &$'' JJ}b )D17R   fd # #,D %   % %*VY*G*G)D %779D  & ! !*D *62>>@D  & ! !*D *62>>@D ,DL>:de S/ !r()rVrrUrHrIrZ) rHrTrU str | NonerVrirZrYr5r6) r!r"r#r$r%r&rZr0r'r r(r)rRrRis/ ** I 1FK=  "&" 5".5" 5"  5"  5" 5"5"r(rRcl\rSrSr%SrS\S'S\S'S\S'S \S 'S S S .SSjjrSrg ) ToolStrategyz0Use a tool calling strategy for model responses.*type[SchemaT] | UnionType | dict[str, Any]rHzlist[_SchemaSpec[Any]] schema_specsritool_message_contentWbool | str | type[Exception] | tuple[type[Exception], ...] | Callable[[Exception], str] handle_errorsNT)rorqc^XlX lX0lSU4SjjmT"U5Vs/sHn[U5PM snUlgs snf)zwInitialize `ToolStrategy`. Initialize `ToolStrategy` with schemas, tool message content, and error handling strategy. c3 ># [U5[[1;a#[U5HnT"U5ShvN M g[ U[ 5(a0SU;a*UR S/5HnT"U5ShvN M gUv gNSN7f)z5Yield leaf variants from Union and JSON Schema oneOf.NoneOf)rrr r r`rarb)rHargsub_iter_variantss r)rw-ToolStrategy.__init__.._iter_variantss&!i%77#F+C-c222,&$''Gv,=!::gr2C-c2223L3 3s"3BB AB;B <B BN)rHrr5z Iterable[Any])rHrorqrRrn)r2rHrorqsrws @r)r0ToolStrategy.__init__sC  $8!* 6DF5KL5K[^5KLLsA)rqrHrnro)rHrmrorirqrpr5r6r!r"r#r$r%r&r0r'r r(r)rkrksr: 66$((*$$ ` ,0 (,"M:"M) "M % "M "M"Mr(rkcX\rSrSr%SrS\S'S\S'SS.S S jjrS S jrS rg)ProviderStrategyiz9Use the model provider's native structured output method.rTrH_SchemaSpec[SchemaT] schema_specNrZc,Xl[XS9Ulg)zInitialize `ProviderStrategy` with schema. Args: schema: Schema to enforce via the provider's native structured output. strict: Whether to request strict provider-side schema enforcement. rN)rHrRr)r2rHrZs r)r0ProviderStrategy.__init__s &v=r(cURRURRS.nURR(aSUS'SUS.nSU0$)znConvert to kwargs to bind to a model to force structured output. Returns: The kwargs to bind to a model. )rUrHTrZr)rerresponse_format)rrUrrZ)r2rrs r)to_model_kwargs ProviderStrategy.to_model_kwargss`$$))&&22'     " "$(K !"&+ "?33r()rHr)rHrTrZrYr5r6)r5rX) r!r"r#r$r%r&r0rr'r r(r)r}r}sBC **!%%& # >. > >  >4r(r}c\\rSrSr%SrS\S'S\S'S\S'\S S j5rSS jrS r g )OutputToolBindingi3aInformation for tracking structured output tool metadata. This contains all necessary information to handle structured responses generated via tool calls, including the original schema, its type classification, and the corresponding tool implementation used by the tools strategy. rTrHrWrIrtoolc U"URUR[URURUR S9S9$)zCreate an `OutputToolBinding` instance from a `SchemaSpec`. Args: schema_spec: The `SchemaSpec` to convert Returns: An `OutputToolBinding` instance with the appropriate tool created ) args_schemarUrV)rHrIr)rHrIrrrUrVclsrs r)from_schema_spec"OutputToolBinding.from_schema_specGsF%%#//'33 %%'33  r(cD[URURU5$)zParse tool arguments according to the schema. Args: tool_args: The arguments from the tool call Returns: The parsed response according to the schema type Raises: ValueError: If parsing fails )rOrHrI)r2 tool_argss r)parseOutputToolBinding.parse[s"$++t/?/?KKr(r Nrr~r5r)rrXr5r) r!r"r#r$r%r& classmethodrrr'r r(r)rr3s? +*M NL  & Lr(rcd\rSrSr%SrS\S'S\S'\S Sj5rS Sjr\ SS j5r S r g )ProviderStrategyBindingijaInformation for tracking native structured output metadata. This contains all necessary information to handle structured responses generated via native provider output, including the original schema, its type classification, and parsing logic for provider-enforced JSON. rTrHrWrIc8U"URURS9$)zCreate a `ProviderStrategyBinding` instance from a `SchemaSpec`. Args: schema_spec: The `SchemaSpec` to convert Returns: A `ProviderStrategyBinding` instance for parsing native structured output rHrIrrs r)r(ProviderStrategyBinding.from_schema_spec{s#%%#//  r(cURU5n[R"U5n[UR URU5$![a1n[ UR SS5nSUSUS3n[ U5UeSnAff=f)aParse `AIMessage` content according to the schema. Args: response: The `AIMessage` containing the structured output Returns: The parsed response according to the schema Raises: ValueError: If text extraction, JSON parsing or schema validation fails r!rz1Native structured output expected valid JSON for z, but parsing failed: r>N) "_extract_text_content_from_messagejsonloadsrCrFrHrGrOrI)r2responseraw_textrJrLrMrNs r)rProviderStrategyBinding.parses::8D )::h'D"$++t/?/?FF )!$++z;LMKCK=Q''(c, S/q (  )sA B,BBcURn[U[5(aU$/nUHn[U[5(arUR S5S:Xa%SU;aUR [US55 MRSU;a0[US[5(aUR US5 MMMUR [U55 M SR U5$)zExtract text content from an `AIMessage`. Args: message: The AI message to extract text from Returns: The extracted text content retextcontentr_)rr`rBrarbappendr1)messagerpartscs r)r:ProviderStrategyBinding._extract_text_content_from_messages// gs # #NA!T""55=F*v{LLQvY0!^ 1Y<(E(ELL9.)F^ SV$wwu~r(r Nr)rrr5r)rrr5rB) r!r"r#r$r%r&rrr staticmethodrr'r r(r)rrjsK +*M    G8r(rc8\rSrSr%SrS\S'SSjrSrg) AutoStrategyiz=Automatically select the best strategy for structured output.rTrHcXlg)z&Initialize `AutoStrategy` with schema.NrH)r2rHs r)r0AutoStrategy.__init__s  r(rN)rHrTr5r6r{r r(r)rrs%G **$. r(r)rHrTrIrWrJrXr5r)/r% __future__rrrc dataclassesrrtypesrtypingrrr r r r r rlangchain_core.toolsrrrrrtyping_extensionsrrcollections.abcrrlangchain_core.messagesrrrWrCrr+r;rOrRrkr}rrrResponseFormatr r(r)rs/" /   :+021 )  H I I  %: &a&;a"% *%9C%KY%%8 U"''"U"U"p >M77#>M>MB +4ww'+4+4\ 3L(3L 3Ll Qgg.Q Qh 77# g&)9')BB\RYEZZ>r(