ides_adapter_weixin 0.1.0__tar.gz

ides_adapter_weixin-0.1.0/.gitea/workflows/release.yaml

@@ -0,0 +1,60 @@
+name: Release to PyPI
+
+# 手动触发发 PyPI：
+#   - workflow_dispatch：在 Actions 页面点 Run workflow，手动填 version（如 0.1.1）
+#   - 也可用 gitea release 事件手动触发（建 release 时自动跑，取 tag 版本）
+# 用组织级 secret PIPY_TOKEN（已配置，组织下所有项目共享）发 PyPI。
+# 第一次配置参考：hermes-rs-ides 的 release.yaml（2026-08-13 煊拍板模式沿用）
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "要发布的版本号（如 0.1.1；留空则读 pyproject 当前版本）"
+        required: false
+        type: string
+        default: ""
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: Build & Publish to PyPI
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ gitea.ref }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Show version
+        id: version
+        run: |
+          # 手动触发填了 version 就用填的，否则读 pyproject 当前版本
+          if [ -n "${{ inputs.version }}" ]; then
+            echo "VERSION=${{ inputs.version }}"
+            echo "VERSION=${{ inputs.version }}" >> "$GITHUB_ENV"
+          else
+            UV_VER=$(uv run --quiet python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+            echo "VERSION=$UV_VER"
+            echo "VERSION=$UV_VER" >> "$GITHUB_ENV"
+          fi
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PIPY_TOKEN }}
+          UV_PUBLISH_URL: https://upload.pypi.org/legacy/
+        run: uv publish
+
+      - name: Confirm published
+        run: |
+          echo "✅ 已发布 ides_adapter_weixin@${{ env.VERSION }} 到 PyPI"

ides_adapter_weixin-0.1.0/.gitea/workflows/test-secret.yaml

@@ -0,0 +1,17 @@
+name: test-secret
+on:
+  - push
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检查 PIPY_TOKEN 是否存在（正确写法）
+        env:
+          PIPY_TOKEN: ${{ secrets.PIPY_TOKEN }}
+        run: |
+          if [ -n "$PIPY_TOKEN" ]; then
+            echo "✅ PIPY_TOKEN 存在（长度: ${#PIPY_TOKEN}）"
+          else
+            echo "❌ PIPY_TOKEN 不存在"
+          fi

ides_adapter_weixin-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+env/
+
+# uv
+uv.lock
+
+# Build
+dist/
+build/
+*.egg-info/

ides_adapter_weixin-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.5
+Name: ides_adapter_weixin
+Version: 0.1.0
+Summary: 微信（WeChat iLink Bot）adapter for IDES channel——通过 channel_ingest/emit 让微信消息驱动 IDES
+Author-email: "tckm.rush" <rush@tachikoma.dev>
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: segno>=1.6
+Description-Content-Type: text/markdown
+
+# ides_adapter_weixin
+
+微信（WeChat iLink Bot）adapter for IDES channel——让微信消息驱动 IDES agent。
+
+通过 fastmcp 暴露 3 个工具，对接 IDES 的 channel 机制（`mcp_<server>_<tool>` 命名）。
+
+## 工具
+
+| 工具 | 作用 |
+|------|------|
+| `weixin_qrcode_login` | 登录：拿二维码 → 用户微信扫码 → 自动拿 token（后登录设计） |
+| `channel_ingest` | 收消息：带 sync_buf 游标增量拉取（未登录返回空，零打扰） |
+| `channel_emit` | 发消息：sendmessage 发文本 |
+
+## 后登录（lazy login）设计
+
+MCP server **启动时不登录**。`channel_ingest` 被感知层轮询时：
+- 有 token → 正常 getupdates
+- 无 token → 返回 `{"messages": []}`（空），感知层 `is_empty()` 天然过滤，不打扰 agent
+
+agent 想接微信时，主动调 `weixin_qrcode_login` 扫码，成功即存 token，之后收发光。
+
+## 使用
+
+### 作为 MCP server 接入 IDES
+
+在 `mcp/weixin.toml`（IDES_HOME 下）注册：
+
+```toml
+[mcp_servers.weixin]
+command = "uvx"
+args = ["ides-adapter-weixin"]
+```
+
+或用本地开发版：
+
+```toml
+[mcp_servers.weixin]
+command = "uv"
+args = ["run", "--with", ".", "ides-adapter-weixin"]
+```
+
+### 登录
+
+```bash
+# 设置 IDES_HOME（默认取环境变量或当前目录）
+export IDES_HOME=H:/RUSH
+
+# 调用登录工具拿二维码，用微信扫
+```
+
+### .env 配置
+
+```bash
+IDES_HOME=H:/RUSH            # 存 token/游标的目录
+WEIXIN_ACCOUNT_ID=default    # 账号标识（多账号用）
+```
+
+## 实现参考
+
+核心 API 参考 hermes-agent 的 `gateway/platforms/weixin.py`（已验证的 iLink Bot API），
+按 IDES channel 契约精简重做，不依赖 hermes-agent 生态。
+
+## License
+
+MIT

