vj]iSrSSKrSSKrSSKrSSKrSSKrSrSrSr Sr Sr Sr S r S rSqSq"S S \5rS rSS jrSrSrSrSSjrSSjrSr\ 4SjrSrSrSrS SjrS!Sjr Sr!Sr"S"Sjr#g)#aPush BidBrain's finished daily list into Dealer OS. Dealer OS (Steven's and Mark's own multi tenant dealership platform, CarDealer-OS/Dealer_OS, live at cardealeros.co.uk) shows BidBrain's live auctions page. The agreed shape of the integration (Steven 2026-09-01, from the "BidBrain today, Dealer OS tomorrow" briefing, widened 2026-09-02 once Dealer OS was chosen as the ONLY screen people use) is the kitchen and the restaurant: BidBrain stays on the Mac and keeps every scraper and the whole buying brain, and pushes ONLY finished, decided results across, priced and gated cars with everything the cockpit itself draws for them, never raw listings and never the gate or pricing logic itself, so there is exactly one set of buying rules that can never drift apart. Standard library only, like the rest of this project: a plain HTTPS POST of one JSON document, gzipped on the wire, authenticated with a shared secret in a bearer header. The secret lives in dealer_config.py on this Mac (DEALER_OS_API_KEY) and, as one entry of BIDBRAIN_API_KEYS, in Dealer OS's own environment, never in either repo's shared code. The receiving end (the "letterbox", POST {DEALER_OS_BASE_URL}/api/bidbrain/ cars) is Dealer OS's, built against the contract in DEALER_OS_PUSH.md at the repo root. A push runs AFTER the run has written its own pages, records its own separate run_status and site_health, and never raises into run(). The document is a superset of the schema 1 contract: every field added since (2026-09-02, the cockpit rebuild inside Dealer OS) is additive, so schema_version stays 1 and an older Dealer OS simply ignores what it does not know. The one naming trap, kept on purpose so nothing already built breaks: suggested_bid_comps is the COUNT of comparable sales; the list itself lives under drawer.compmatch.comps. Nz/api/bidbrain/carsi!i = c\rSrSrSrSrg)DealerOsPushError]z>A push that did not land, with a message written for a person.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r 8/Users/stevendouglas/BidBrain/bidbrain/dealer_os_push.pyrr]sHrrc.SSSS.RUS5$)zCarwow's reserve is CAP Clean standing in (2026-08-19), Dealer Auction's is Retail minus Margin (2026-08-20), DealerWay's is the current bid (2026-08-24): the cockpit labels each honestly, so does Dealer OS.z Trade valuezAT Tradez Bid price)carwow dealerauction dealerwayReserve)get) platform_keys r_reserve_labelras# $j$ &&)c, &BCrc SSKJn URnURnU=(d 0nUR UR 5nUR U5nUb3URb&URbURUR- OSnSn Sn UbZURb&URbURUR- OUn URb URO URn [[USS5=(d /5n UR(a,URU ;aU RSUR5 [SUR =(d /55n SR#UR$=(d SR'5R)55=(d Sn 0SU _SU =(d UR*=(d S_S UR,=(d S_S UR/UR,UR,5=(d S_S UR0=(d S_S UR3UR,UR05=(d S_S UR4=(d S_SUR7U5=(d S_SSR#SU =(d SUR,=(d SUR0=(d SUR4=(d S455R95_SUR:_SUR<_SUR>_SUR@_SURB=(d S_SURD=(d S_SURGU5_SURH=(d S_0SURKU5_SURMU5=(d S_SURN=(d S_SURP=(d S_S[SURT5_SUR_S [WU5_S!URX_S"URZ_S#UR\=(d S_S$UR =(d S_S%U_S&UR*=(d S_S'UR=(d S_SU _S(UR^=(d S_S)[US)S5=(d S_E0S*[US*S5=(d S_S+[US+S5=(d S_S,[S[US,S-55_S.UR`_S/[URb=(d /5_S0[UR =(d /5_S1UVVVs/sH upnXUS2.PM snnn_S3UcSOURdURfURhURURURjURURb&URbURUR- OSS4._S5U_S6U _S7U _S8[US9S5_S:[US;S5_S<[US=S5_S>[US?S5_S@[S[USAS-55_SB[USCS5=(d S_E[USDS5[USES5=(d S[S[USFS-55U [S[USGS-55URmX5[oU =(d S[US*S5=(d S4U5SSH.E$s snnnf)Ia_One car's decided result as a plain dict. Only fields BidBrain has actually read or computed: an unread figure is None, never a guess, the same golden rule the cockpit's own cards follow. Private, never persisted, card annotations (the _ prefixed attributes daily_run's _annotate sets on the Car object) are read with getattr so a car that never went through _annotate still packs, just without them. Everything the cockpit card's own data attributes and drawer carry is here too, derived by the SAME render.py helpers the cockpit uses, so Dealer OS never re-derives a label, a family or a headroom figure.rrenderN photo_urlsc3r# UH-oRS5=(d URS5v M/ g7f)z Seen beforezIn bothN) startswith).0fs r car_record..s+fWdQRll=1LQ\\)5LLWd57regkeymake make_canonmodel model_family derivativenamesearch c38# UHnU(dM Uv M g7fNr r!xs rr#r$s!C'=@A1'=s  yearmileageownersgradefuel transmission gearbox_labelengine engine_label engine_litres body_typeservice_historyvat_qualifyingreserve reserve_label cap_cleandistance_mileslocationplatformr listing_url photo_urlauction_ends_at keeper_start selling_vrm cazana_url glass_checkedFstatusreasonsflagsinsights)kindtopictextpricing) glass_retail cazana_retail calc_glass calc_cazanagoverning_valuegoverning_sourcemax_bidspreadheadroomcazana_headroom cazana_price suggested_bid_suggested_bidsuggested_bid_comps_suggested_bid_n stock_level _stock_level stock_count _stock_count taste_match _taste_match taste_score _taste_score _pick_rank _pick_score_is_new_starred) pick_rank pick_scoreis_new seen_beforestarreddrawer sightingsdeep)8bidbrainrcarrV_platform_classsource _insight_rowsr]rBrZr[listgetattrrIinsertanyrQjoinr'uppersplitrHr)rr+ _model_familyr-_titlelowerr5r6r7r8r9r:_gearbox_labelr< _engine_label_engine_litresr?r@boolrArrDrErFrJrOrPrWrXrYr\ _drawer_data _sightings)ar* sale_daterr{pplatrowsr_r`ragalleryrur'ktr4s r car_recordrjs* %%C A!rJ  ! !#** -D    "DMaii&; @WS[[(^b OL} }}8S[[=TMMCKK7[c () (Aq}}qGXGX 73 d39r:G }}g5q#--(fWXW^W^WdbdWdffK ''377=b'')//1 2 :dCM  sM  s-coo-M   DM  jnnSXXsxx8@D M  "d M  ,,SXXsyyAIT M  cnn,M   c"*dM  #((Csyb#((.b#))/r'*~~';'=CCCH57M  M  3;;M  #**M  M   DM  ((0D!M " ..s3#M $ #**$%M & ,,S1'M ( ..s3;t)M * S]]*d+M , 3..6$-M . $s112/M 0 3;;1M 2 -3M 4 S]]5M 6 #,,7M 8 CLL(D9M : CJJ&$;M < =M > s.$?M @ S]]*dAM B gCM D 3..6$EM F ^T:BdGM H wsM26>$IM J gc<4<KM L gc?EBCMM N !((OM P 4 R(QM R aggm$SM T tLtGA!aQ7tLUM V 194NN__,,== 00 ! 2 2yy++7AIIEuM v wsND9wM x wsND9yM z tGC?@{M | wsNA6;!}M ~S,5c=!49wsIu56"Z78%%a. GC,M,SQS TV_`YM MTMs[1cU(a/[[U[5(aUOU45(aU(d/$SSKJn UR X5$![ a /s$f=f)zireg is the listing plate, or the listing plate and the original plate underneath, see db.sighting_plates.rdb)r isinstancetuplerzrsighting_history Exception)r'rrs rrrsU cC!7!7#cVDDI ""322  sA A A chU(d0$SSKJn URU5$![a 0s$f=f)zZEvery answered deep read for the sale, keyed (platform_key, key), never fatal to the push.rr)rzrdeep_reads_forr)rrs r _deep_readsrs9    ++  s " 11cSSKJn URnSRUR=(d SR 5R 55=(d SnU=(d UR=(d SUUR=(d SUR=(d SURU5=(d SURURUR[URUR 55UR =(d SURUR 5UR=(d SUR"=(d S[%UR&=(d /5S.$)zThe slim record of a car the rules held back (2026-09-10): enough to recognise it, every reason it was held on, and the link. No pricing, no drawer, one photo: these are read now and then, not bid on.rrr&N)r(r'r)r+r.r5r6rBrCrGrrHrIrP)rzrr{rr'rrrHr)r+rr5r6rBrr|r}rIrrP)rrr{r's rheld_back_recordrs %%C ''377=b'')//1 2 :dC-coo- D"d c"*d;;;;'(>(>szz(JKJJ&$..szz:.$]]*d R( rc 8SSKJn U=(d9 [RR5R SS9R 5n [ U5[ U5-n U RSU 55n U Vs/sHn[XU5PM nn[U5nU(a=UH7nURURS5URS545US'M9 [U=(d SUU [U5[U5[U5US .nU bU Vs/sHn[U5PM snUS 'U=(d 0R5H unnUUU'M UbUUS 'U=(d 0R5H unnUUU'M U$s snfs snf) aThe whole document one push sends: the sale date the list is for, when it was built, which dealership it belongs to, every shortlisted and held car, and (page) the page level facts the cockpit is drawn from plus (state) the Mac's own stars, hides and saved views so the two screens stay in step. Rejected cars were left out until 2026-09-10; now they go as the slim held_back list (held_back_record) so Steven can check nothing is held back unnecessarily and release one with a reason. A car with no reg is still sent, Dealer OS keys on listing_url as a fallback the same way this project's own detail cache does. partial=True marks a mid run push (one platform finished, others still to come).rr) microsecondc3L# UHoRRv M g7fr2)r{r))r!rs rr# build_payload..s'BEq Es"$rr(ryN)schema_version dealer_namer generated_atpartial shortlistedheldcars held_backstate)rzrdatetimenowreplace isoformatr_canon_make_maprrrSCHEMA_VERSIONrlenritems) shortlistrrrrpagerrrecordsrrwheneveryr*rrrycdocrvs r build_payloadr sz  U8,,002::q:ISSUD Od4j (E'''BE'BBJ:? @%QJqi 0%D @ y !D A!%%"7u!FGAfI)"*d=9~D  C9BCA,Q/CK""$1A% G B%%'1A( J1 A"Ds <FFc SSKJn U=(d 0n[U=(d /5n U=(d 0n 0n U RH5n U R U 5[ U R U S55X;S.X'M7 /nU=(d /H nURU[U5S.5 M" UR S5=(d 0nU=(d 0UU=(d /Vs/sHn[U5PM snU RR5VVs0sHunnU[U5_M snn[U R5U UR S5=(d SUR S 5U RUR S 5UR S 5UR S 5UR S 5UR S5S.UR5VVs0sHunnUS;dMUU_M snnS.U=(d 0U RVVVVVs/sHunnnnnUUUUUS.PM snnnnnUUS. $s snfs snnfs snnfs snnnnnf)aCThe page level block: the settings that shape the cockpit page, the health notices, the summary counts, the model families for the Model filter, which filters apply to which platforms, and the platforms themselves. settings is the raw db.get_settings() dict merged over the defaults by the caller (daily_run._get_settings).rrT)labelenabledhidden)rUrS _updated_at details_stylerwdefault_price_ceilingtheme_bg theme_price theme_pill theme_icon theme_sidebar)bgpricepilliconsidebar)rr)rr top_pickstheme updated_at)r(rsitegateextra) summarynoticesmodel_families filter_scopelenient_filters platformssettings integrations run_checksrunbidbrain_version)rzrr_ALL_PLATFORMS_platform_labelrrappend _notice_kind _FILTER_SCOPEr_LENIENT_FILTERSTOP_PICKS_LABEL_RUN_MODAL_CHECKS)rrrrplatform_enabledhidden_connectionsrrrrrrrr(kindsnupdatedr4rrlabrrrs r page_recordr5s# ~2H $* +F$"GI$$#)#9#9##>%)'++c4*@%A$'M3 % Emm aa9:ll=)/RG=b-;-Ar-AC-Aq47-AC060D0D0J0J0LM0L1DG0LM 7 78%\\/:Fh%-\\2I%J//ll:.!m4 \2 \2#<<8 -4MMOOODAq#MM 1a4OO  %*8>8P8PR8P41c4u !3dUZ[8PR,3 DMORsH5H:  I*IIcSSKJn URS5(agURU/5up#pEU(agU(agU(agg) zSame buckets the cockpit's own bell and Run button use (render._categorize_notices): "ok" for the happy path confirmation, else glass, dealerkit, platform or other.rrzAll okglass dealerkitrGother)rzrr _categorize_notices)rUrrrrG_alertss rrrgsE  v*0*D*DdV*L'Eh  rcURS/5Hn[URS5[5(a USSUUS'URS5n[U[5(dMZ[URS5[5(dMUSSUUS'M URS/5H4n[URS5[5(dM)USSUUS'M6 U$)Nrrrwphotos purchases)rrrdict)payloadrrdrs r _trim_photosrxs [[ $ aeeL)4 0 0 obq1AlO EE(O a  :aeeHot#D#DH+bq/AhK % [[b ) aeeL)4 0 0 obq1AlO* Nrc0nURS5n[U[5(a4[U5[:a![U5[- US'US[US'URS5n[U[5(a4[U5[ :a![U5[ - US'US[ US'U(aXS'U$)aPThe last, most aggressive resort on a genuinely large day (2026-09- 21), after the photo trim above still is not enough: cap held_back and lost_bids to their own CAP_*_TO length, dropped_counts says exactly how many of each were left off so nothing reads as the whole list when it is not. held_back is already sorted cheapest first, so the cap keeps the ones nearest the buying threshold; lost_bids keeps the most recent (its own newest first order). purchases, under_offer and every settings block are never touched here, Dealer OS draws its own Purchases and settings pages from them whole.rN lost_bidscapped)rrrrCAP_HELD_BACK_TOCAP_LOST_BIDS_TO)rdroppedrrs r _cap_listsrsG K(I)T""s9~8H'H"9~0@@ ():*:;  K(I)T""s9~8H'H"9~0@@ ():*:; # Nrr c\[R"[R"U[S95$)zdA plain dict Dealer OS can parse: anything json cannot carry (a date, a Decimal) becomes its string.)default)jsonloadsdumpsstr)rs r _jsonablers ::djjC0 11rcU=(d 0nS[UVs0sHowURU5_M snURS5=(d 0URS5=(d /U=(d 0[U=(d /5[U=(d /5[U5U=(d 0R5VVs0sHupxU[ U51Sk-;dMXx_M snnS.50$s snfs snnf)aEverything the Mac Studio's own Settings page shows, so Dealer OS can draw a settings page from the push alone (2026-09-03, step three). buying_rules carries the current value of every rule Dealer OS may send back; the read only blocks (fee_bands, banned_engine_names, run_schedule) are shown, never accepted back. updated_at is the Mac's own stamp per key, the newest wins comparison. mac_settingsrr>r purchase_flowpurchase_columnsrpurchase_dropdowns) buying_rulesrr fee_bandsbanned_engine_names run_scheduleeditable_sectionsr)rrrrset) mergedrrrrrbuying_rule_keysrrs rmac_settings_blockrs\rF I3CD3CaFJJqM)3CD >28b$jj)=>D"_"#$7$=2>\/R0!"34)3)9r(@(@(BZ(Bs#348Y YYqt(BZ '   DZsC* ;C/C/c SnU"U5U"U5U"U5[U=(d 05U"U5[[U=(d /55[[U=(d /55S.$)aQThe three record lists the Mac's own Purchases, Under Offer and Didn't win pages draw (2026-09-02), sent so Dealer OS can draw the same pages. Each row is exactly what the Mac's own page gets from its API (serve._purchases_with_bias, db.list_under_offer, serve._lost_bids_with_bias), minus local file paths. Read only on the Dealer OS side for now: an edit made there does not come back yet, so the Mac's own Purchases page stays the place to edit a record. purchase_settings carries the per dealership dropdown answers, column layout, journey flags and saved views those pages are built from.c x/nU=(d /GHn[U5R5VVs0sHup4U[;dMX4_M nnn[UR55Hup4[ U[5(a[[ SU55(aDUVs/sH2n[ U[ 5(aURS5(aM0UPM4 snXS'Mu[ U[ 5(dMURS5(dMSXS'M UR[U55 GM U$s snnfs snf)Nc3r# UH-n[U[5=(a URS5v M/ g7f)/N)rrr r3s rr#/records_block..clean..s,.cab\]z!S/A/WallSVFW/Wabr%r!z/Users/) rrLOCAL_PATH_KEYSrrrrr rr)routrrrrr4s rcleanrecords_block..cleansA"&q'--/N/$!Qo5M/ANQWWYa&&3.cab.c+c+c'(!As1C1C UXHYAqD3''ALL,C,CAD ( JJy| $ O\sD1D1/D7 D7)r under_offerrpurchase_settingspurchase_eventslost_bids_viewsdealerkit_stock)rr)rr'rr(r)r*r+r%s r records_blockr,sg 9%[)9%&'8'>B?!1$T/*?R%@A$T/*?R%@A  rc[R"U5RS5nU[R"U[ SS94$)zThe document as the pair that matters: the JSON bytes Dealer OS measures once it has decompressed them, and the gzipped bytes that actually travel. mtime=0 so the same document always compresses to the same bytes, which keeps a push comparable run to run.utf-8r)mtime)r r encodegzipcompressCOMPRESS_LEVEL)rbodys r_encoder5s5 ::g  % %g .D t^1= ==rcX[U5[:=(d [U5[:$)zrEither ceiling blown: the uncompressed size Dealer OS enforces, or the compressed size Vercel will actually carry.)rMAX_BODY_BYTESMAX_WIRE_BYTES)r4wires r_too_bigr:s! t9~ % CT^)CCrc lU=(d SR5RS5nU=(d SR5nU(aU(d [S5e[U5upV[ XV5(a[[ U55upV[ XV5(aY[[ [ U555upV[ XV5(a*[S[U5S-S[U5S-S35e[RRU[-USS S S U3S S .S9nU=(d [RRnU"XsS9n U R5n SSS5 [U5q[U5qW (d0$[.R0"U R#S55$!,(df  NS=f![RRan U R S;a [S5U eU R S:Xa[S[S35U eSn U R5R#SS5SSR5n O![$a Of=fU R S;a(SU ;dSU ;a[SU R SU 35U e[SU R S3U (a S U 3-5U eS-5U eSn A f[RR&a!n [S!USU R(35U eSn A ff=f![2a S"U R#SS5SS0s$f=f)#aJPOST the document. Returns whatever JSON the server answered with ({} on an empty 2xx). Raises DealerOsPushError, in plain words, on a missing setting, a refused secret, a missing letterbox, or a network failure. opener exists only so the tests can hand in a fake; real callers never pass it. The body is gzipped: Dealer OS's own route decompresses it and measures the size afterwards. A document over either ceiling has its photo galleries trimmed and is built once more; still too big it also has held_back and lost_bids capped (_cap_lists) and is built a third time before giving up.r&r!ztDealer OS is not set up on this Mac: DEALER_OS_BASE_URL and DEALER_OS_API_KEY both need a value in dealer_config.py.zThe list is too big to send (iz KB, z KB compressed, even with the photo galleries trimmed and the held back and lost bids lists capped). Dealer OS accepts about 19 MB once uncompressed.POSTzapplication/jsonr1zBearer BidBrain)z Content-TypeContent-Encoding Authorizationz User-Agent)datamethodheaders)timeoutN)iizDealer OS refused the shared secret. The DEALER_OS_API_KEY in dealer_config.py must be this dealership's own token from Dealer OS's BIDBRAIN_API_KEYS.izDealer OS has no letterbox at zl yet, so there is nowhere to send the list. That route is Dealer OS's side to build (see DEALER_OS_PUSH.md).r.rr)iiznot valid JSONr>zDealer OS could not read the compressed list, so its side is older than the version that accepts a gzipped push. It needs updating first. It answered z: zDealer OS answered z to the push.r0zCould not reach Dealer OS at raw)striprstriprr5r:rrrurllibrequestRequestAPI_PATHurlopenreaderror HTTPErrorcodedecoderURLErrorreasonLAST_BODY_BYTESLAST_WIRE_BYTESr r  ValueError) rbase_urlapi_keyrCopenerr4r9reqdo_openresprDedetails rpushr^sFB%%'..s3H}"##%G 7 GH H!JD\'23  D   L,A!BCJD##'3CI4E3Fe4yD()*PPQQ .. 8$v!3%+$+G9"5)+ ! ,C ...GK S *d))+C+>$iO$iO  =zz#**W-..I+ * << ! !c 66Z #*+12 2 66S=#0 ;11289 9 VVX__Wi8#>DDFF    66Z %5%?CUY_C_$//0vvhbBCIJ J !!&& 76Qvh< Z\ab cWY Z\ab c << K+H:Rz BDIJ KK =szz'95ds;<<=sz F?F.!F? $L. F<8F?<F??L AK  1IK  IK IA+K  !L +LL !L32L3)NN)r&NNNFNN)NNNNNNNN)NNNNr r )NNNNNNN)N)$rrr1r  urllib.errorrGurllib.requestrJrr3r7r8TRIM_PHOTOS_TOrrrSrT RuntimeErrorrrrrrrrrrrrr#rrr,r5r:r^r rrrds>    I ICk\  2LPPT)XFJMQ+//d"+ 42 W[OQ,W[NR"J>D I=r