5ojSrSSKJr SSKJrJrJrJrJrJ r J r SSK J r SSK JrJr SSKJr SSKJrJr SSKJrJr "S S \5rS r\ "S S \55r"SS5r"SS5rSSSjjrg)uM CaptureAdvisor — recommends a Camelot retry adjustment for a flagged capture drop. Camelot occasionally drops printed values during cell assignment even though they sit inside the table region and its text extraction captured them. The measured example: a totals row typeset on a raised baseline splits into two row bands at the default grouping tolerance, and the numbers' vertical center lands exactly on the band boundary, failing the strict containment test on both sides — the row's label and dollar signs survive, its numbers vanish. The drop is detected deterministically (numeric tokens in the region's text layer that appear in no grid cell) and the retry is accepted deterministically (it must recover the missing tokens and lose none). This agent sits between those two checks: given the cropped table image, the extracted grid, and the dropped tokens with their printed lines, it diagnoses the failure and recommends ONE bounded retry adjustment. The agent only proposes; the acceptance gate holds authority, so a wrong recommendation costs one extra Camelot pass and nothing else. ) annotations)AnyDictLiteralOptionalProtocolSequenceruntime_checkable)logger) BaseModelField)supports_sampling_temperature)LangSmithTracerusage_metadata_from)DEFAULT_LLM_MODEL get_settingsc~\rSrSr%Sr\"SS9rS\S'\"SSS S 9rS \S '\"S SSSS9r S \S'\"SSS9r S\S'Sr g) RetryAdvice!zCOne bounded Camelot retry adjustment, with the diagnosis behind it.z}One or two sentences: WHY were these tokens dropped from the grid, grounded in what the image and the provided evidence show.) descriptionstr diagnosiszVertical grouping tolerance in points for the retry. The failed pass used 2. Raise it when one printed row was split into two bands (e.g. raised or offset baselines); keep 2 if row grouping is not the problem.)gelerintrow_tolrizxColumn grouping tolerance for the retry. The failed pass used 0. Change only if the drop is a column-assignment problem.)defaultrrr column_tolstreamz]Parser for the retry. Use lattice only if the table has ruled cell borders drawn on the page.)rrzLiteral['stream', 'lattice']flavorN) __name__ __module__ __qualname____firstlineno____doc__r r__annotations__rr r"__static_attributes__r#:/home/mande/repo/quber/src/quber/agents/capture_advisor.pyrr!swM IIs   V GS   F J,1 k,F (r+ruYou diagnose a table-extraction capture failure and recommend ONE retry adjustment. A region-constrained Camelot pass extracted the grid below, but the listed numeric tokens — visible on the page and present in the PDF text layer inside the table region — did NOT land in any grid cell. You get: 1. The cropped table image (what the page really shows). 2. The extracted grid (markdown). 3. The dropped tokens, each with the full printed line it sits on. 4. The knobs the failed pass used: flavor=stream, row_tol=2, column_tol=0. Recommend the single adjustment most likely to capture the dropped tokens without corrupting the rest of the grid. Ground your diagnosis in the evidence; do not guess beyond it. c2\rSrSrSSjrSrg)CaptureAdvisorVc # g7fNr#)selfcrop_png grid_markdown dropped_linespages r, recommendCaptureAdvisor.recommendXs #sr#N r3bytesr4rr5z Sequence[str]r6rreturnOptional[RetryAdvice])r$r%r&r'r7r*r#r+r,r.r.Vs/$$.1$BO$WZ$ $r+r.cf\rSrSrSrSrS S SjjrS SjrS SjrSr g) PydanticAICaptureAdvisor]uCaptureAdvisor backed by pydantic-ai with an Anthropic vision model. Mirrors `PydanticAIGridLocator`: same auth resolution (`ANTHROPIC_AUTH_TOKEN` preferred over `ANTHROPIC_API_KEY`), greedy decoding so the same failure yields the same recommendation run to run. A failed call returns None — the caller keeps the original grid with its warned gap; a capture repair must never take a table down with it. gNc SSKJn SSKJn SSKJn SSKJn [5RnU=(d UR=(d [nU=(d URn U=(d URn U (aSSKJn U "X5n OU (a U"U S9n U"XS9n O [!S 5eXl U"U ["[$['U5(aU"UR(S 9OSS 9Ul[-S S 9Ulg)Nr)Agent)AnthropicModel)AnthropicProvider) ModelSettings)make_oauth_anthropic_model)api_key)providerzxPydanticAICaptureAdvisor: neither ANTHROPIC_AUTH_TOKEN nor ANTHROPIC_API_KEY is set. Provide one via env or constructor.) temperature) output_type system_promptmodel_settingszquber-capture-advisor)run_name) pydantic_airApydantic_ai.models.anthropicrBpydantic_ai.providers.anthropicrCpydantic_ai.settingsrDrllmmodelranthropic_auth_tokenanthropic_api_keyquber.agents._oauth_gaterE RuntimeErrorr ADVISE_PROMPTrDEFAULT_TEMPERATUREagentrtracer)r2rR auth_tokenrFrArBrCrD llm_settings resolved_auth resolved_keyrE anth_modelrGs r,__init__!PydanticAICaptureAdvisor.__init__is &?E6#~)) @++@/@"Gl&G&G @,"@"@  K3EIJ (>H'AJP    #',U33)T5M5MN   &/FG r+c*SS[S.SSUS./S./0$)Nmessagessystemrolecontentusertext)typeri)rW)r2 user_texts r, trace_inputs%PydanticAICaptureAdvisor.trace_inputss, !m<fi-P,QR  r+c T# SSKJn SUS3SRU5-S-nURU5nURR SXpR S9IShvN nURRXe"US S 9/5IShvN n U Rn S U R5S ./[U R5S .Ul SSS5IShvN U $NzNSN !,IShvN (df  W $=f![a!n [R "SXK5 Sn A gSn A ff=f7f)Nr) BinaryContentz=== Extracted grid === z === Dropped tokens ===  z4 knobs used: flavor=stream, row_tol=2, column_tol=0capture_advise)rRz image/png)data media_type assistantre)rcusage_metadataz?page {}: capture advisor call failed; keeping original grid: {})rMrojoinrlrZllm_runrRrYrunoutputmodel_dump_jsonrusageoutputs Exceptionr warning) r2r3r4r5r6rorkinputsrxresultadviceexcs r,r7"PydanticAICaptureAdvisor.recommends$ .'}o6' ')-=)A BEA A  ""9- {{**+;V::*VVZ]#zz~~ 8 TU '-mm*5&BXBXBZ![ \&9&,,&G WVMWWVVM  NN\^b h s3D((C:CC:"%CC?C C:CC:D(C:CC:C7%C( & C72C:6D(7C:: D%D D( D%%D()rYrRrZ)NNN)rR Optional[str]r[rrFrr;None)rkrr;zDict[str, Any]r9) r$r%r&r'r(rXr`rlr7r*r#r+r,r>r>]s} $$(!% &H&H"&H &H  &HP .1BOWZ r+r>cD\rSrSrSrSSSjjrS SjrSrg) MockCaptureAdvisorz(Returns a canned RetryAdvice. For tests.NcXl/Ulgr1rcalls)r2rs r,r`MockCaptureAdvisor.__init__s 79 r+ct# UnURRU[U5U45 UR$7fr1)rappendlistr)r2r3r4r5r6_s r,r7MockCaptureAdvisor.recommends4  =$}*=tDE{{s68rr1)rr<r;rr9)r$r%r&r'r(r`r7r*r#r+r,rrs72:.1BOWZ r+rNcU=(d [5RRnUS:Xa [5$US:Xa [ 5$US:Xag[ SU<S35e)z;Resolve the capture advisor, or None when disabled (`off`).apimockoffNz'Unknown QUBER_CAPTURE_ADVISOR_BACKEND: z. Expected api|mock|off.)rrQcapture_advisor_backendr>r ValueError)backendselecteds r,get_capture_advisorrs]D,.,,DDH5'))6!##5 >xlJbc ddr+r1)rrr;zOptional[CaptureAdvisor])r( __future__rtypingrrrrrr r logurur pydanticr r quber.agents.factoryrquber.agents.langsmith_tracerrrquber.settingsrrrrWr.r>rrr#r+r,rss(#VVV%>N: ) F $$X$$ TTn   er+