ides_adapter_weixin-0.1.0/README.md

@@ -0,0 +1,66 @@
+# ides_adapter_weixin
+
+微信（WeChat iLink Bot）adapter for IDES channel——让微信消息驱动 IDES agent。
+
+通过 fastmcp 暴露 3 个工具，对接 IDES 的 channel 机制（`mcp_<server>_<tool>` 命名）。
+
+## 工具
+
+| 工具 | 作用 |
+|------|------|
+| `weixin_qrcode_login` | 登录：拿二维码 → 用户微信扫码 → 自动拿 token（后登录设计） |
+| `channel_ingest` | 收消息：带 sync_buf 游标增量拉取（未登录返回空，零打扰） |
+| `channel_emit` | 发消息：sendmessage 发文本 |
+
+## 后登录（lazy login）设计
+
+MCP server **启动时不登录**。`channel_ingest` 被感知层轮询时：
+- 有 token → 正常 getupdates
+- 无 token → 返回 `{"messages": []}`（空），感知层 `is_empty()` 天然过滤，不打扰 agent
+
+agent 想接微信时，主动调 `weixin_qrcode_login` 扫码，成功即存 token，之后收发光。
+
+## 使用
+
+### 作为 MCP server 接入 IDES
+
+在 `mcp/weixin.toml`（IDES_HOME 下）注册：
+
+```toml
+[mcp_servers.weixin]
+command = "uvx"
+args = ["ides-adapter-weixin"]
+```
+
+或用本地开发版：
+
+```toml
+[mcp_servers.weixin]
+command = "uv"
+args = ["run", "--with", ".", "ides-adapter-weixin"]
+```
+
+### 登录
+
+```bash
+# 设置 IDES_HOME（默认取环境变量或当前目录）
+export IDES_HOME=H:/RUSH
+
+# 调用登录工具拿二维码，用微信扫
+```
+
+### .env 配置
+
+```bash
+IDES_HOME=H:/RUSH            # 存 token/游标的目录
+WEIXIN_ACCOUNT_ID=default    # 账号标识（多账号用）
+```
+
+## 实现参考
+
+核心 API 参考 hermes-agent 的 `gateway/platforms/weixin.py`（已验证的 iLink Bot API），
+按 IDES channel 契约精简重做，不依赖 hermes-agent 生态。
+
+## License
+
+MIT

ides_adapter_weixin-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ides_adapter_weixin"
+version = "0.1.0"
+description = "微信（WeChat iLink Bot）adapter for IDES channel——通过 channel_ingest/emit 让微信消息驱动 IDES"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "tckm.rush", email = "rush@tachikoma.dev" }]
+requires-python = ">=3.10"
+dependencies = [
+    "fastmcp>=2.0",
+    "httpx>=0.27",
+    "segno>=1.6",
+]
+
+[project.scripts]
+ides-adapter-weixin = "ides_adapter_weixin.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ides_adapter_weixin"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

ides_adapter_weixin-0.1.0/src/ides_adapter_weixin/__init__.py

