`gj*/dZddlmZddlZddlmZmZddlmZddl m Z m Z m Z m Z ejeZgdZGdd eZeGd d Zdd Zdd ZddZdd ddZddd ddZddZddddZddZy)uBlueprints: shareable plain-language automations layered on skills + cron. A "blueprint" is NOT a new object type. It is an ordinary skill (a SKILL.md the agent loads) that additionally declares an automation schedule in its frontmatter: metadata: hermes: blueprint: schedule: "0 9 * * *" # presence of `blueprint:` marks it runnable deliver: origin # optional (default "origin") prompt: "..." # optional task instruction for the run no_agent: false # optional Because a blueprint is just a skill, it flows through the ENTIRE existing skills-hub pipeline for free — search, inspect, quarantine, security scan, install, lock-file provenance, audit log, taps, the centralized index, and `hermes skills publish` for sharing. No new source type, no new store, no new transport. This module is the thin bridge between that skill metadata and the existing cron `create_job()` API: * ``parse_blueprint(skill_md_text)`` -> BlueprintSpec | None * ``blueprint_spec_for_installed(name)`` -> BlueprintSpec | None * ``create_blueprint_job(spec, ...)`` -> the created cron job dict * ``export_blueprint(job, body)`` -> a shareable SKILL.md string The dev guide's "Extend, Don't Duplicate" rule is the whole design: the blueprint is a skill, the schedule is a cron job, sharing is the existing publish/tap/ index path. ) annotationsN) dataclassfield)Path)AnyDictListOptional) BlueprintSpecparse_blueprintblueprint_spec_for_installedblueprint_to_job_speccreate_blueprint_jobregister_blueprint_suggestionexport_blueprintBlueprintErrorceZdZdZy)rz7Raised when a blueprint block is present but malformed.N)__name__ __module__ __qualname____doc__C/root/.hermes/venv/lib/python3.12/site-packages/tools/blueprints.pyrr5sArrceZdZUdZded<ded<dZded<dZded <d Zd ed <dZded <dZ ded<dZ ded<e e Z ded<y)r zAParsed ``metadata.hermes.blueprint`` automation spec for a skill.str skill_namescheduleorigindeliverN Optional[str]promptFboolno_agentmodelproviderzOptional[List[str]]enabled_toolsets)default_factoryDict[str, Any]raw)rrrr__annotations__r r"r$r%r&r'rdictr*rrrr r 9s\KOMGS FM HdE="Hm",0)05C5rr ctt|tsy|jdj}|jdsy|dd}|j d}|dk(ry|d|} ddl}|j |}t|tr|SdS#t$r }tjd|Yd}~yd}~wwxYw) zFReturn the parsed YAML frontmatter mapping, or None if absent/invalid.Nuz---z ---rz,blueprint: frontmatter YAML parse failed: %s) isinstancerlstrip startswithfindyaml safe_load Exceptionloggerdebugr,)textstripped after_openendfm_textr4dataes r_split_frontmatterr@Hs dC {{8$++-H   u %!"J //' "C by#G~~g&dD)43t3  CQGs%B B7B22B7ct|}|syt|jddj}|jd}t |t r|jdnd}t |t r|jdnd}|yt |t s t dt|jddj}|s t d t|jd d jxsd }|jd }| t|}t|jd d} |jd} |jd} |jd} | t | ts t dt||||| | rt| jnd| rt| jnd| r| D cgc] } t| c} | Sd| Scc} w)aBExtract a BlueprintSpec from a SKILL.md string, or None if not a blueprint. A skill is a blueprint iff ``metadata.hermes.blueprint`` is a mapping containing a non-empty ``schedule``. Raises BlueprintError if the block exists but is structurally invalid (so a typo surfaces instead of silently no-op'ing). Nnamemetadatahermes blueprintz+metadata.hermes.blueprint must be a mappingrz4blueprint.schedule is required and must be non-emptyr rr"r$Fr%r&r'z6blueprint.enabled_toolsets must be a list when present) rrr r"r$r%r&r'r*) r@rgetstripr0r,rr#listr ) skill_md_textfmrBmetarErFrr r"r$r%r&toolsetsts rr r _s M *B  rvvfb! " ( ( *D 66* D#-dD#9TXXh tF+5fd+C ;'I i &JKK9==R01779H STT)-- 845;;=IG ]]8 $F VIMM*e45H MM' "E}}Z(H}}/0HJx$>UVV $)c%j t*2X$$&7?(3Q#a&3   FJ   4s!Hc ddlm}t|}t |j d|d}|D]9} |j d}t|}|$|js||_ |cSy#t$rYywxYw#t$rYWwxYw)zLocate an installed skill's SKILL.md and parse its blueprint block. Searches the standard skills tree for ``/SKILL.md``. Returns None if the skill isn't found or isn't a blueprint. r) SKILLS_DIRNz**/z /SKILL.mdzutf-8)encoding) tools.skills_hubrPr6rrIglob read_textOSErrorr r)rrPbase candidatespathr9specs rr r s /  Ddii#j\ ;<=J  >>7>3Dt$  ??",K  #    s"A0A?0 A<;A<? B  B rBc |j|j|xsd|j|j|jr |jgnd|j|j |j |jd S)a}Build the ``cron.jobs.create_job`` kwargs dict for a BlueprintSpec. This is the single source of truth for translating a blueprint into a job. Both the direct ``create_blueprint_job`` path and the suggestion path (``register_blueprint_suggestion``) build on it, so a blueprint scheduled now and a blueprint accepted from a suggestion produce an identical job. blueprint:N) r"rrBr skillsr%r&r'r$)r"rrr r%r&r'r$)rYrBs rrrsg++MM6*T__$56<<'+4??#DMM 11MM  r)rrBcFddlm}t||}|||d<|di|S)a'Create the cron job described by a BlueprintSpec via the existing cron API. The blueprint's skill is loaded before the run (cron ``skills=[name]``); the optional ``prompt`` becomes the task instruction. Delivery, model, and toolsets carry through. Returns the created job dict. r) create_jobrZrr) cron.jobsr_r)rYrrBr_job_specs rrrs1%$T5H #  ! !!rc X|jsy ddlm}|d|jdd|jd|j|j r|j dk7rd |j nd zd zd t |d |jd|jS#t$rYywxYw)uTurn an installed blueprint into a pending Suggested Cron Job. Blueprints are source ``blueprint`` of the unified suggestion surface: installing a skill that carries a ``blueprint:`` block does NOT auto-schedule it — it registers a suggestion the user accepts (or dismisses) like any other. Returns the suggestion record, or None if it was skipped (already seen/dismissed, backlog full, etc.). Nr)add_suggestionz Schedule ''zThe 'z' blueprint runs on schedule rz, delivering to rC.rFr\:)title descriptionsourcera dedup_key)rcron.suggestionsrcr6rr r)rYrcs rrrs ??3 4??+1-DOO$$A$-- Q48LLT\\U]E]!$,,0ce g &t,t/q@   sB B)(B))blueprint_namecddl}|xs|jdxsd}djdt|j D}|j dxsd}|jdxst |jd }|jd xs|jd r|d gng}d |i}|jd }|r |d k7r||d <|jdr|d|d<|jdrd|d<|jdr|d|d<|jdr|d|d<|jdr|d|d<|j r)|j jxsdgdddnd} || dddddg|did} |j| ddj } |j xsd|d } d!| d"| d#S)$axRender a shareable blueprint SKILL.md from an existing cron job dict. The inverse of ``create_blueprint_job``: take a cron job a user already built and emit a SKILL.md (with a ``metadata.hermes.blueprint`` block) they can hand to ``hermes skills publish`` to share. ``body`` is the plain-language description / instructions that become the SKILL.md body. rNrBzshared-blueprintrCc3LK|]}|js|dvr|ndyw)-_-N)isalnum).0cs r z#export_blueprint..s#WT 1;Ws"$roschedule_displayrr]skillr rr"r$Tr%r&r'zShared automation blueprint.z1.0.0MITrErF automation)tagsrF)rBrhversionlicenserDF) sort_keys allow_unicodez# z Shared automation blueprint.z--- z ---  ) r4rGjoinrlowerrH_schedule_to_string splitlines safe_dump) jobbodyrlr4rBrr]blueprint_blockr rh frontmatterfm_yaml body_texts rrrs  BSWWV_ B0BD 77WSY__EVW WD ::d  11Dww)*V.A#''*BU.VH WWX  NSWWW5ECL>2F'18&Best-effort render of a parsed schedule dict back to a string.kindcronexprintervalminutes<rzevery hmsecondsisz 0 9 * * *)r0rr,rGint)rrminssecss rrr.s(C (D!||F# 6>hll62x'( ( : ||I&8I./"9>#DBJ33"9>#DBJrs>#(,,   8 $ BZB  6 6  64..b>   8(, " " %"  "  "(:Y]53pr