+ Wjla0t$Rt^RIHt^RIt^RIt^RIHt^RIH t H t H t H t H t ^RIHtHtHt]P$!]4tRRRRRR R R R R R R R R R R RRRRRRRRRR/ tR]R&R]3R]3R ]]3R ]3R]]3/tR]R&]P<!R4tRRlt RRlt!RRlt"R R!lt#R"R#lt$R$R%lt%R#)&uPlugin-declared settings fields for the Desktop/TUI Plugins hub (#46600, #87934). A ``plugin.yaml`` ``config_schema`` describes the keys under ``plugins.entries..settings``. This module turns that schema into renderable form fields (type, current value, choices) and writes edits back through :func:`hermes_cli.plugins_state.save_plugin_setting` — the same writer ``ctx.set_config`` uses, so the CLI, the plugin and the Desktop never disagree on where a setting lives. Secrets are declared with ``type: secret`` and never touch ``config.yaml``: the field carries the ``.env`` name (``env:`` or ``_``) plus a presence flag, and the client writes the value through the existing ``PUT /api/env`` credential route. ) annotationsN)Path)AnyDictListMappingOptional)_plugin_relative_segments_plugin_settings_entrysave_plugin_settingstrstringintnumberintegerfloatboolbooleanlistjsonarraydictobjectsecretzdict[str, str] _FIELD_TYPESenumzdict[str, tuple] _VALUE_TYPESz [^A-Z0-9]+c V^8dQhRRRR/#) plugin_dirOptional[Path]returnzMapping[str, Mapping[str, Any]])formats"OC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\plugins_settings.py __annotate__r%&sIII;ZIcVVf/#\V4R, pVP4'dS^RIHpV!VP RR74;'g/p\ V\ 4'dVPR4MRpM\\V44p\ V\ 4'g/#VP4UUu/uF)wrg\ V\ 4'gK\V4VbK+ upp# \d#p\PRY4/uRp?#Rp?ii;iuuppi)ae``config_schema`` from ``/plugin.yaml``, or for a portable package from ``plugin.json`` ``extensions.com.nousresearch.hermes.config_schema`` (Agent Plugins v1 forbids unknown top-level fields, so Hermes-specific keys live in the vendor namespace); ``{}`` when absent or malformed (the loader already warned about malformed entries at load time).Nz plugin.yaml)fast_safe_load utf-8-sigencoding config_schemaz3plugin settings: cannot read the manifest in %s: %s)ris_fileutilsr( read_text isinstancerget_portable_config_schema Exceptionloggerdebugitemsr )rmanifestr(datarawexckvs& r$_manifest_config_schemar=&s  J-/H       ,!("4"4k"4"JKQQrD/9$/H/H$((?+dC)$z*:;C c7 # # "%))+ H+$!Aw1GICFAI+ HH  JJ\  Is5:C5,C5C5D%!D%5 D"DD"D"c V^8dQhRRRR/#)rrrr!rr")r#s"r$r%r%<sXXXXr&cVR, pVP4'gR#^RIp^RIHpV!VP VP RR744#)z plugin.jsonN)manifest_config_schemar)r*)r-rhermes_cli.agent_pluginsr@loadsr/)rportablerr@s& r$r2r2<sFM)H     ? !$**X-?-?-?-U"V WWr&c(V^8dQhRRRRRRRR/#)r plugin_idr keyspecMapping[str, Any]r!r")r#s"r$r%r%Fs/PPsPP4EP#Pr&c\VPR4;'gR4P4pV'dV#\P RV RV 2P 44PR4#)u``.env`` variable a ``type: secret`` field is stored under: the manifest's ``env:`` or ``_`` upper-snaked (``image_gen/fal`` + ``api_key`` → ``IMAGE_GEN_FAL_API_KEY``).env_)r r1strip_ENV_NAME_CLEAN_REsubupper)rErFrGdeclareds&&& r$secret_env_namerRFsa488E?((b)//1H  ! !#)AcU';'A'A'C D J J3 OOr&c V^8dQhRRRR/#)rrGrHr!r r")r#s"r$r%r%Os'Cr&cPVPR4RJdR#\P\VPR4;'gR4P4R4pVPRVPR44pVR8Xd!\ V\ 4'd V'dR#V#)rTtyper r choicesr)r1rr lowerr0r)rGkindrVs& r$ _field_typerYOs~ xxT!   C 0 9 9E:@@BH MDhhy$((6"23G xJw55' Kr&c$V^8dQhRRRRRR/#)rrEr rr r!zlist[dict[str, Any]]r")r#s"r$r%r%Ys"$$c$~$J^$r&c\V4pV'g.#^RIHpHp\ V!4;'g/V4;'g/pVP R4p\ V\4'dTM/p.pVP4EF\wr\V 4\T 4p RT RT R\T P R4;'gT P R4;'gT 4R\T P R4;'gR4R \T P R 44/p T R 8Xd+\Y T 4p T PR T R T!T 4R J/4M|T P RT P R44pT R8XdTUu.uFp\T4NK upT R&RT 9d T R,T R&TP YP R44T R&TP!T 4EK_ V# \dEKri;iuupi)uRenderable settings fields for one plugin: schema + the current value of each key. Secret fields never carry the value — only ``env`` (where it lives) and ``has_value``. ) get_env_valueload_config_readonlysettingsrFrUlabeltitle descriptionrKrequiredrrJ has_valueNrVrdefaultvalue)r=hermes_cli.configr\r]r r1r0rr6r ValueErrorrYr rrRupdateappend)rErschemar\r]entry raw_currentcurrentfieldsrFrGrXfieldrJrVcs&& r$plugin_settings_fieldsrqYs %Z 0F  E "#7#9#?#?R K Q QrE))J'K0:;0P0PVXG#%F\\^   %c *4  3 S'*FFdhhw.?FF3G 3txx 6<<"= TXXj12 !  8 !)$7C LL%k=3ET3QR Shhy$((6*:;Gv~4;#wrVVP\V44pVf\ V: R24h\ V4pVR8Xd\ V: R24h\ V,p \Wi4'd"\V\4'd4\V 9d)\ V: RV R\V4P R24hVR8XdNYgPRVPR44U u.uFp \V 4NK up 9d\ V: R 24hVP\V4\\V44V34EKA VFwr[p\W V4K VUU U u.uFwr\qNK up p p#uup iuup p pi) alWrite ``values`` (``{key: value}``) for the plugin's schema keys; returns the keys written. Raises ``ValueError`` on an unknown key, a type mismatch, an enum value outside ``choices`` or a secret (secrets go to ``.env`` through the credential route, never ``config.yaml``); ``PermissionError`` propagates from the shared writer (managed installs / managed keys). z. is not declared in the plugin's config_schemarz3 is a secret; it is stored in .env, not config.yamlz should be z (got )rrVz$ must be one of the declared choices)r=r6r1r rgrYrr0rrU__name__rir r )rErrsrjplanrFrerGrXexpectedrpsegments _segments_values&&& r$save_plugin_settingsr|st%Z 0FDlln zz#c(# <w&TUV V4  8 w&YZ[ [%%**z%/F/F4W_K_wk$vd5k>R>R=SSTUV V 6>eHHYPTPXPXY_P`rs # 55kk   8 $ 8Xx 8Y'8Xx Iy) FGVVVXv h   n sffsfhe i$RX[_aeZf" ZZ .I,XP$N4r&