@@ -0,0 +1,10 @@
+"""IDES channel 微信 adapter。
+
+用 fastmcp 暴露 channel_ingest/channel_emit 让微信消息驱动 IDES（后登录设计）。
+"""
+from ides_adapter_weixin.server import build_server
+from ides_adapter_weixin.weixin import WeixinAdapter
+
+__version__ = "0.1.0"
+
+__all__ = ["build_server", "WeixinAdapter", "__version__"]

ides_adapter_weixin-0.1.0/src/ides_adapter_weixin/server.py

@@ -0,0 +1,217 @@
+"""IDES channel 的微信 adapter——fastmcp server。
+
+暴露 3 个工具：
+1. weixin_qrcode_login：登录。拿二维码（agent 自行决定展示方式给用户扫），轮询扫码状态，
+   成功拿 token 存到本地（后登录，不用启动时登录）。
+2. channel_ingest：收消息。有 token → getupdates 增量拉；无 token → 返回空 messages（零打扰）。
+3. channel_emit：发消息。sendmessage 发文本。
+
+MCP 通过 stdio 启动本进程（command=uvx ides-adapter-weixin 或 uv run --with ... python server.py）。
+"""
+from __future__ import annotations
+
+import json
+import os
+import time
+from pathlib import Path
+from typing import Any, Optional
+
+from fastmcp import FastMCP
+
+from ides_adapter_weixin.weixin import WeixinAdapter, _account_file
+
+
+def _resolve_home() -> str:
+    """解析 IDES home 目录。优先 IDES_HOME env，否则当前目录。"""
+    return os.environ.get("IDES_HOME") or os.environ.get("HOME") or str(Path.cwd())
+
+
+def _resolve_account_id() -> str:
+    return os.environ.get("WEIXIN_ACCOUNT_ID", "default")
+
+
+def _token_file() -> Path:
+    return _account_file(_resolve_home(), _resolve_account_id())
+
+
+def _load_token() -> Optional[str]:
+    """读取本地 token。不存在返回 None。"""
+    f = _token_file()
+    if not f.exists():
+        return None
+    try:
+        return json.loads(f.read_text(encoding="utf-8")).get("token")
+    except Exception:
+        return None
+
+
+def _save_token(token: str, user_id: str = "") -> None:
+    """保存 token 到本地账号文件。"""
+    f = _token_file()
+    f.parent.mkdir(parents=True, exist_ok=True)
+    f.write_text(json.dumps({"token": token, "user_id": user_id}, ensure_ascii=False), encoding="utf-8")
+
+
+def _strip_wechat_uin(msgs: list) -> list:
+    """把 getupdates 的 msgs 转成 channel 契约的 messages。
+
+    iLink 的 msg 结构里 from/to 的表意取决于视角。这里简化为：
+    - from：发给我们的用户（拿原始 msg 里的 from_user_id 或 fromNickname）
+    - text：文本（从 text_item 里抠）
+    """
+    out = []
+    for m in msgs:
+        item_list = m.get("item_list", [])
+        text = ""
+        for item in item_list:
+            text_item = item.get("text_item") or {}
+            if text_item.get("text"):
+                text = text_item["text"]
+                break
+        if not text:
+            continue
+        msg_id = m.get("msg_id") or m.get("client_msg_id") or str(id(m))
+        from_user = m.get("from_user_id") or m.get("fromNickname") or "微信"
+        to_user = m.get("to_user_id") or ""
+        out.append({
+            "msg_id": msg_id,
+            "from": from_user,
+            "text": text,
+            "timestamp": int(m.get("timestamp") or m.get("msg_time") or 0),
+        })
+    return out
+
+
+def build_server() -> FastMCP:
+    adapter = WeixinAdapter(_resolve_home(), _resolve_account_id())
+    mcp = FastMCP("weixin")
+
+    @mcp.tool()
+    def weixin_qrcode_login(poll_seconds: float = 60.0) -> dict:
+        """获取微信登录二维码，供用户扫码。
+
+        agent 拿到后自行决定如何展示给用户（转成图片 / 直接给 liteapp URL / 命令行渲染）。
+        二维码已自动渲染落盘到 <IDES_HOME>/weixin/qrcode.png，agent 可直接展示。
+        本工具会同步轮询扫码状态（默认 60s），直到 confirmed 拿到 token 自动保存。
+
+        返回 {
+            "qrcode": "<hex token>",
+            "qrcode_url": "<完整 liteapp URL，微信要扫这个>",
+            "qr_scan_data": "<实际可扫数据>",
+            "qr_image_path": "<落盘的二维码图片路径>",
+            "status": "wait|scaned|scaned_but_redirect|confirmed|expired|error",
+            "account_id": "<登录成功时返回>",
+            "token": "<登录成功时返回（已自动保存）>"
+        }
+        """
+        try:
+            qr = adapter.fetch_qrcode()
+            qr_scan_data = qr["qr_scan_data"]
+
+            # 渲染二维码落盘（agent 可直接展示）
+            qr_img_path = Path(_resolve_home()) / "weixin" / "qrcode.png"
+            qr_img_path.parent.mkdir(parents=True, exist_ok=True)
+            try:
+                import segno
+                segno.make(qr_scan_data, error="m").save(
+                    str(qr_img_path), scale=8, border=2
+                )
+            except Exception:
+                pass  # segno 不可用则跳过渲染，仍可用 qrcode_url 展示
+
+            result = {
+                "qrcode": qr["qrcode"],
+                "qrcode_url": qr["qrcode_url"],
+                "qr_scan_data": qr_scan_data,
+                "qr_image_path": str(qr_img_path),
+                "status": "wait",
+            }
+
+            # 同步轮询扫码状态（直到 confirmed / expired / 超时）
+            deadline = time.time() + poll_seconds
+            while time.time() < deadline:
+                st = adapter.poll_qr_status(qr["qrcode"])
+                status = st.get("status")
+                result["status"] = status
+                if status == "confirmed":
+                    token = st.get("bot_token")
+                    account_id = st.get("ilink_bot_id") or _resolve_account_id()
+                    if token:
+                        _save_token(token, st.get("ilink_user_id", ""))
+                        result["token"] = token
+                        result["account_id"] = account_id
+                        result["base_url"] = st.get("baseurl") or ""
+                        result["status"] = "ok"
+                        break
+                elif status == "expired":
+                    break
+                time.sleep(1)
+
+            return result
+        except Exception as e:
+            return {"status": "error", "message": str(e)}
+
+    @mcp.tool()
+    def channel_ingest() -> dict:
+        """channel_ingest: 拉取该 adapter 积累给 IDES 的新消息（增量）。
+
+        返回 ChannelIngestResponse schema：
+        { "messages": [ { "msg_id": "...", "from": "...", "text": "...", "timestamp": 123 } ] }
+        未登录时返回 {"messages": []}（零打扰）。
+        """
+        token = _load_token()
+        if not token:
+            # 未登录 → 返回空 messages，让感知层的 is_empty() 天然过滤，不打扰 agent
+            return {"messages": []}
+
+        # 读 sync_buf 游标
+        buf_file = Path(_resolve_home()) / "weixin" / "sync_buf" / f"{_resolve_account_id()}.txt"
+        sync_buf = ""
+        if buf_file.exists():
+            sync_buf = buf_file.read_text(encoding="utf-8").strip()
+
+        try:
+            updates = adapter.get_updates(token, sync_buf)
+        except Exception as e:
+            # 网络错误也别当消息投递（避免轰炸），返回空
+            logger = __import__("logging").getLogger(__name__)
+            logger.warning("channel_ingest: getupdates 失败: %s", e)
+            return {"messages": []}
+
+        # 保存新游标
+        new_buf = updates.get("get_updates_buf", sync_buf)
+        if new_buf != sync_buf:
+            buf_file.parent.mkdir(parents=True, exist_ok=True)
+            buf_file.write_text(new_buf, encoding="utf-8")
+
+        messages = _strip_wechat_uin(updates.get("msgs", []))
+        return {"messages": messages}
+
+    @mcp.tool()
+    def channel_emit(text: str, to_user_id: str) -> str:
+        """channel_emit: agent 回信，发给微信用户。
+
+        to_user_id: 收件人（对应消息里的 from，或用户指定）。
+        返回发送结果。
+        """
+        token = _load_token()
+        if not token:
+            return "未登录，请先调用 weixin_qrcode_login"
+
+        client_id = str(int(time.time() * 1000))
+        try:
+            result = adapter.send_message(token, to_user_id, text, client_id)
+            return json.dumps(result, ensure_ascii=False)
+        except Exception as e:
+            return f"发送失败: {e}"
+
+    return mcp
+
+
+def main() -> None:
+    mcp = build_server()
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

