`gjp(,dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m ZddlmZej"eZd Zd Zd Zej.d ej0ZeGd dZddZddZddd ddZddddZy)uProfile describer — auto-generate ``description`` for a profile. Used by ``hermes profile describe --auto`` and the dashboard's "auto-generate description" button. Reads the profile's installed skills, model+provider, name, and optionally a small slice of memory, then asks the auxiliary LLM to produce a 1-2 sentence description of what the profile is good at. Result is written to ``/profile.yaml`` with ``description_auto: true`` so the dashboard can surface a "review" badge. User can edit afterward to confirm. Design notes ------------ - Mirrors the shape of ``hermes_cli/kanban_specify.py``: lazy aux client import inside the function, lenient response parse, never raises on expected failure modes. - Reads at most ``MAX_SKILLS_FOR_PROMPT`` skill names to keep the prompt bounded. No skill body — names + categories are enough signal and avoid blowing context on profiles with 100+ skills. - Memory is intentionally NOT read here. Memories are personal and the orchestrator routes work to a *role* not a *biography*. If we find later that memory adds signal we can wire it; for now, skills + name + model is plenty. ) annotationsN) dataclass)Path)Optional)profilesis_excluded_skill_path<uYou are a profile-describer for the Hermes Agent kanban board. A user runs multiple "profiles" — distinct agent identities, each with their own skills, model, and configuration. The kanban board's orchestrator routes work to whichever profile best fits each task. To do that well, every profile needs a short, concrete description of what it's good at. You are given a profile's: - Name - Model / provider - List of installed skill names (a strong signal of role / domain) Produce a single JSON object with exactly one key: { "description": "<1-2 sentence description, plain prose, no preamble>" } Rules: - The description is what an orchestrator will read to decide whether to route a task here. Lead with the profile's strongest capability. - Stay concrete. Bad: "an AI agent that helps users." Good: "Reads and modifies Python codebases — runs tests, refactors functions, opens GitHub PRs." - 1-2 sentences, <= 280 characters total. - Never invent capabilities the skills don't suggest. - Never write "Hermes Agent profile" or other meta-narration. - No code fences, no preamble, no closing remarks. Output only JSON. zProfile name: {name} Default model: {model} Provider: {provider} Installed skill count: {skill_count} Notable skills (up to {skill_cap}): {skill_list} z^```(?:json)?\s*|\s*```$cBeZdZUdZded<ded<dZded<dZd ed <y) DescribeOutcomez&Result of describing a single profile.str profile_nameboolokreasonNz Optional[str] description)__name__ __module__ __qualname____doc____annotations__rrO/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/profile_describer.pyr r Zs$0 HFC!%K%rr c,|dz }|jsgSg}|jdD]q}t|r |j|}|j dd}|s3t |dk(r|j|dV|j|dd|ds|jt |tkr|St |tz }ttDcgc]}|t||z}}|S#t$rYwxYwcc}w)aReturn a stable, capped list of skill names for the prompt. Format: ``category/skill_name`` where category is the immediate subdir under ``skills/`` (e.g. ``devops``, ``research``). Skills that live directly under ``skills/`` show as bare ``skill_name``. skillsSKILL.mdNr/) is_dirrglobr relative_to ValueErrorpartslenappendsortMAX_SKILLS_FOR_PROMPTrangeint) profile_dir skills_dirnamesmdrelr&stepisampleds r_collect_skillsr5dsx'J     Ez*4 !" %  ..,C #2  u:? LLq " LLE!H:QuRyk2 34 JJL  5z** u:- -D-23H-IJuST]#JGJ N'   $KsD&D D DcT|sytjd|j}|jd}|j d}|dk(s |dk(s||kry|||dz} t j |}t|tsy|S#tt jf$rYywxYw)Nr{}rr ) _FENCE_REsubstripfindrfindjsonloadsr%JSONDecodeError isinstancedict)rawstrippedfirstlast candidatevals r_extract_json_blobrIs }}R-H MM# E >># D {dbjDEM*Ijj# c4  J ,, -s#B B'&B'F) overwritetimeoutc tj|}tj|s t|ddS |dk(rddlm}t |}ntj|}tj|}|jdr |jd s|s t|dd St|}d jd |Dxsd } |dz jr$td|dz jdDnd} tj |\} } ddlm} t*j-|| xsd| xsd| t.| } | ddt0dd|dgdd|xsd} |j8dj:j<xsd!}t?|}|8|jAjCd"d#d}|s t|dd$S|dd%}nQ|jd}tE|tFr|jAs t|dd&S|jAdd%} tjH||d'(t|d'd*|+S#t$r}t|dd|cYd}~Sd}~wwxYw#t$r d\} } YiwxYw#t$r-}t&j)d|t|ddcYd}~Sd}~wwxYw#t$rD}t&j3d||t|dd t5|j6cYd}~Sd}~wwxYw#t$rd!}YwxYw#t$r}t|dd)|cYd}~Sd}~wwxYw),uUAuto-generate a description for one profile. Returns an outcome describing what happened. Never raises for expected failure modes (profile missing, no aux client configured, API error, malformed response) — those surface via ``ok=False`` so a sweep can continue past individual failures. ``overwrite`` controls whether an existing user-authored description is replaced. By default we refuse to overwrite a description with ``description_auto: false`` to protect curated text. Auto-generated descriptions (``description_auto: true``) are always replaceable. Fzprofile not founddefaultr)get_hermes_homezcannot resolve profile dir: Nrdescription_autozLprofile already has a user-authored description (use --overwrite to replace) c3&K|] }d| yw)z - Nr).0ns r z#describe_profile..s;!T!:;sz (no skills installed)rc36K|]}t|sdyw)r Nr)rR_s rrTz#describe_profile..s %a( sr)NN)call_llmz,describe: auxiliary client import failed: %szauxiliary client unavailablez(unset))namemodelprovider skill_count skill_cap skill_listprofile_describersystem)rolecontentuserg333333?ir )taskmessages temperature max_tokensrKz%describe: API call failed for %s (%s)z LLM error: rz r zLLM returned an empty responseiz(LLM response missing 'description' fieldT)rrOzfailed to write profile.yaml: described)r)% profiles_modnormalize_profile_nameprofile_existsr hermes_constantsrNrget_profile_dir Exceptionread_profile_metagetr5joinr"sumr#_read_config_modelagent.auxiliary_clientrWloggerdebug_USER_TEMPLATEformatr*_SYSTEM_PROMPTinfotyperchoicesmessagerarIr;splitrAr write_profile_meta)rrJrKcanonrNr-excexisting skill_namesr]r[rYrZrWuser_msgresprCparsedtextrrHs rdescribe_profilers$  / / =E  & &u -ue-@AAS I  801K&66u=K --k:H||M"8<<8J+KT]   +  "+.K;{;;X?XJ  ( ( *(*11*=12 %&99+FxM3 $$ ! 'i' %HQ$!n=H5Mr  ll1o%%--3  $F ~yy{  +A."5%1QR R4Cj jj'#s#399;"uH iik$3' U'' #!  5$  MMq Sue/KC5-QRRS. %$x% M CSIue-KLLM6 Q ;UCHue{49;M;M:N-OPPQ 0 Uue/McU-STTUs1IJ*JK6'L4L1 I>$I93I>9I>JJ K "KK K  L9LLL L.-L.1 M:M MMT) missing_onlycg}tjD]J}|r+|jxsdjr |js0|j |j L|S)zReturn profile names that can be described. ``missing_only=True`` (default) returns only profiles without a description. ``missing_only=False`` returns every profile. r)rh list_profilesrr;rOr(rX)routps rlist_describable_profilesrsZ C  ' ' ) Q]]0b779!BTBT  166 Jr)r-rreturn list[str])rCr rzOptional[dict])rr rJrrKz Optional[int]rr )rrrr)r __future__rr>loggingre dataclassesrpathlibrtypingr hermes_clirrhagent.skill_utilsr getLoggerrrtr*rxrvcompile MULTILINEr9r r5rIrrrrrrs4#  !/4   8 $ > BJJ2BLL A  && &#L*! vNvNvN vN  vNr7; r