jSSrSSKJr SSKrSSKJrJrJrJrJ r J r J r J r SSK Jr SSKJrJrJr SSKJr SSKJrJr SS KJrJr SS KJrJr "S S \5r"S S\5r"SS\5r "SS\5r!"SS\5r""SS\5r#S\RH"\#RK5SS9S3r&\ "SS\ 55r'S%Sjr(S&Sjr)"SS 5r*"S!S"5r+\S#r,S'S(S$jjr-g))u FigureCorrector Protocol — what a figure the scan has read leaves on the page. Three things, from one look at the page image: which of the text around the figure is its furniture, which footnote markers the figure's own labels carry, and the note lines printed for each figure, as marker and text. The caller records the markers and notes on the figure's picture. Once the scan has read a figure, the fragments the parse lifted off the same image are that figure read worse, and they are removed. Removing them by tree position only reaches the ones the parse filed under the picture. It files inconsistently: on one page of a quarterly deck it put twenty-two of a page's twenty-six texts beneath the two pictures, and on another it left forty-six of seventy-eight attached to the page body, where nothing looking at the picture's children can see them. Those forty-six included forty axis tick labels. Position on the page does not settle it either, and neither does the text. Both were measured on three decks and both fail, in opposite directions. Sweeping everything printed inside the figure's box deletes real content. On one page the scan bounded two charts as a single figure spanning the width of the page, and inside that box sat a four-line sentence about the portfolio's sensitivity to rate changes that the scan did not transcribe. Sweeping only what the scan's own description repeats deletes nothing useful. A chart's axis runs 0.00 to 5.00 in half steps and the description never mentions those numbers, because a gridline is a ruler marking rather than a fact. All forty ticks would stay. What separates the two is what the text is, which is visible on the page. A tick label sits at the edge of the plot in an evenly spaced series. An annotation sits over the plot and reads as language. So the page image goes to an agent with the description and the candidate fragments, and it names the furniture. It is told to keep whatever it is unsure of. Leaving a tick label in costs a chunk that answers nothing; removing a sentence costs a statement the document no longer makes anywhere. A failed call removes nothing at all. The smaller model is not sufficient here. Asked the same question on the same pages it removed the four-line sentence while its own stated reason called it an annotation, and missed seven of the forty ticks. The stronger model returned all forty and none of the sentence, identically on three runs. The markers come from the same call because they are the same act of reading. A chart's label prints its qualification as a raised digit — "Undepreciated Book Equity Value(1,2)" — and the marker alone says only that a qualification exists, not what it says. Read on its own, that chart states a figure the document elsewhere excludes a noncontrolling interest from and calls non-GAAP. Which markers a figure carries is what a table's correction agent reports for a table, off the table image, for the same reason and against the same distinctions: a raised digit is a marker, a parenthesized negative value is not, and a reference naming a section of the document points somewhere a footnote lookup will never find. A figure had nobody reporting it, and this agent is already looking at the page the markers are printed on. ) annotationsN)AnyDictListLiteralOptionalProtocolSequenceruntime_checkable)logger) BaseModelFieldfield_validator)supports_sampling_temperature)LangSmithTracerusage_metadata_from)COMPOUND_MARKER_REMARKER_GROUP_RE)DEFAULT_LLM_MODEL get_settingscF\rSrSr%Sr\"SS9rS\S'\"SS9rS\S 'S r g ) FigureFzCOne figure the scan read on this page, numbered so markers name it.(Position in the list the agent was shown descriptionintindexz*What the scanner read the figure as sayingstrrN) __name__ __module__ __qualname____firstlineno____doc__rr__annotations__r__static_attributes__r # UHnTRSU0S9v M g7f)r6)updateN) model_copy).0gmarks r) :FigureCorrection.split_compound_markers..s"eJdQ4??8Q-?@Jds!)r6stripr fullmatchextendrfindallappend)rLrMoutsrXs @r)split_compound_markers'FigureCorrection.split_compound_markersshD !!#A!++A.. e/JaJabcJdee 4   r(zDEvery note line printed on the page for a figure, as marker and textz List[Note]notesr N)rMrCreturnrC)rMrErerE)r!r"r#r$rlistrDr&rFr classmethodrPrbrdr'r r(r)r@r@s!&*_"I"aG\ [w/ L0 LYW-.$ZE:r(r@uYou are shown one page of a financial document, a numbered list of the figures a scanner read on that page with the description it wrote for each, and a numbered list of text fragments a parser extracted from inside those figures' regions. You have two jobs. JOB 1 — NAME THE FURNITURE. Decide which fragments are the figure's FURNITURE: text that exists only to mark its scale or label its parts, and carries no fact on its own. Axis tick values, gridline labels, the numbers running up a y-axis or along an x-axis, legend keys and unit markers are furniture. They are already accounted for by the description, which reports what the figure shows. Everything else STAYS. A sentence, a callout, an annotation, a note, a heading, a stated figure that is not a position on an axis — all of these say something and must be kept even when they sit inside the figure. Look at the image. A tick label sits at the edge of the plot in a regular series, evenly spaced, ascending or descending. An annotation sits over or beside the plot and reads as language. That difference is visible and it is what you are judging. Default to keeping. If you are not sure a fragment is furniture, leave it out of your answer. Removing a real statement is far worse than leaving a tick label in. When the fragment list is EMPTY there is nothing to judge: return an empty furniture list and do job 2 only. Never name an index that was not shown to you. JOB 2 — READ THE FOOTNOTE MARKERS. Report every FOOTNOTE REFERENCE MARKER printed on a figure's labels — its title, its axis names, its series names, its data labels — read off the IMAGE, because a raised digit is often lost from extracted text. A marker is a superscript or parenthetical number, letter or symbol pointing at a note: '1', '(1)', a letter 'a', an asterisk '*', a dagger '†' or '‡', a section sign '§'. Write each as it appears, and name the figure it belongs to by its index. These are NOT markers. A parenthesized NEGATIVE VALUE like '(84)'. A unit like '(%)' or '($m)'. A year, a count, or any number that is the thing being stated rather than a pointer away from it. A label naming a NAMED SECTION of the document — '(Note 16)', 'Schedule II' — is written as printed WITH its word, never as a bare number. The kind says what the marker POINTS AT, judged from the page. A marker pointing at a note printed for this figure is 'footnote' — including when that note's own text sends the reader onward. 'For a description of this non-GAAP financial measure, see Selected Definitions on page 40' is a printed note, and the answer is that line, so its marker is 'footnote'. 'section' is for a label that CROSS-REFERENCES a named part of the document whose content lives elsewhere, not in a note printed here. Such a label names its target in words, so its marker is written with that word — 'Note 16', 'Schedule II'. A bare number or letter is never 'section'; a marker with no note printed for it is still 'footnote', and reporting it that way is what says the note is missing. One entry per marker. A label reading 'Book Value(1,2)' carries two markers and gets two entries, never one reading '1,2'. Empty list if the page's figures carry no markers, which is the common case. JOB 3 — READ THE NOTES THEMSELVES. Report every note line printed on the page for a figure, as a PAIR: the note's OWN marker exactly as printed at the start of its line, and its text without that marker. Read them off the IMAGE. The image's formatting decides what is a marker. A general note that opens with no marker — a basis-of-presentation line, a line beginning 'Note:' — gets an EMPTY marker and keeps its full text. A line whose text sends the reader onward is still a note: report it as printed. Notes are printed at the foot of the page, beneath the figure, or beside it. They often run together on one physical line: 'Note: As of 03/31/2026. 1. For a description of this measure, see Selected Definitions on page 40.' is a general note AND note 1 — report them separately. Every marker you reported in job 2 should have a note here unless no line on the page defines it. Report a note even when no marker points at it. Return a JSON object conforming exactly to this schema: )indentuE Return only the JSON object — no prose, no markdown code fences. c.\rSrSrSSjrSrg)FigureCorrectoric # g7fNr )self page_imagefigures fragmentss r)correct_figureFigureCorrector.correct_figuressr NrobytesrpSequence[Figure]rqSequence[Fragment]rer@)r!r"r#r$rrr'r r(r)rkrks'*:GY r(rkc2SRSU55$)z=The page's figures, numbered the way a marker refers to them.z c3Z# UH!nSURSUR3v M# g7f)zFIGURE z: N)rrrVrOs r)rYfigure_block..s%Ng Q]]O.$s!?Yy166(+Ys')r|)rqs r)fragment_blockr"s 99?Y? ??r(ch\rSrSrSrSrSSS\4S SjjrS SjrS SjrSr g) PydanticAIFigureCorrectori'zFigureCorrector backed by pydantic-ai with an Anthropic model. Auth resolution mirrors the other agents: `ANTHROPIC_AUTH_TOKEN` (OAuth subscription) preferred over `ANTHROPIC_API_KEY`. gNc$SSKJn SSKJn SSKJn SSKJn [5Rn U=(d, U R=(d U R=(d [nUb[U5(dSnU=(d U Rn U=(d U Rn U (aSSKJn U "X5n OU (a U"U S9nU"XS9n O [%S 5eXl X@lUcSOU"US 9nU"U [([*US 9Ul[/S S 9Ulg)Nr)Agent)AnthropicModel)AnthropicProvider) ModelSettings)make_oauth_anthropic_model)api_key)providerzyPydanticAIFigureCorrector: neither ANTHROPIC_AUTH_TOKEN nor ANTHROPIC_API_KEY is set. Provide one via env or constructor.) temperature) output_type system_promptmodel_settingszquber-figure-correction)run_name) pydantic_airpydantic_ai.models.anthropicrpydantic_ai.providers.anthropicrpydantic_ai.settingsrrllmfigure_correction_modelmodelrranthropic_auth_tokenanthropic_api_keyquber.agents._oauth_gater RuntimeErrorrr@FIGURE_CORRECTION_PROMPTagentrtracer)rnr auth_tokenrrrrrr llm_settings resolved_auth resolved_keyr anth_modelrrs r)__init__"PydanticAIFigureCorrector.__init__2s &?E6#~)) h==hASAShWh  "+H+O+OK"Gl&G&G @,"@"@  K3EIJ (>H'AJP   &!,!4-T_:` (2)   &/HI r(c^SS[S.SS[U5S.S[U5S.SSS./S./0$) Nmessagessystemrolecontentuserr-)typer-imagez[page image attached])rr~r)rnrprqs r) trace_inputs&PydanticAIFigureCorrector.trace_inputs_sM !.FG"!'g1FG!' 1JK!(2IJ    r(c# SSKJn U"USS9nS[U53nS[U53nURR SUR X#5URS9IShvN nURRXgU/5IShvN n U Rn S U R5S ./[U R5[U R5[U R5[!U R"5S .UlSSS5IShvN UV s1sHoR&iM n n W RV s/sHoR&U ;dMU PM n n [U 5[U R5:waYU(d[(R*O[(R,nU"S [U R5[U 5- [U55 UV s1sHoR&iM nn U RVs/sH8nUR.U;dMUR0R35(dM6UPM: nn[U5[U R5:wa6[(R,"S [U R5[U5- 5 U RVs/sH8nUR.U;dMUR4R35(dM6UPM: nn[7U UUS9$GNGNnGN!,IShvN (df  GN=fs sn fs sn fs sn fs snfs snf![8a4n[(R:"S[U5U5 [7/S9sSnA$SnAff=f7f)Nr) BinaryContentz image/png)data media_typez'Figures the scanner read on this page: z3Fragments extracted from inside the figure region: figure_correction)r assistantr)rrDrFrdusage_metadatazQfigure_correction: ignoring {} verdict(s) naming a fragment not in the list of {}zHfigure_correction: ignoring {} marker(s) naming a figure not in the listrDrFrdzbfigure_correction: LLM call failed; all {} fragment(s) are kept and no markers are recorded exc={})rD)rrr~rrllm_runrrrrunoutputmodel_dump_jsonlenrDrFrdrusageoutputsrr debugwarningr5r6r[r-r@ Exceptionerror)rnrorprqrr describedlistedrresultrrOaskedkeptreportshownmmarksnrdexcs r)rr(PydanticAIFigureCorrector.correct_figurens .:+F>|G?T>UV GW`HaGbc+ 2{{**#T%6%6w%JRVR\R\+#zz~~y%.HII*5&BXBXBZ![ \!$V%5%5!6"6>>2 .&9&,,&G  '00iWWiE0%//D/!77e3CA/DD4yC 0 011 .7FNNg(()CI5 N '..gWWgE. &Y1!((e2CQHXQEY5zS00^'#e*4!' U 1E0AQaffllnQ EU#dEO OEJ1D/Y V 2 LL&I   $b1 1 2s*M38L2%K5&L2)!K> K8 A;K> L2K;L2L/L2?LLBL2L#2L2L(L(;L(A(L2)L-L-"L-( L24M35L28K>;L2>LL  L!L22 M0<)M+%M0&M3+M00M3)rrrr) r Optional[str]rrrrrzOptional[float]reNone)rprvrqrwrezDict[str, Any]rt) r!r"r#r$r%DEFAULT_TEMPERATURErrrrr'r r(r)rr's $$(!%': +J+J"+J +J % +J  +JZ  3232*:32GY32 32r(rcT\rSrSrSrSSSjjrS SjrSrg) MockFigureCorrectorizONames a fixed set of fragment texts as furniture, and fixed markers. For tests.Nc[U=(d S5Ul[U=(d S5Ul[U=(d S5Ul/Ul/Ulg)Nr )rJrDrfrFrdcallsrp)rnrDrFrds r)rMockFigureCorrector.__init__sB Y_"-GMr* %+2& +- +- r(c ># UnURR[U55 URR[U55 UVs1sHoURiM nn[ UVs/sH2oUR UR;dM[URSS9PM4 snURVs/sHowRU;dMUPM snURVs/sHoRU;dMUPM snS9$s snfs snfs snfs snf7f)Nmock)rr1r) rr_rfrprr@r-rDr/rFr5rd) rnrorprq_rOrrrs r)rr"MockFigureCorrector.correct_figures  $y/* DM*")*'Q'*AJAJAffX\XfXfNf7 7!% B 1E0AQ B"jj>jHH,=1j>   +C>sHADD & D1DD*D:D D D'D >D D)rrprDrFrd)NNN)rDzOptional[Sequence[str]]rFzOptional[Sequence[Marker]]rdzOptional[Sequence[Note]]rerrt)r!r"r#r$r%rrrr'r r(r)rrs`Y.2.2*. .* ., .( .  .    *:  GY    r(r)apiroffcU=(d [5RRnUS:Xa [5$US:Xa [ 5$US:Xag[ SU<S35e)zJThe figure corrector for this run, or None when the sweep is switched off.rrrNz)Unknown QUBER_FIGURE_CORRECTION_BACKEND: z. Expected api|mock|off.)rrfigure_correction_backendrr ValueError)backendselecteds r)get_figure_correctorrs]F,.,,FFH5(**6"$$5 @ Lde ffr()rprvrer)rqrwrerrm)rz!Optional[FigureCorrectionBackend]rezOptional[FigureCorrector]).r% __future__rjsontypingrrrrrr r r logurur pydanticr rrquber.agents.factoryrquber.agents.langsmith_tracerrrquber.agents.llm_clientrrquber.settingsrrrr+r/r3r=r@dumpsmodel_json_schemarrkr~rrrFigureCorrectionBackendrr r(r)rs5n# \\\66>NG:WYW""67 gr(