ides_adapter_weixin-0.1.0/src/ides_adapter_weixin/weixin.py

@@ -0,0 +1,161 @@
+"""微信 iLink Bot API 客户端——IDES channel adapter 的核心。
+
+这个模块封装微信 iLink Bot HTTP API 的三个动作：
+1. 登录（qr_login）：拿二维码 → 用户微信扫码 → 轮询换 token
+2. 收消息（get_updates）：带 sync_buf 游标增量拉取
+3. 发消息（send_message）：sendmessage 发文本
+
+参考 hermes-agent 的 gateway/platforms/weixin.py（已验证的核心 API），
+这里按 IDES channel 契约精简重做，不依赖 hermes-agent 生态。
+"""
+from __future__ import annotations
+
+import json
+import logging
+import random
+import secrets
+import time
+from pathlib import Path
+from typing import Any, Optional
+
+import httpx
+
+logger = logging.getLogger(__name__)
+
+# ---- iLink Bot API 常量 ----
+ILINK_BASE_URL = "https://ilinkai.weixin.qq.com"
+EP_GET_BOT_QR = "ilink/bot/get_bot_qrcode"
+EP_GET_QR_STATUS = "ilink/bot/get_qrcode_status"
+EP_GET_UPDATES = "ilink/bot/getupdates"
+EP_SEND_MESSAGE = "ilink/bot/sendmessage"
+
+ILINK_APP_ID = "bot"
+ILINK_APP_CLIENT_VERSION = (2 << 16) | (2 << 8) | 0
+
+CHANNEL_VERSION = "2.2.0"
+
+MSG_TYPE_BOT = 2
+ITEM_TEXT = 1
+MSG_STATE_FINISH = 2
+
+LONG_POLL_TIMEOUT_MS = 35_000
+API_TIMEOUT_MS = 15_000
+QR_TIMEOUT_MS = 35_000
+
+# 默认账号文件路径：{home}/weixin/accounts/{account_id}.json
+def _account_file(home: str, account_id: str) -> Path:
+    return Path(home) / "weixin" / "accounts" / f"{account_id}.json"
+
+
+def _random_wechat_uin() -> str:
+    return str(random.randint(1, 0xFFFFFFFF)).zfill(10)
+
+
+def _base_info() -> dict:
+    return {"channel_version": CHANNEL_VERSION}
+
+
+def _auth_headers(token: Optional[str], body: str) -> dict:
+    """构造 iLink bot 请求头（token + X-WECHAT-UIN + app-id）。"""
+    headers = {
+        "Content-Type": "application/json",
+        "AuthorizationType": "ilink_bot_token",
+        "Content-Length": str(len(body.encode("utf-8"))),
+        "X-WECHAT-UIN": _random_wechat_uin(),
+        "iLink-App-Id": ILINK_APP_ID,
+        "iLink-App-ClientVersion": str(ILINK_APP_CLIENT_VERSION),
+    }
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+class WeixinAdapter:
+    """微信 iLink Bot 客户端——后登录（lazy）设计。
+
+    MCP server 启动时不登录。只有 channel_ingest 被调用时才检查 token：
+    - 有 token → 正常 getupdates
+    - 无 token → 由 server 层返回空 messages（零打扰）
+    """
+
+    def __init__(self, home: str, account_id: str, base_url: str = ILINK_BASE_URL) -> None:
+        self.home = home
+        self.account_id = account_id
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.Client(timeout=API_TIMEOUT_MS / 1000)
+
+    # ---- 登录：拿二维码 ----
+    def fetch_qrcode(self) -> dict:
+        """调 get_bot_qrcode，返回 {"qrcode","qrcode_img_content"}。"""
+        url = f"{self.base_url}/{EP_GET_BOT_QR}?bot_type=3"
+        resp = self._client.get(url)
+        resp.raise_for_status()
+        data = resp.json()
+        qrcode_value = str(data.get("qrcode") or "")
+        qrcode_url = str(data.get("qrcode_img_content") or "")
+        if not qrcode_value:
+            raise RuntimeError("微信返回的二维码缺少 qrcode 字段")
+        # 微信要扫完整的 liteapp URL，不是 raw hex
+        qr_scan_data = qrcode_url if qrcode_url else qrcode_value
+        return {"qrcode": qrcode_value, "qrcode_url": qrcode_url, "qr_scan_data": qr_scan_data}
+
+    def poll_qr_status(self, qrcode: str) -> dict:
+        """轮询扫码状态。返回 status + redirect_host + 凭据字段。
+
+        status == "confirmed" 时，凭据在响应顶层字段（参考 hermes-agent）：
+        ilink_bot_id / bot_token / baseurl / ilink_user_id。
+        """
+        url = f"{self.base_url}/{EP_GET_QR_STATUS}?qrcode={qrcode}"
+        resp = self._client.get(url)
+        resp.raise_for_status()
+        data = resp.json()
+        return {
+            "status": str(data.get("status") or "wait"),
+            "redirect_host": str(data.get("redirect_host") or ""),
+            "credential": data.get("credential"),
+            # confirmed 时顶层凭据字段（最关键）
+            "ilink_bot_id": str(data.get("ilink_bot_id") or ""),
+            "bot_token": str(data.get("bot_token") or ""),
+            "baseurl": str(data.get("baseurl") or ""),
+            "ilink_user_id": str(data.get("ilink_user_id") or ""),
+        }
+
+    # ---- 收消息 ----
+    def get_updates(self, token: str, sync_buf: str) -> dict:
+        """调 getupdates，返回 {"msgs":[...], "get_updates_buf": new_buf}。
+
+        getupdates 是长轮询（LONG_POLL_TIMEOUT_MS=35s），所以必须用超过 35s 的 timeout。
+        """
+        body = json.dumps({"get_updates_buf": sync_buf, "base_info": _base_info()})
+        url = f"{self.base_url}/{EP_GET_UPDATES}"
+        # 长轮询超时 + 余量；单独一个 client 避免影响其他调用
+        with httpx.Client(timeout=(LONG_POLL_TIMEOUT_MS + 10_000) / 1000) as long_client:
+            resp = long_client.post(url, content=body, headers=_auth_headers(token, body))
+            resp.raise_for_status()
+        data = resp.json()
+        return {
+            "msgs": data.get("msgs", []),
+            "get_updates_buf": data.get("get_updates_buf", sync_buf),
+        }
+
+    # ---- 发消息 ----
+    def send_message(self, token: str, to: str, text: str, client_id: str) -> dict:
+        """调 sendmessage 发文本，返回原始响应。"""
+        if not text or not text.strip():
+            raise ValueError("send_message: text 不能为空")
+        message = {
+            "from_user_id": "",
+            "to_user_id": to,
+            "client_id": client_id,
+            "message_type": MSG_TYPE_BOT,
+            "message_state": MSG_STATE_FINISH,
+            "item_list": [{"type": ITEM_TEXT, "text_item": {"text": text}}],
+        }
+        body = json.dumps({"msg": message, "base_info": _base_info()})
+        url = f"{self.base_url}/{EP_SEND_MESSAGE}"
+        resp = self._client.post(url, content=body, headers=_auth_headers(token, body))
+        resp.raise_for_status()
+        return resp.json()
+
+    def close(self) -> None:
+        self._client.close()