+jddZddlZdefdZeZdefdZdefdZdefdZdZ d d gZ dS) u] lightclawbot — LightClaw platform plugin for Hermes Agent. Registers the LightClaw adapter via the Hermes plugin discovery system. No source-code modifications to lighthouse-hermes are required — the adapter is discovered automatically when this package is placed under ``~/.hermes/plugins/lightclawbot/`` or installed via pip (entry_points). NreturncH ddlm}|dS#t$rYdSwxYw)z>Return package version from importlib.metadata, with fallback.rversion lightclawbotz0.0.0)importlib.metadatar Exceptionrs 8/home/agentuser/.hermes/plugins/lightclawbot/__init__.py _get_versionr sK......w~&&& wws  !!c dS)aReturn the LightClaw-specific LLM capability hint. Only contents that are *unique* to LightClaw belong here. The generic ``MEDIA:/absolute/path/to/file`` protocol, supported extensions and text post-processing are owned by the framework (``BasePlatformAdapter.extract_media`` + ``PLATFORM_HINTS`` in ``agent/prompt_builder.py``) and are intentionally NOT re-stated here. uYou are on LightClaw, a WebSocket-based messaging platform. Markdown formatting is supported (code blocks, bold, italic, tables). FILE DELIVERY (MANDATORY — READ CAREFULLY): After ANY tool creates or writes a file, your reply MUST contain a MEDIA: tag for that file — one tag per file, each on its own line. The ONLY correct format is exactly: MEDIA: Correct examples: MEDIA:/home/ubuntu/报告.md MEDIA:/home/ubuntu/数据分析结果.xlsx WRONG — never do any of these: [报告.md](/home/ubuntu/报告.md) ← markdown link is WRONG [下载文件]() ← empty markdown link is WRONG MEDIA:[报告.md](...) ← MEDIA must be followed by a raw path only localfile:///home/ubuntu/报告.md ← URL schemes are WRONG file:///home/ubuntu/报告.md ← URL schemes are WRONG Rules: 1. Use the literal prefix 'MEDIA:' followed immediately by the raw absolute path. No brackets, no parentheses, no markdown, no quotes. 2. The path must be the FULL absolute path returned by the tool, even if it contains Chinese characters or spaces. Copy it verbatim. 3. Emit the MEDIA: line even if you already described the file in prose. 4. One MEDIA: line per file when multiple files were written. The framework converts each MEDIA: line into a download link for the user; without it the user gets NO download link. For cron jobs / reminders / scheduled tasks, always set deliver='lightclawbot:' so results reach the user instead of being saved locally.r r _load_platform_hintrs rct|dipi}t|dp&tjddS)z=Check whether the platform config has enough info to connect.extraapi_keysLIGHTCLAW_API_KEYgetattrboolgetosgetenvstripconfigrs r _validate_configrCsP FGR ( ( .BE  *%%S3F)K)K)Q)Q)S)S T TTrct|dipi}t|dp&tjddS)uCheck whether the platform is sufficiently configured (for status display). Hermes gateway 在启动时会用一个空的 ``PlatformConfig(enabled=True)`` 作为 *probe_cfg* 来调用这个函数（见 ``gateway/config.py`` 的 plugin-platform enablement pass）。如果只检查 ``extra.api_keys``，env-only 配置（也就是 把 ``LIGHTCLAW_API_KEY`` 写在 ``.env`` 而不写在 ``config.yaml``）会被 误判为「未配置」，导致 gateway 跳过该平台、永不连接。 所以必须兜底读 ENV。API key 等敏感凭证只应放在 ``.env``，``config.yaml`` 里仅放 ``platforms.lightclawbot.enabled: true`` 作为激活开关，这是 hermes 官方插件（IRC / Teams / Line / ntfy 等）的通用做法。 rrrrrrs r _is_connectedr IsR FGR ( ( .BE  *%%S3F)K)K)Q)Q)S)S T TTrcddlmm}|ddfd|tt dgddd d d t d S)aCalled by the Hermes plugin discovery system. Registers the LightClaw platform adapter so that: - Platform("lightclawbot") resolves to a dynamic enum member - The gateway creates and connects a LightClawAdapter at startup - send_message routes to the adapter via _send_via_adapter() - Cron delivery to "lightclawbot:" works automatically - User authorization respects LIGHTCLAW_ALLOWED_USERS env var )LightClawAdaptercheck_lightclaw_requirementsr LightClawBotc|S)Nr )cfgr#s r zregister..is$4$4S$9$9rrz*See https://pypi.org/project/lightclawbot/LIGHTCLAW_ALLOWED_USERSLIGHTCLAW_ALLOW_ALL_USERSiu⚡) namelabeladapter_factorycheck_fnvalidate_config is_connected required_env install_hintallowed_users_env allow_all_envmax_message_lengthemoji platform_hintN)srcr#r$register_platformrr r)ctxr$r#s @r registerr;Zs~DCCCCCCC 9999-(")*A31)++rr; __version__) __doc__rstrr r<rrrr r;__all__r rr r@s clnn &S&&&&RUUUUU UTUUUU": } %r