`gj9.dZddlmZddlZddlZddlZddlmZddlm Z m Z m Z m Z m Z ejeZeGddZddZdd Zdd Zdd Zdd Zdd ZddZddZddZddd ddZy)uShared ``/blueprint`` command logic for CLI, TUI, and gateway. The conversational counterpart to the dashboard's Automation Blueprints form. Where a surface has a screen, the user fills a form (dashboard / GUI app) and the API calls ``fill_blueprint`` -> ``create_job`` directly. Where a surface is just a chat line, the user picks a blueprint by name and the agent asks for what it needs — pick a blueprint by name and the agent asks you for what it needs, one question at a time (the messaging-assistant model: pick a blueprint → it asks you a couple things → done). Subcommand shapes: /blueprint list the catalog /blueprint name-match a blueprint, then SEED THE AGENT to ask the user for each value conversationally /blueprint slot=val … fill + create the cron job directly (the deterministic dashboard / docs / power- user shortcut — no agent turn) The ```` form is forgiving: exact key, unique prefix, or fuzzy match all resolve; an ambiguous query lists the candidates; an unknown one suggests the closest. When it resolves, the handler returns an ``agent_seed`` — a natural- language instruction built from the blueprint's typed slots + schedule/prompt templates — that the calling surface feeds to the agent as a normal user turn (gateway: rewrite ``event.text`` and fall through, the ``/steer`` pattern; CLI: a one-shot pending seed the main loop runs). The agent then asks for each slot and calls the existing ``cronjob`` tool. No new tool, no second job engine. Parsing is shlex-based so quoted free-text values (``criteria="from my boss"``) survive. ) annotationsN) dataclass)AnyDictListOptionalTuplec*eZdZUdZded<dZded<y)BlueprintCommandResultaOutcome of a ``/blueprint`` invocation. ``text`` is always shown to the user. When ``agent_seed`` is set, the calling surface should ALSO hand that seed to the agent as the user's next turn (the blueprint was matched and now the agent gathers the slot values conversationally). When ``agent_seed`` is None the command is fully handled (catalog listing, direct create, or an error) and nothing is sent to the agent. strtextNz Optional[str] agent_seed)__name__ __module__ __qualname____doc____annotations__rK/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/blueprint_cmd.pyr r +s I $J $rr c||S ddlm}|d}|d}|r|r|||dxsd|dxsddSy#t$rYywxYw)Nr)get_session_envHERMES_SESSION_PLATFORMHERMES_SESSION_CHAT_IDHERMES_SESSION_CHAT_NAMEHERMES_SESSION_THREAD_ID)platformchat_id chat_name thread_id)gateway.session_contextr Exception)explicitrrrs r_resolve_originr$;sx  ;"#<=!":; $",-GHPD,-GHPD       s4< AAci}g}|D]R}d|vr;|jd\}}}|j}|r|j||<B|j|T||fS)zJSplit ``slot=value`` tokens from bare tokens. Returns (values, leftovers).=) partitionstripappend)tokensvalues leftoverstokk_vs r _parse_kvr1OsqFI #:mmC(GAq! AGGIq  9 rc ddlm}m}|xsdjj sdgfS| }||gfS|Dcgc]Y}|j j j s,t fd|jjDr|[}}t|dk(r|dgfSt|dkDrd|fS|Dcgc]X} |j j vs8 |jj vs |jj vr|Z}}t|dk(r|dgfSt|dkDrd|fS|Dcgc]}|j }}tj |dd }t|dk(r ||dgfSt|dkDrd|D cgc] } ||  c} fSdgfScc}wcc}wcc}wcc} w) uResolve a free-typed blueprint name to a blueprint. Returns ``(blueprint, candidates)``: * exact key or unique prefix / fuzzy match -> ``(blueprint, [])`` * ambiguous (2+ plausible) -> ``(None, [candidates…])`` * no plausible match -> ``(None, [])`` Matching is forgiving because chat-line users type the name (unlike the dashboard/Discord where it's picked): exact key first, then case-insensitive prefix on key or title, then a difflib fuzzy pass. r)CATALOG get_blueprintNc3\K|]#}|jj%yw)N)lower startswith).0wqs r z"match_blueprint..xs"@1qwwy##A&@s),g333333?ncutoff)cron.blueprint_catalogr3r4r(r7keyr8anytitlesplitlen descriptiondifflibget_close_matches) queryr3r4exactrprefixsubstrkeyscloser.r;s @rmatch_blueprintrR^s> "##%A Rx ! E by 55;;= # #A & @ @ @ F  6{aay"} 6{QV|  aggmmo!5amm>Q>Q>S9S F 6{aay"} 6{QV|# #aAEE #D #  % %a3 ?E 5zQU1X&** 5zA~61mA&666 8O9 $ 7sAG AGG5Gc>ddlm} ||S#t$rYywxYw)Nr)_humanize_schedulez on a schedule)rBrTr") blueprint_hs rrTrTs&?)} s  c ddlm}g}|jd|jd|jd|j |jd|jd|j D]}d|jd |jd g}|jr;|jd d jtt|j|jd vr|jd|jd|jr|jd|jr|jd|j|jdj||jd|jd|j dt#|d|j$ddj|S)alBuild the natural-language fill-request the agent will act on. The agent reads this as a normal user turn, asks the user for each unfilled slot one at a time, then calls the ``cronjob`` tool with the cron expression it builds from the blueprint's ``schedule_template`` and the rendered prompt. Defaults are stated so the agent can offer them. r)WEEKDAY_PRESETSz Set up the 'z+' automation for me (automation blueprint 'z'). r5zgAsk me for each of these, one at a time, offering the default in brackets if I don't have a preference:z-  ()u — one of: , )Nr5z [default: ]z (optional) — zOnce you have my answers, create the job by calling the cronjob tool with action='create'. Build the schedule as a cron expression from this template: `zR` (fill {minute}/{hour} from the chosen time, {dow} from the weekday choice using z, {interval_min} from any interval). Use this exact prompt for the job (substituting my answers into any {slot} placeholders): "zA". Confirm the schedule and what it will do before you create it. )rBrXr)rErCrHslotslabelnameoptionsjoinmapr defaultoptionalhelpschedule_templatedictprompt_template)rUrXlinessbitss rbuild_blueprint_seedrns7E LL y'( MM?$y445 7 LL LL 1__ $QWWIRxq)* 99 KK- #c1992E(F'GH I 99J & KK+aii[2 3 :: KK & 66 KK%x( ) RWWT]# $ LL LL $6678_-./66?6O6O5PQI  I  99U rcddlm}dg}|D]K}|jd|jd|j|jd|j M|jddj |S) Nrr3uLAutomation Blueprints — `/blueprint ` and I'll ask you what I need:  • r]z z Tip: `/blueprint ` walks you through it. Power users can pass values inline, e.g. `/blueprint morning-brief time=08:00`.r^)rBr3r)rCrErHrc)r3rkrMs r _fmt_catalogrrsy. \ ]E - vaeeWE!''34 tAMM?+,- LL J 99U rcd|dg}|D]-}|jd|jd|j/|jddj|S)N'u,' matches several blueprints — which one? rqr]z5 Run `/blueprint ` with one of the names above.r^)r)rCrErc)rK candidatesrkrMs r_fmt_candidatesrvs`D E FE 5 vaeeWE!''345 LLIJ 99U rcddlm}|Dcgc]}|j}}tj|xsdj |dd}d|d}|r|d d j |zd zz }|d z }|Scc}w) Nrrpr5r>g?r?z!No automation blueprint matches 'z'.z Did you mean: r[?z# Run /blueprint to see the catalog.)rBr3rCrIrJr7rc)rKr3rMrPrQmsgs r _fmt_no_matchrzs." #aAEE #D #  % %u{&9&9&;TQs SE -eWB 7C   499U#33c99 00C J $sA4c|dk(ryy)zPost-create management hint. /cron is a CLI-only slash command; on gateway platforms the user manages jobs by asking the agent (cronjob tool) or from the dashboard.clizManage it with /cron.z-Ask me to list, pause, or remove it any time.r)surfaces r _manage_hintr~s%& :rr|)originr}c > ddlm}m} tj|xsd}|st tS|d}t|dd\}} t|\} } | +| rt t|| St t|S|s4t| } d| j d t#| d } t | | S || |t%| } ddlm}|di|}|j-dxs|j-dd}t d| j d|rd|dndzd|j-dddt/|zS#t$r+}tj d|t dcYd}~Sd}~wwxYw#t$r|xsdj}YwxYw#|$r3}t d | j d|d| j&dcYd}~Sd}~wwxYw#t$r.}tj d|t d|cYd}~Sd}~wwxYw)uDispatch a ``/blueprint`` invocation. Returns a :class:`BlueprintCommandResult`. When ``agent_seed`` is set the caller must feed it to the agent as the next user turn; otherwise the command is fully handled and only ``text`` is shown. ``args`` is everything after ``/blueprint``. ``origin`` lets a directly created job deliver back to the chat it was set up from. ``surface`` (``"cli"`` | ``"gateway"``) picks the right wording for follow-up hints — ``/cron`` only exists on the CLI. r)fill_blueprintBlueprintFillErrorz#blueprint catalog import failed: %sz4Automation Blueprints are unavailable in this build.Nr5r=z Setting up 'z' (u%). I'll ask you a couple of things…)r)rzCan't set up 'z': z Or just run /blueprint z! and I'll ask you for the values.) create_jobzblueprint create_job failed: %szFailed to create the job: schedule_displayschedulez Scheduled 'rtrYrZz, delivering to deliverrz. r)rBrrr"loggerdebugr shlexrF ValueErrorrrr1rRrvrzrnrErTr$rC cron.jobsrgetr~)argsrr}rrer*rKr+ _leftoverrUruseedr specrjobscheds rhandle_blueprint_commandrsJ"^M &TZR( %ln55 1IE!&*-FI+E2Iz )/%*LM M%mE&:;; #I.9??+3/A)/L.MN1 1 &dt<< i8OPH( 4  GG& ' C488J+CE ! ioo&a(!Rwa=r + TXXi:;2l7>S=T U V c ^ :A>%&\]]^ &*"##%&8  %Y__-S4&&/mm_4U W    H 6:%(B1#&FGGHsjEFF*G% F E>8F>FF'&F'*G"/(GG"G"% H.#HHH)r#Optional[Dict[str, Any]]returnr)rzTuple[Dict[str, str], list])rKr rzTuple[Optional[Any], List[Any]])rr )rKr ruz List[Any]rr )rKr rr )r}r rr )rr rrr}r rr )r __future__rrIloggingr dataclassesrtypingrrrrr getLoggerrrr r$r1rRrTrnrrrvrzr~rrrrrs># !33   8 $  % %  %( 3l+\  ;(, H H %H H  Hr