`gjnjUdZddlmZddlZddlmZmZddlmZm Z m Z m Z gdZ Gdde Zehd Zd d d d Zded<edGddZedGddZddZeddddddddZed d!d"d#d$d%edegd&'ed(d)d*d+d,d-ed.dd/d0d1d23ed4d5d6d78egd9'ed:d;dd?ed@edAddBdCdDEegdF'edGdHdId#dJdKedLegdM'edNdOdPdQd>dRedSd5dTdU8edVedWdXdYdZeej1Eegd['ed\d]d^d#d$d_ed`egda'edbdcdddQd>deedfd5dgdhdijed@edWdXdYdXeej1EedkddldmdnEegdo'edpdqdrdQd>dsedSd5dtdu8edvedWdXdYdZeej1Eegdw'edxdydzdQd>d{ed|d5d}d~8ededWdXdYdZeej1Eegd'eddddQddeddd/ddd3edddddd3edddddd3egd'edddd=d>dedddddEedddddEedddddEededAddBdCdDEegd'edddd#d>dedfd5dd8ededWdXdYdXeej1Eegd'eddddQd>dededWdXdYdZeej1Eegd'edddd#d$dedddddEedegd'gZded<eDcic]}|j4|c}ZddZdd„ZdddÄZdddĄZddńZ ddƄZ!ejDdǫZ#ddddddmdd͜Z$dd΄Z%ddϜ ddЄZ&ycc}w)uAutomation Blueprints — parameterized automation blueprints with typed slots. A *blueprint* is a one-place definition of an automation that every surface renders natively: * Dashboard / GUI app -> a form (one field per slot) * CLI / TUI / messenger -> a pre-filled ``/blueprint`` slash command * Agent -> a seed prompt; it asks for any blank/ambiguous slot * Docs catalog -> a copy-paste command + a ``hermes://`` deep-link The single source of truth is the slot schema below. ``blueprint_form_schema`` emits what a form renderer needs; ``blueprint_slash_command`` emits the flattened one-line command; ``fill_blueprint`` validates user-supplied values and turns a blueprint into a ``cron.jobs.create_job`` kwargs dict (so there is no second job engine). The form-where-there's-a-screen / agent-fills-where-there's-a-chat split both consume this same module. Design choice: users never type raw cron. A blueprint carries a fixed recurrence in ``schedule_template`` and parameterizes only the human-friendly parts (time-of-day, weekday set). Blueprints needing full flexibility expose a ``text`` slot named ``schedule`` that passes through verbatim. ) annotationsN) dataclassfield)AnyDictListOptional) BlueprintSlotAutomationBlueprintCATALOG get_blueprintblueprint_form_schemablueprint_slash_commandblueprint_deeplinkblueprint_catalog_entryfill_blueprintBlueprintFillErrorWEEKDAY_PRESETSceZdZdZy)rz1Raised when supplied slot values fail validation.N)__name__ __module__ __qualname____doc__I/root/.hermes/venv/lib/python3.12/site-packages/cron/blueprint_catalog.pyrr-s;rr>enumtexttimeweekdays*z1-5z0,6)everydayr weekendszDict[str, str]rT)frozenc~eZdZUdZded<ded<ded<dZded<d Zd ed <d Zd ed<dZded<dZ d ed<ddZ y)r z'A single fillable field on a blueprint.strnametypelabelNrdefaultrtupleoptionsFbooloptionalhelpTstrictct|jtvr&td|jd|jdy)Nzunknown slot type z (slot ))r( _SLOT_TYPES ValueErrorr')selfs r __post_init__zBlueprintSlot.__post_init__Ms7 99K '1$))gdii[PQRS S (r)returnNone) rrrr__annotations__r*r,r.r0r1r7rrrr r <sM1 I I JGSGUHdD#N FDTrr ceZdZUdZded<ded<ded<ded<ded<ded<ee Zd ed <d Zded <dZ ded<dZ ded<y)r z%A parameterized automation blueprint.r&keytitle descriptioncategoryschedule_templateprompt_template)default_factoryzList[BlueprintSlot]slotsorigindeliver_defaultrr+skillstagsN) rrrrr:rlistrCrErFrGrrrr r RsV/ H JM!&t!rLjs fL' %!rdeliverrzWhere to deliver?rD)rDlocaltelegramdiscordemailFzorigin = the chat you set this up from (or your configured home channel when created from the dashboard); local = save only, no message; or any connected platform namer'r(r)r*r,r.r1r0z morning-briefzMorning briefingzVA short daily briefing: today's calendar, weather, and anything urgent waiting on you.dailyz{minute} {hour} * * *zProduce a concise morning briefing for the user: today's calendar events, the local weather, and any urgent items. Keep it short and scannable. If no data sources are connected, give a brief good-morning with the date and offer to connect calendar/email.)rSbriefing)r<r=r>r?r@rArCrGzimportant-mailzImportant-mail monitorzYCheck your inbox periodically and ping you ONLY about mail that actually needs attention.rQz*/{interval_min} * * * *a<Check the user's inbox for new messages since the last run. Surface ONLY mail matching: {criteria}. Score candidates with the urgency classifier and deliver only what clears the bar; if nothing does, respond with [SILENT]. Requires a connected mail source; if none is configured, explain how to connect one and stop. interval_minz How often?30)15rV60zminutes between checks)r'r(r)r*r,r0criteriaruOnly notify me if the mail…zIneeds a reply today, is from my manager or family, or mentions a deadline)r'r(r)r*)rQmonitorz weekly-reviewz Weekly reviewzGA weekly recap: what got done, what's still open, and what's coming up.weeklyz{minute} {hour} * * {dow}zProduce a weekly review for the user: what was accomplished this week, still-open items, and next week's calendar. Pull from connected sources. Keep it tight.z18:00dayz Which day?sunday)r]mondayfridaysaturday)r'r(r)r*r,)r[reviewz workday-startzWorkday start reminderz4A weekday nudge with your agenda and top priorities.z{minute} {hour} * * 1-5zGive the user a brief weekday start-of-day nudge: today's calendar and the 1-3 highest-priority things to focus on, inferred from recent context and any task tools. Encouraging, short, one message.z09:00)rSfocuszcustom-reminderzCustom reminderz9A recurring reminder in your own words, on your schedule.generalzRemind the user: {what}whatuRemind me to…ztake a break and stretchz14:00 recurrencer z Repeat onr")reminderzevening-winddownzEvening wind-downz]An end-of-day check-in: tomorrow's calendar at a glance and anything you should prep tonight.uGive the user a short evening wind-down: tomorrow's calendar, any early commitments to prep for, and one gentle nudge to wrap up loose ends from today. Keep it calm and brief — one message. If no calendar is connected, just offer a friendly sign-off and the weather for tomorrow.z21:00)rSeveningz news-digestzTopic news digestuyA recurring digest on a topic you care about — deduped against what was already sent, so only genuinely new items land.uSearch the web for new and noteworthy items about: {topic}. Dedupe against what you sent in previous runs — only include genuinely new developments. Deliver a tight digest of at most {count} bullets, each one line with a link. If nothing new since last run, respond with [SILENT].topicz What topic?zAI and technologyz,a subject, product, person, or search phraserKcountzHow many bullets?5)3rj8)digestresearchzbill-renewal-watchzBills & renewals reminderuqA heads-up before a recurring payment, subscription renewal, or due date — so nothing auto-charges by surprise.zRemind the user about an upcoming payment or renewal: {what}. Phrase it as an actionable heads-up (e.g. 'review or cancel before it renews'), not just a notification. One short message.z What's due?z%my streaming subscription renews soonz10:00)rffinancez habit-checkinzHabit check-inzMA recurring nudge to keep a habit on track and reflect on whether you did it.zNudge the user about their habit: {habit}. Ask whether they did it today, keep it warm and non-judgmental, and offer a one-line word of encouragement. One short message.habitz Which habit?z20 minutes of readingz20:00)rp wellbeingzhydration-movezHydration & movement nudgezFA periodic nudge during the day to drink water, stand up, and stretch.z20 {start_hour}-{end_hour}/{interval_hours} * * 1-5zSend the user a brief, friendly nudge to drink some water, stand up, and stretch for a moment. Vary the wording each time so it doesn't feel robotic. One short line.interval_hours1)rs2rkzhours between nudges start_hourz Start hour9)7rlrv10z%first hour of the active window (24h)end_hourzEnd hour17)16rz1819z$last hour of the active window (24h))rqrbz meal-planzWeekly meal planzkA weekly meal plan plus a consolidated grocery list, tuned to your diet and how much time you have to cook.zBuild the user a meal plan for the coming week: {meals} per day, suited to a {diet} diet and roughly {effort} cooking effort. Include a consolidated grocery list grouped by aisle. Keep blueprints simple and skimmable.dietzDiet?no restrictions)r vegetarianveganz high-proteinzlow-carbmealszMeals per day? dinner only)rzlunch and dinnerz all threeeffortzCooking effort?quick)rmedium ambitiousz17:00)r[foodz learn-dailyzDaily learning dripz[One bite-sized lesson a day on a topic you want to learn, building progressively over time.zTeach the user one bite-sized lesson about: {topic}. Build on earlier lessons so it progresses rather than repeating. Keep it to a couple of short paragraphs with one concrete example, and end with a single question to check understanding.uLearn about…zSpanish vocabularyz08:30)learningrSzgratitude-journalzGratitude & reflection promptzFA gentle evening prompt to reflect on the day and note what went well.uSend the user a short, warm reflection prompt for the end of the day — invite them to note one thing that went well, one thing they are grateful for, and one small win. If they reply, acknowledge it kindly. One message.z21:30)rq reflectionz on-this-dayzOn-this-day discoveryzQA daily dose of curiosity: a notable historical event, fact, or word for the day.uGive the user one interesting '{flavor}' item for today — keep it short, surprising, and genuinely interesting. One or two sentences, no filler.flavorz What kind?on this day in history)rzword of the dayz science factzquote of the dayz07:30)rS curiosityzList[AutomationBlueprint]r c,tj|SN)_CATALOG_BY_KEYget)r<s rr r s   s ##rc|j|j|j|jt |j |j Dcgc]f}|j|j|j|jt |j|j|j|jdhc}dScc}w)zIEmit the JSON a form renderer (dashboard / GUI) needs for this blueprint.rR)r<r=r>r?rGfields)r<r=r>r?rHrGrCr'r(r)r*r,r.r1r0) blueprintss rrrs}} ,,&&Y^^$__  99 ?JJ((      sA+B?c|xsi}d|jg}|jD]}|j|j|j}||dk(r|j r=d}t |}|jdk(sd|vrd|jddzdz}|j|jd|dj|S)uBuild the flattened ``/blueprint slot=val …`` command string. Uses each slot's default when ``values`` is omitted, so the docs/dashboard can show a ready-to-paste command. Free-text slots are quoted. z /blueprint r/r "z\"=) r<rCrr'r*r.r&r(replaceappendjoin)rvaluespartsrvalsvals rrrs \rF9==/ * +E __ )jj+ ;#)zzC3x 66V sd{c511C7D xq'( ) 88E?rcddlm}m}|xsi}i}|jD]E}|j |j |j }|dvs.t|||j <G|r d||znd}d||j|S)z>Build the ``hermes://blueprint/?slot=val`` deep-link URL.r)quote urlencodeNr/?r/zhermes://blueprint/) urllib.parserrrCrr'r*r&r<)rrrrqueryrrqss rrrs- \rF E __%jj+ j HE!&&M%&+# % B y}}!5 6rd ;;rc|j}|jdrZtd|jDd}|r |jndxs%|j ddj d}d|dSd |vrTtd |jDd}t |r |jndxsd }d |vrd nd}|d k(r|dS|d|dStd|jDd}|r |jnd}d |vr |rd|SdSd|vrEtd|jDd}|r |jndxsd}|r |r|d|S|rd|SdS|rd|Sy)zGA short human-readable description of when a blueprint runs (defaults).z*/c3@K|]}|jdk(s|yw)rUNr'.0rs r z%_humanize_schedule..+sJ>1I1JN/rzevery z minutesz{interval_hours}c3@K|]}|jdk(s|yw)rrNrrs rrz%_humanize_schedule../sL;K1K1Lrrsz* * 1-5z weekdays, r/z every hourz hoursc3@K|]}|jdk(s|yw)rN)r(rs rrz%_humanize_schedule..3sEAAFFf4DaErz weekdays at z every weekday{dow}c3>K|]}|jdvs|yw))r\reNrrs rrz%_humanize_schedule..8sWqqvvAV7VWsz at zat z on a schedulez daily at )r@ startswithnextrCr*splitr&)rschediveveryscope time_slotwhenday_slots r_humanize_scheduler's  ' 'E  JiooJD Q!tN C0@0C0I0I0KA0Nwh''U" LiooLd S2RZZ47C8 )U 2 ',|% #VE7&v9VVEEtLI )9  tDE(,dV$A/A%WIOOWY]^%-!!2<" TWD' '#TF|88 4&!! rctit||jt|t|t |dS)uUnified serializable shape for a blueprint — used by the docs generator and the dashboard API. Combines the form schema, the ready-to-paste slash command, the deep-link URL, and a human-readable schedule. )schedule scheduleHumancommandappUrl)rr@rrr)rs rrrBs?    * //+I6*95$Y/  rz^([01]?\d|2[0-3]):([0-5]\d)$0rtrk46)r]r^tuesday wednesdaythursdayr_r`c|j}d|vr|drt|dSi}|jd}d|vsd|vr|s tdtj t|j }|std|dtt|jd|d <tt|jd |d <d |vrd |vrbt|jd dj}|tvr$td|ddjtt||d<nUd|vrLt|jddj}|tvrtd|t||d<nd|d<d|vr[t|jddj }|jrt|dkrtd|d||d<tjd|D]} | |vs| |vs t|| || < |j di|S#t"$r} td| | d} ~ wwxYw) zBFill the schedule_template placeholders from resolved slot values.rrz{minute}z{hour}za time is requiredz invalid time u — use HH:MM (24h)rhourminuterrer"zunknown recurrence u — one of , dowr\r/z unknown day r!z{interval_min}rUrzinvalid interval u" — minutes as a positive integerz \{(\w+)\}z$schedule template missing value for Nr)r@r&rr_TIME_REmatchstripintgrouplowerrr _DAY_TO_DOWisdigitrefindallformatKeyError) rrrrepltime_valmpresetr\rr'es r_resolve_scheduler[sf  ' 'EVz 26*%&&Dzz&!HUh%/$%9: : NN3x=..0 1$}XL@T%UV V3qwwqz?+V S_-X% 6 !L*=>DDFF_,()&< /@Z?[\*&1DK f_fjj+,224C+%(<w)?@@%c*DKDK5 NB/ 0 6 6 8zz|s2w!|$'8>`%ab b!^  </+ t VD\*DJ+Tu||#d## T #Gs!KLRSSTs*H<< III)rDc |jDchc]}|j}}tt||z }|rSt dt |dkDrdndddj |ddj d|jDi}|jD]}|j|j|j}|d vr3|jr;t d |jd |jd |jd k(r|jr~|jrrt||jDchc] }t|c}vrDt |jd|ddj tt|j|||j< t!||} |j"j$di|} | | |j(|jd|j*d} |j,rt/|j,| d<||| d<| Scc}wcc}w#t&$r} t d| | d} ~ wwxYw)uValidate ``values`` and return ``cron.jobs.create_job`` kwargs. Missing required (non-optional) slots raise BlueprintFillError naming the slot, so a form can show field errors and the agent knows what to ask. Unknown slot names are rejected (a typo'd ``tiem=07:15`` must not silently create a job with the default time). Enum values are checked against their options. The result is passed straight to ``create_job`` — no second schema. z unknown slotrrr/z: ru — valid: c34K|]}|jywrrrs rrz!fill_blueprint..s8YA8Ysrzmissing required value: z (r3rru not allowed — one of z#blueprint prompt missing value for NrM)promptrr'rMrFrDr)rCr'sortedsetrlenrrr*r.r)r(r1r,r&maprrArrr=rErFrH) rrrDrknownunknownresolvedraworrrspecs rrrs9'__ -QVV -E -S[5()G #g,"23;2yy!",tyy8Y8Y/Y.Z \   "H __ jj+ * zz$'?xr!''RS%TU U 66V QYY3s8\]\e\eKfWXCPQFKf;f$66(!C7":499SaiiEX;Y:Z[  !H5HS1**11=H= << 9+D+DE D i../X X KM .Lg S #Fqc!JKQRRSs#H+>H07H55 I>I  I)rI)r<r&r8zOptional[AutomationBlueprint])rr r8Dict[str, Any]r)rr rOptional[Dict[str, Any]]r8r&)rr r8r&)rr rrr8r&)rr rrrDrr8r)'r __future__rr dataclassesrrtypingrrrr __all__r5r frozensetr4rr:r r _TIME_DELIVERr+keysr r<rr rrrrrcompilerrrr)rs0rrs.# (,, << <= # $TTT* $.   ': Q 5 %    *1 N W~x( "  &)4 ? #& &8-  f5)    "9< 5 0 'N | B   "+. &J3 RW~x(   O51 vF:K9 ; 'N ! +"o2245    %( !01 $ W~x( !" !K5 / 6+C  'N ! +"o2245  61D_  ! $$A!D )H5 G & ?  'N ! +"o2245    %36 !5 3 6/  'N ! +"o2245    $36 *O 4 %F,_+  !l%:<  fJ&>;  ! $$C"F  A5 $ &)5  61A%H  F2C)I  'N | B  - 0 K&N #,5 = 61A,  'N ! +"o2245    #58 -5 # 'N ! +"o2245   )-0 %%1  F,0=  'N   $-_ g& "gR &--155!8-$0* <6 $ 2::5 6SSss 7T|(, 4"4 4 % 4  4i.sN0