iJSrSSKrSSKrSSKrSSKrSSKJrJrJr SSKJ r \R"S5r \ "\ 5R5RRr\S- rSr"SS 5rS \4S jrSqS \4S jrg) ut Oura Ring API v2 client. Pulls sleep, HRV, steps, exercise, heart rate, and readiness data directly from the Oura API — no Health Connect zip needed. Bill wears his Oura ring, data syncs to Oura cloud, this module pulls it via API and transforms it into dashboard-data.json format. Docs: https://cloud.ouraring.com/v2/docs Auth: Personal Access Token (Bearer token) N)datedatetime timedelta)Pathzoura-api.oura-token.jsonzhttps://api.ouraring.comc,\rSrSrSrSS\4Sjjr\S\4Sj5r S\4Sjr SS \S \ S\ 4S jjr SS \ S \ S\ 4SjjrSS\S\ 4SjjrS\ S\ 4SjrSS\S\ 4SjjrSS\S\4SjjrS S\ S\S\ 4SjjrS!S\S\ 4SjjrS!S\S\ 4SjjrS\ 4SjrSrg)" OuraClientzOura Ring API v2 client.N access_tokencNU=(d UR5UlSUlgN) _load_token_token _available)selfr s //Users/bsyrros/clawd/whatsapp-agent/oura_api.py__init__OuraClient.__init__"s"8d&6&6&8 returncURcsUR(d(SUl[RS5 UR$UR S5 SUl[RS5 UR$UR$![ aonS[ U5;dS[ U5;a[RS U35 SnAgSUl[RS U35 SnAUR$SnAff=f) z/Check if Oura API is configured and accessible.NFz)Oura API: NOT CONFIGURED (no token found)z /v2/usercollection/personal_infoTz"Oura API: ACTIVE (token validated)CERTIFICATE_VERIFY_FAILEDSSLu/Oura API: SSL error (will retry next call) — uOura API: UNAVAILABLE — )rrloggerinfo_api_get Exceptionstrwarning)res r availableOuraClient.available&s ?? ";;"' GH EMM"DE&*DOKK DEt!E2c!f<Q)XYZX['\]$&+DONN%?s#CDDEs-B D6DDDc[R"SS5R5nU(a$[R S[ U5S35 U$[ R5(a|[R"[ R55nURSS5R5nU(a+[R S[ S[ U5S35 U$[R"5S - S - nUR5(acU[ :waY[R"UR55nURSS5nU(a[R S U35 U$[R S[ SUS35 g![a)n[RS[ S U35 S nANS nAff=f![a%n[RSUS U35 S nANS nAff=f)z#Load access token from file or env.OURA_ACCESS_TOKENz Oura token loaded from env var (z chars)r zOura token loaded from z (zFailed to load Oura token from : Nclawdrz Oura token loaded from fallback z"No Oura token found (checked env, z, ))osgetenvstriprrlen TOKEN_PATHexistsjsonloads read_textgetrrrhome)rtokendatar home_paths rrOuraClient._load_token<s -r288:  KK:3u:,gN OL      Tzz*"6"6"894::<KK"9*RE |SZ [\ LIIK'),>>     )z"9 Szz)"5"5"784KK"B9+ NO L  8 BykQRST! T!@ BqcRSS T S!@ 2aSQRR Ss2+A9F!AG G $GG  G?G::G?endpointparamscz[U-n[R"UUSUR3SS.SS9nURS:XaU[ R SURSS S URS S35 UR5 UR5$URS :Xa5[ RS 5 UR5 UR5$URS:waB[ R SURSURSS35 UR5 UR5$)z#Make a GET request to the Oura API.zBearer zapplication/json) AuthorizationAccept)r9headerstimeoutiu&Oura API 401: Unauthorized — token: Nz...iu*Oura API: Rate limited — try again laterzOura API error r&) BASE_URLrequestsr2r status_codererrorraise_for_statusrtextr/)rr8r9urlresps rrOuraClient._api_get^s&!|| #*4;;-!8,    s " LLA$++bq/ARRUVZVaVabdbeVfUgh i  ! ! #yy{   $ NNG H  ! ! # yy{    $ LL?4+;+;*OP Q  ! ! #yy{r start_dateend_datec.U(d[R"5nU(d U[SS9- nURSUR 5UR 5S.5nUR S/5nU(dg[ USS9nURU5$) zL Get sleep data. Returns the most recent night's sleep in dashboard format. days/v2/usercollection/sleeprLrMr5Nc&URSS5$)Ntotal_sleep_durationr)r2)ss r&OuraClient.get_sleep..s1551G+Kr)key)rtodayrr isoformatr2max_transform_sleep)rrLrMr5sessionsmains r get_sleepOuraClient.get_sleepzs zz|H!I1$55J}}7$..0 **,:   88FB'8!KL$$T**rrQc[R"5nU[US9- nURSUR 5UR 5S.5n0nUR S/5HPnUR SS5nUR SS5S - nU(dM3Xu;d XU:dMB[ US 5XW'MR [[UR555$) z(Get sleep durations for the last N days.rPrRrSr5dayr%rUrrO) rrZrrr[r2rounddictsorteditems) rrQendstartr5by_daterVrchourss rget_sleep_seriesOuraClient.get_sleep_seriessjjliT**}}7//+ :   &"%A%%r"CEE0!4t;Es*ecl.B$UA & F7==?+,,rsleepc URSS5nURSS5nSnSnU(a5[R"URSS55R S5nU(a5[R"URSS55R S5n[URSS5S - S 5n[URS S5S - 5[URS S5S - 5[URSS5S - 5[URSS5S - 5S.nURS5nUc8URS05n [U [5(aU RS5nURS[R"5R55UUUSUU(a[US 5S.$SS.$![ [ 4a GNEf=f)u3Transform Oura sleep response → dashboard format. bedtime_startr% bedtime_endZ+00:00%H:%MrUrrdrOdeep_sleep_duration<rem_sleep_durationlight_sleep_duration awake_time)deep_minrem_min light_min awake_min average_hrvNhrv mean_rmssdrcOura)rbedtime wake_time total_hourssourcestagesavg_hrv) r2r fromisoformatreplacestrftime ValueError TypeErrorre isinstancerfrrZr[) rro bedtime_str waketime_strrrrrrhrv_datas rr]OuraClient._transform_sleepsii4 yy3   "001D1DS(1ST]]^ef$22<3G3GX3VW``ahi EII&?  ))M* ?yy+H(D))",,|4IIeTZZ\%;%;%=>"&,3uWa(  :>  +I&   sA8GG('G(c[R"5nU[US9- nURSUR 5UR 5S.5n0nUR S/5H<nUR SS5nUR SS5nU(dM0US:dM8XU'M> [ [UR555$) z*Get daily step counts for the last N days.rPz!/v2/usercollection/daily_activityrSr5rcr%stepsr) rrZrrr[r2rfrgrh) rrQrirjr5rday_datarccounts rget_daily_activityOuraClient.get_daily_activitysjjliT**}}@//+ C   ,H,,ub)CLL!,Esuqy"c - F5;;=)**rc p[R"5nU[US9- n/nURSUR 5UR 5S.5nUR S/5H-nUR USS9nU(dMURU5 M/ [RS[UR S/55S35 URS UR 5UR 5S.5nUR S/5H-n UR U S S9nU(dMURU5 M/ [RS [UR S/55S35 [5n /n UH?n U SSU SSU S3n X;dMU RU 5 U RU 5 MA U RSSS9 U S S$![a#n[RS U35 S nAGN6S nAff=f![a"n[RSU35 S nANS nAff=f)zHGet exercise/workout sessions from both sessions and workouts endpoints.rPz/v2/usercollection/sessionsrSr5session)rzOura sessions endpoint: z entrieszOura sessions endpoint failed: Nz/v2/usercollection/workoutworkoutzOura workout endpoint: zOura workout endpoint failed: r_time duration_mincUSUS4$)Nrr)xs rrW)OuraClient.get_sessions..s1V9ai"8rT)rYreverse )rrZrrr[r2_parse_exercise_entryappendrrr,rrsetaddsort)rrQrirj exercisesr5rVparsedr wseenuniqueexrYs r get_sessionsOuraClient.get_sessionssjjliT**  B==!>#oo/MMOADXXfb)33Ai3H6$$V,* KK23txx7K3L2MXV W A==!=#oo/MMO@DXXfb)33Ai3H6$$V,* KK1#dhhvr6J2K1LHU V uBZL"V*Qr./A.BCC  b!   8$ Gcr{9 B NN   !4  7=f   ,  )29  y  #/  ,  )0   j  +   88FB'"*9(Qeqj%(9TSY.2t9t9D   :s 1 C? CcL[R"5nU[US9- nURSUR 5UR 5S.5nUR S/5nU(dgUSnUR S5UR S5UR S 05S .$) zGet daily readiness score.rPz"/v2/usercollection/daily_readinessrSr5Nscorerc contributors)rrr)rrZrrr[r2)rrQrirjr5entrieslatests r get_readinessOuraClient.get_readiness`sjjliT**}}A//+ D   ((62&ZZ(JJu%"JJ~r:  rc0n/n[R"5nUR5nU(a?XAS'URS5nU(aXQSS'[R SUSS35 URS 5nU(a7XsR5S .US'[R S[U5S35 URS 5nU(a7XR5S.US'[R S[U5S35 UR5n U (a XS'[R SU SS35 UR5n U (a+XS'[R S U RS!535 U(a(X!S$'[RS%[U5S&U35 U$![ a6nURSU35 [RSU3S S 9 S nAGNS nAff=f![ a6nURSU35 [RSU3S S 9 S nAGNzS nAff=f![ a6nURSU35 [RSU3S S 9 S nAGNmS nAff=f![ a6nURSU35 [RSU3S S 9 S nAGNxS nAff=f![ a6nURS"U35 [RS#U3S S 9 S nAGNxS nAff=f)'u Pull all available health data from Oura. Returns dict in dashboard-ready format. Each metric is independent — if one fails, others still return. Also stores errors in result["_errors"] for debugging. ro series14dz Oura sleep: rhzsleep: zOura sleep fetch failed: T)exc_infoN)dailyupdatedrz Oura steps: z dayszsteps: zOura steps fetch failed: )recentrexercisezOura exercise: sessionsz exercise: zOura exercise fetch failed: heart_ratez Oura HR: avg rz bpmz heart_rate: zOura heart rate fetch failed: readinesszOura readiness: rz readiness: zOura readiness fetch failed: _errorszOura fetch completed with z errors: )rrZr`rmrrrrrrr[r,rrrr2) rresulterrorsrZroseriesr rrhrrs rfetch_all_health_data OuraClient.fetch_all_health_dataws  KNN$E"'w..r2397OK0 l5+?*@BC  K++A.E,1oo>O"Pw l3u:,e<=  N))!,I09ooFW%Xz" oc)n-=YGH  P$$&B')|$ mBuI;d;<  O**,I&/{# .y}}W/E.FGH  &9  NN7F }IfXV W a K MMGA3- ( NN6qc:TN J K K MMGA3- ( NN6qc:TN J K N MMJqc* + NN9!=N M N P MML, - NN;A3?$N O P O MMKs+ , NN:1#>N N Os{AF=2AHAI7J AK = G=+G88G= I +H;;I J +I>>J K+KK L +LL )rrr )NN)r)r)r)rO)__name__ __module__ __qualname____firstlineno____doc__rrpropertyboolr!rrfrrr`intrmr]rlistrrrrr __static_attributes__rrrr r s "S4* S Ddd8+D+4+4+.-S-$-(* d* t* \+s+4+*..T.`) 4) ) T) Z 3 t 6 # d .DtDrr rc^^ [5nUR(dgUR5m T R S /5nT (d(U(a S R S USS 55nS U3$g/mUU 4SjnURU5 SSR ST55-n[RU5 U$![a6n[ U5nSU;dSU;a SUSS3sSnA$SUSS3sSnA$SnAff=f)zM Pull data from Oura API and update the dashboard. Returns a summary string. z6Oura API not configured. Run setup_oura_auth.py first.rru9Oura API SSL error — try: pip3 install certifi Detail: NxzOura API error: rz; c3># UHn[U5SSv M g7f)NP)r).0r s r #ingest_oura_data..s#J9IACF3BK9IszOura API calls failed: zNo data returned from Oura API.c,>ST;a#TSUS'TRSTSSS35 ST;aWTSUS'TSSR[R"5R 5S5nTRSUS S 35 S T;a,TS US 'TRS [ TS S 5S35 ST;a/TSUS'TRSTSRSS535 [R"5R 5US'g)NrozSleep: rrrrrzSteps: ,z todayrz Exercise: rrrz Readiness: r?r)rr2rrZr[r,) dashboard total_todaychangesr5s rupdater!ingest_oura_data..updaters' d?!%gIg  NNWT']=%A$B!D E d?!%gIg w-044TZZ\5K5K5MqQK NNW[O6: ;  $($4Ij ! NNZD,)>w)L(MN O JJL224 &rzOura data updated:  c3,# UH nSU3v M g7f)u • Nr)rcs rrrs0Ow!6!ws) r rr rrpopjoin_read_and_writerr) dashboard_managerclientr err fetch_errors err_summaryr&summaryr%r5s @@ringest_oura_datar4s \F ==G.++-88Ir*L  ))#Jbq9I#JJK-k]; ;0G54%%g.$tyy0Ow0O'OOG KK N_ .!f &# -#OPSTXUXPY{[ [!#ds)-- .s)B== C=C8%C=+C82C=8C=c0[c [5q[$)zGet singleton OuraClient.)_clientr rrr get_clientr7s, Nr)rr)r/loggingrDrrrpathlibr getLoggerr__file__resolveparent _BASE_DIRr-rCr rr4r6r7rrrr?s  ..   : & N " " $ + + 2 2 + +  &\\~ =3=B Jr