`gjeUdZddlZddlmZmZmZmZmZddlm Z m Z eje Z eeeefgeeeffZdededefdZd Zd eeefdeeeffd Zd eiZeeefed <d ded eeeefdeeeffdZdddddddddd dededeed eeeefdededeededeeeefdefdZdedefdZy)!u[Shared one-off LLM requests for non-conversational helpers. A "one-shot" is a single, stateless model call that runs *outside* any conversation: it never touches a session's history, never breaks prompt caching, and returns plain text. UI surfaces use it for small generative chores — a commit message from a diff, a rename suggestion, a summary — where spinning up an agent turn would be wrong (it would pollute the thread) and hand-rolling an LLM call at every call site would be worse. Two ways to call it: * ``run_oneshot(instructions=..., user_input=...)`` — caller supplies the full prompt. * ``run_oneshot(template="commit_message", variables={...})`` — caller names a registered template and passes its variables; the template owns the prompt engineering so it stays consistent across CLI/TUI/desktop. Model selection rides the same auxiliary plumbing as title generation (:func:`agent.auxiliary_client.call_llm`): pass ``main_runtime`` to inherit the live session's provider/model, otherwise the configured ``task`` (default ``title_generation``) resolves a cheap/fast backend. N)AnyCallableDictOptionalTuple)call_llmextract_content_or_reasoningtextlimitreturncZ|xsd}t||kr|S|d|jdzS)Nu …(truncated))lenrstrip)r r s @/root/.hermes/venv/lib/python3.12/site-packages/agent/oneshot.py _truncater%s7 :2D 4yE <   #5 55uYou write git commit messages. Given a diff of staged changes, write ONE concise Conventional Commits message describing what the change does and why. Rules: - Subject line: type(scope): summary — imperative mood, lower-case, no trailing period, ≤ 72 characters. Types: feat, fix, refactor, perf, docs, test, build, chore, style, ci. - Omit the scope if it isn't obvious. - Add a short body (wrapped at ~72 cols) ONLY when the change needs explanation; skip it for small/obvious changes. - Describe the actual change, never restate the diff line-by-line. - Return ONLY the commit message text — no quotes, no markdown fences, no preamble. variablesctt|jdxsdd}tt|jdxsdd}g}|jr|j d||j d|xsdztt|jd xsdjd }|r|j d |t d j |fS) Ndiffri.recent_commitsizGRecent commit subjects from this repo (match their style/conventions): zDiff to describe: z(no textual diff available)avoidiuYou already proposed the message below and the user wants a different one. Write a NEW message with different wording (and, if reasonable, a different emphasis or scope framing) — do not repeat it: z )rstrgetstripappend_COMMIT_INSTRUCTIONSjoin)rrrecentpartsrs r_commit_message_templater!<s Sv.4"5u =D s9==)9:@bA4 HF E ||~ Vh   LL&$*O2OPQ c)--06B7==? FE   7   U!3 33rcommit_messagePROMPT_TEMPLATESnamecdtj|}|td|||xsiS)zResolve a registered template into (instructions, user_input). Raises KeyError if the template name is unknown so callers fail loudly instead of silently sending an empty prompt. zunknown one-shot template: )r#rKeyError)r$rtemplates rrender_templater(^s<  ##D)H4TF;<< IO $$rrtitle_generationig333333?gN@) instructions user_inputr'rtask max_tokens temperaturetimeout main_runtimer*r+r'r,r-r.r/r0c |rt||\}}|xsdjs|xsdjs tdg} |xsdjr| jd|d| jd|xsddt || ||||} t | xsdj} t | S)aRun a single stateless LLM request and return its text. Provide either a registered ``template`` (+ ``variables``) or an explicit ``instructions`` / ``user_input`` pair. Returns the model's text answer, stripped of surrounding whitespace and any wrapping code fence. Raises RuntimeError when no LLM provider is configured (surfaced from :func:`call_llm`) and KeyError for an unknown template name. rz:run_oneshot requires a template or instructions/user_inputsystem)rolecontentuser)r,messagesr-r.r/r0)r(r ValueErrorrrr _strip_code_fence) r*r+r'rr,r-r.r/r0r6responser s r run_oneshotr:js*#28Y#G j  B % % '1Ar0H0H0JUVVH!!#lCD OOV 0@bAB ! H ) 2 8b ? ? AD T ""rc|jds|S|j}t|dk\rL|djdr8|djdk(r"dj |ddjS|S)z:Drop a single wrapping ``` fence the model may have added.z```r ) startswith splitlinesrrr)r liness rr8r8sp ??5 ! OO E 5zQ58..u5%)//:Ku:Tyyq%++-- Kr)N)__doc__loggingtypingrrrrragent.auxiliary_clientrr getLogger__name__loggerrPromptTemplateintrrr!r#__annotations__r(floatr:r8rrrOs.77I   8 $ 4S>*E#s(O;<6C666  4S#X45c?4<./$sN*+ %# %(4S>*B %eTWY\T\o %"*."#&-1*#*#*#sm *# S#X' *#  *#*#%*#*#4S>**# *#ZCCr