hap-cli 0.9.8__tar.gz → 0.9.10__tar.gz

{hap_cli-0.9.8 → hap_cli-0.9.10}/MANIFEST.in

@@ -13,3 +13,9 @@ include hap_cli/README_CN.md
 recursive-include hap_cli/locale *.json
 include hap_cli/guide/index.json
 recursive-include hap_cli/guide *.md
+
+# Development-only trees stay out of the sdist too (see setup.py _PACKAGES).
+prune hap_cli/tests
+prune live_tests
+prune app_live_tests
+global-exclude __pycache__ *.py[cod]

{hap_cli-0.9.8 → hap_cli-0.9.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.9.8
+Version: 0.9.10
 Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/__init__.py

@@ -3,7 +3,7 @@
 import sys as _sys
 import types as _types
 
-__version__ = "0.9.8"
+__version__ = "0.9.10"
 
 # The command tree used to live in hap_cli/hap_cli.py. A module named
 # after the package it sits in shadows that package: run python with the

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/commands/chat_cmd.py

@@ -1,6 +1,8 @@
 """CLI commands for chat and messaging management."""
 
+import html
 import json
+import re
 
 import click
 
@@ -73,6 +75,103 @@ def _output_chat_list_table(rows):
     )
 
 
+def _one_line(text: str) -> str:
+    """Visible text of a message on one line: tags dropped, entities
+    decoded, runs of whitespace collapsed."""
+    text = html.unescape(re.sub(r"<[^>]*>", "", text or ""))
+    return " ".join(text.split())
+
+
+def _conversation_preview(msg: dict) -> str:
+    body = msg.get("msg") or {}
+    text = _one_line(str(body.get("con") or ""))
+    files = body.get("files")
+    if isinstance(files, dict):
+        name = f"{files.get('originalFileName') or ''}{files.get('fileExt') or ''}"
+        label = "[image]" if msg.get("type") == 2 else "[file]"
+        text = " ".join(x for x in (label, name, text) if x)
+    return text
+
+
+def _output_conversation_table(rows):
+    """One row per message of a 1-on-1 or group chat, in the order the
+    server returns them (newest first)."""
+    output_table(
+        [
+            {
+                "time": str(m.get("time") or "")[:19],
+                "from": (m.get("fromAccount") or {}).get("name") or m.get("from", ""),
+                "message": _conversation_preview(m),
+                "id": m.get("id", ""),
+            }
+            for m in rows or []
+            if isinstance(m, dict)
+        ],
+        ["time", "from", "message", "id"],
+        ["Time", "From", "Message", "Message ID"],
+    )
+
+
+def _output_inbox_table(data):
+    rows = (data or {}).get("list") or []
+    output_table(
+        [
+            {
+                "time": r.get("createTime", ""),
+                "from": (r.get("sender") or {}).get("name")
+                or (r.get("app") or {}).get("name", ""),
+                "message": _one_line(str(r.get("message") or "")),
+            }
+            for r in rows
+            if isinstance(r, dict)
+        ],
+        ["time", "from", "message"],
+        ["Time", "From", "Message"],
+    )
+
+
+def _output_messages(data):
+    if isinstance(data, dict) and "list" in data:
+        _output_inbox_table(data)
+    else:
+        _output_conversation_table(data)
+
+
+def _output_chat_files(data):
+    rows = (data or {}).get("list") or []
+    output_table(
+        [
+            {
+                "time": r.get("time", ""),
+                "name": r.get("name", ""),
+                "size": _file_size(r.get("size")),
+                "from": (r.get("createAccount") or {}).get("fullname", ""),
+                "fileId": r.get("fileId", ""),
+            }
+            for r in rows
+            if isinstance(r, dict)
+        ],
+        ["time", "name", "size", "from", "fileId"],
+        ["Time", "Name", "Size", "From", "File ID"],
+    )
+    total = (data or {}).get("allCount")
+    if isinstance(total, int) and total > len(rows):
+        click.echo(f"Showing {len(rows)} of {total} files. Use -p for the "
+                   f"next page.", err=True)
+
+
+def _file_size(value) -> str:
+    try:
+        size = float(value)
+    except (TypeError, ValueError):
+        return ""
+    for unit in ("B", "KB", "MB", "GB"):
+        if size < 1024 or unit == "GB":
+            return f"{size:.0f} {unit}" if unit == "B" else f"{size:.1f} {unit}"
+        size /= 1024
+    return ""
+
+
 @click.group(help=t(
     'Chat and messaging management.\n\n'
     'To follow a notification back to the app record it belongs to, see '
@@ -97,7 +196,8 @@ def chat_list(ctx, page_size, page):
 
 
 @chat.command("files")
-@click.option("--with-user", "with_user", help="Peer accountId for 1-on-1 files")
+@click.option("--account-id", "--with-user", "with_user",
+              help="Account id of the person, for the files of your 1-on-1 chat")
 @click.option("--group-id", "group_id", help="Group id for group chat files")
 @click.option("--page-size", "-n", default=20, help="Items per page")
 @click.option("--page", "-p", default=1, help="Page number")
@@ -114,11 +214,11 @@ def chat_list(ctx, page_size, page):
 def chat_files(ctx, with_user, group_id, page_size, page, keywords, file_type, start, end):
     """List files shared in a 1-on-1 or group chat.
 
-    Provide exactly one of --with-user or --group-id.
+    Provide exactly one of --account-id or --group-id.
     """
     if bool(with_user) == bool(group_id):
         ctx.handle_error(click.UsageError(
-            "Provide exactly one of --with-user or --group-id."
+            "Provide exactly one of --account-id or --group-id."
         ))
         return
     try:
@@ -145,13 +245,14 @@ def chat_files(ctx, with_user, group_id, page_size, page, keywords, file_type, s
                 start=start,
                 end=end,
             )
-        ctx.output(data, lambda d: output_json(d))
+        ctx.output(data, _output_chat_files)
     except Exception as e:
         ctx.handle_error(e)
 
 
 @chat.command("messages")
-@click.option("--with-user", "with_user", help="Peer accountId for 1-on-1 messages")
+@click.option("--account-id", "--with-user", "with_user",
+              help="Account id of the person, for your 1-on-1 chat with them")
 @click.option("--group-id", "group_id", help="Group id for group chat messages")
 @click.option(
     "--category",
@@ -202,7 +303,9 @@ def chat_messages(
     """Fetch chat message history.
 
     Provide exactly one of:
-      --with-user      1-on-1 chat with a user
+
+    \b
+      --account-id     1-on-1 chat with a person
       --group-id       a group chat
       --category       inbox category (system / post / task / calendar /
                        kc / hr / app / workflow)
@@ -211,7 +314,7 @@ def chat_messages(
     sources = [bool(with_user), bool(group_id), bool(category), bool(inbox_type)]
     if sum(sources) != 1:
         ctx.handle_error(click.UsageError(
-            "Provide exactly one of --with-user / --group-id / --category / --inbox-type."
+            "Provide exactly one of --account-id / --group-id / --category / --inbox-type."
         ))
         return
     try:
@@ -250,13 +353,14 @@ def chat_messages(
             )
             if mark_read and category:
                 chat_mod.mark_inbox_read(session, category)
-        ctx.output(data, lambda d: output_json(d))
+        ctx.output(data, _output_messages)
     except Exception as e:
         ctx.handle_error(e)
 
 
 @chat.command("send-to-one")
-@click.option("--to", "-t", multiple=True, help="Target user account ID (can repeat)")
+@click.option("--account-id", "--to", "-t", "to", multiple=True,
+              help="Account id of the person to message (repeatable)")
 @click.option("--message", "-m", default="", help="Message text")
 @click.option(
     "--file", "-f", "files", multiple=True,
@@ -282,7 +386,7 @@ def chat_send_to_one(ctx, to, message, files, dry_run):
     """
     if not to:
         ctx.handle_error(click.UsageError(
-            "Provide at least one --to <accountId>."
+            "Provide at least one --account-id."
         ))
         return
     if not message and not files:
@@ -446,8 +550,9 @@ def chat_card_detail(ctx, task, post, calendar, kcfile, worksheet, worksheetrow)
 @chat.command("recall")
 @click.argument("message_id")
 @click.option("--group-id", "group_id", default="", help="Group id the message is in")
-@click.option("--with-user", "with_user", default="",
-              help="Peer accountId for a 1-on-1 message")
+@click.option("--account-id", "--with-user", "with_user", default="",
+              help="Account id of the person, for a message in your 1-on-1 "
+                   "chat with them")
 @click.option("--time", "msg_time", default="",
               help="Send time of the message. Looked up from the conversation "
                    "when omitted.")
@@ -465,7 +570,7 @@ def chat_recall(ctx, message_id, group_id, with_user, msg_time, as_admin, dry_ru
     cannot be undone.
     """
     if bool(group_id) == bool(with_user):
-        raise click.UsageError("Pass exactly one of --group-id or --with-user.")
+        raise click.UsageError("Pass exactly one of --group-id or --account-id.")
     try:
         session = ctx.get_session()
         found = None

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/commands/v3_registry.py

@@ -21,6 +21,8 @@ re-implementation on legacy endpoints.
 
 from __future__ import annotations
 
+import logging
+
 import click
 
 from hap_cli.commands.app_cmd import app
@@ -34,8 +36,11 @@ from hap_cli.core.v3.render import render_v3_response
 from hap_cli.core import worksheet as _ws_mod
 from hap_cli.core import workflow as _wf_mod
 from hap_cli.core import record_lookups as _lookups
+from hap_cli.core import record_discussions as _discussions
 from hap_cli.i18n import t
 
+_logger = logging.getLogger("hap_cli.record")
+
 
 def _drop(group, *names):
     """Remove legacy commands from a Click group before re-registering.
@@ -324,7 +329,42 @@ register_v3(record, "get", tool="get_record_details", subtable_guard=True)
 # (record_cmd.py) — not V3.
 register_v3(record, "delete", tool="batch_delete_records",  # multi-id via batch
             confirm="Delete the selected record(s) from worksheet {worksheet_id}?")
-register_v3(record, "discussions", tool="get_record_discussions")
+def _record_discussions_mentions(ctx, response, options):
+    """Show mentions as @name, in both the JSON and the md form.
+
+    How the two forms differ, and why md may cost a second read, is in
+    ``hap_cli.core.record_discussions``."""
+    payload = response.get("data") if isinstance(response, dict) else None
+    if not isinstance(payload, dict):
+        return response
+    discussions = payload.get("discussions")
+    if isinstance(discussions, list):
+        _discussions.render_json(discussions)
+        return response
+    if not isinstance(discussions, str):
+        return response
+    names = _discussions.names_from_md(discussions)
+    if any(i not in names for i in _discussions.mentioned_ids(discussions)):
+        params = click.get_current_context().params
+        query = {
+            "pageIndex": params.get("page_index"),
+            "pageSize": params.get("page_size"),
+            "search": params.get("search"),
+            "onlyWithAttachments": params.get("only_with_attachments"),
+        }
+        try:
+            names.update(_discussions.fetch_names(
+                ctx.get_session(), params.get("worksheet_id") or "",
+                params.get("row_id") or "", app_id=_resolve_list_app_id(ctx),
+                query={k: v for k, v in query.items() if v not in (None, "")}))
+        except Exception as exc:
+            _logger.warning("Could not look up mentioned names: %s", exc)
+    payload["discussions"] = _discussions.render_md(discussions, names)
+    return response
+
+
+register_v3(record, "discussions", tool="get_record_discussions",
+            post_process=_record_discussions_mentions)
 register_v3(record, "logs", tool="get_record_logs")
 register_v3(record, "relations", tool="get_record_relations")
 register_v3(record, "pivot", tool="get_record_pivot_data",

hap_cli-0.9.10/hap_cli/core/record_discussions.py

@@ -0,0 +1,137 @@
+"""Readable record discussions: mention markers rendered as ``@name``.
+
+A discussion stores its mentions inside the text: ``[aid]<accountId>[/aid]``
+per person (external portal users have ids like ``a#6805…``) and
+``[all]atAll[/all]`` for everyone. The web renders them through
+``createLinksForMessage`` (MDPublic src/components/comment/utils/
+createLinksForMessage.js:86-109): a person becomes ``@<name>`` and the
+everyone marker becomes ``@`` + AT_ALL_TEXT[WORKSHEETROW] = "全体参与者"
+(src/components/comment/config.js:22). An id it cannot name stays as-is.
+
+The V3 discussions endpoint answers JSON with a ``mentions`` list that
+names every ``[aid]`` in the message, so the JSON form is rendered from
+the response alone. Its ``md`` form drops that list and writes each author
+as ``{"AccountId":…,"FullNmae":…}`` (sic — a server-side typo), so the md
+form is rendered from a name map the caller supplies.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from typing import Any, Iterable
+
+AT_ALL_TEXT = "全体参与者"
+
+_AID_RE = re.compile(r"\[aid\]([^\[\]]+?)\[/aid\]")
+_ALL_RE = re.compile(r"\[all\]atAll\[/all\]", re.IGNORECASE)
+# One author as the md form writes it; tolerant of the server ever fixing
+# the misspelt key.
+_MD_AUTHOR_RE = re.compile(
+    r'\{"AccountId":"([^"]*)","(?:FullNmae|FullName)":"((?:[^"\\]|\\.)*)"\}')
+
+
+def render_markers(text: str, names: dict[str, str]) -> str:
+    """Replace mention markers with ``@name``; unknown ids stay visible."""
+    if not text:
+        return text or ""
+
+    def _person(m: re.Match) -> str:
+        name = names.get(m.group(1).strip())
+        return f"@{name}" if name else m.group(0)
+
+    return _AID_RE.sub(_person, _ALL_RE.sub(f"@{AT_ALL_TEXT}", text))
+
+
+def mentioned_ids(text: str) -> list[str]:
+    seen: list[str] = []
+    for aid in _AID_RE.findall(text or ""):
+        aid = aid.strip()
+        if aid not in seen:
+            seen.append(aid)
+    return seen
+
+
+def _people(item: dict) -> Iterable[dict]:
+    for key in ("_createdBy", "replyToAuthor"):
+        if isinstance(item.get(key), dict):
+            yield item[key]
+    for person in item.get("mentions") or []:
+        if isinstance(person, dict):
+            yield person
+
+
+def names_from_json(discussions: Any) -> dict[str, str]:
+    """Account id → name from every author, reply target and mention."""
+    names: dict[str, str] = {}
+    for item in discussions or []:
+        if not isinstance(item, dict):
+            continue
+        for person in _people(item):
+            aid = person.get("accountId")
+            name = person.get("fullname") or person.get("name")
+            if aid and name:
+                names[aid] = name
+    return names
+
+
+def render_json(discussions: Any) -> Any:
+    """Render each discussion's ``message`` in place.
+
+    The stored text moves to ``rawMessage``; ``mentionsEveryone`` is set
+    when the message mentions everyone. The server's ``mentions`` list
+    (id and name of each person mentioned) is left as it is."""
+    if not isinstance(discussions, list):
+        return discussions
+    names = names_from_json(discussions)
+    for item in discussions:
+        if not isinstance(item, dict) or not isinstance(item.get("message"), str):
+            continue
+        raw = item["message"]
+        rendered = render_markers(raw, names)
+        if rendered != raw:
+            item["rawMessage"] = raw
+            item["message"] = rendered
+        if _ALL_RE.search(raw):
+            item["mentionsEveryone"] = True
+    return discussions
+
+
+def names_from_md(text: str) -> dict[str, str]:
+    names: dict[str, str] = {}
+    for aid, name in _MD_AUTHOR_RE.findall(text or ""):
+        if aid and name:
+            names[aid] = _unescape(name)
+    return names
+
+
+def _unescape(value: str) -> str:
+    try:
+        return json.loads(f'"{value}"')
+    except ValueError:
+        return value
+
+
+def render_md(text: str, names: dict[str, str]) -> str:
+    """Write authors as plain names and mentions as ``@name``."""
+    if not isinstance(text, str):
+        return text
+    text = _MD_AUTHOR_RE.sub(lambda m: _unescape(m.group(2)), text)
+    return render_markers(text, names)
+
+
+DISCUSSIONS_PATH = "/v3/app/worksheets/{worksheet_id}/rows/{row_id}/discussions"
+
+
+def fetch_names(
+    session: Any, worksheet_id: str, row_id: str, *, app_id: str,
+    query: dict[str, Any],
+) -> dict[str, str]:
+    """Names for the md form: the same page asked for again as JSON, whose
+    ``mentions`` list names everyone the md text only gives ids for."""
+    params = dict(query, responseFormat="json")
+    response = session.v3_call(
+        "GET", DISCUSSIONS_PATH, app_id=app_id, query=params,
+        path_params={"worksheet_id": worksheet_id, "row_id": row_id})
+    data = response.get("data") if isinstance(response, dict) else None
+    return names_from_json((data or {}).get("discussions"))

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/core/upload.py

@@ -28,7 +28,7 @@ import re
 import time
 from datetime import datetime, timezone
 from typing import Any, Callable, Optional
-from urllib.parse import parse_qs, quote, urlparse
+from urllib.parse import parse_qs, quote, unquote, urlparse
 
 import requests
 
@@ -267,6 +267,17 @@ def _encode_original_name(stem: str) -> str:
     return quote(stem, safe="")
 
 
+def _decode_original_name(echoed: Any, fallback: str) -> str:
+    """The store echoes ``x:originalFileName`` exactly as posted — still
+    percent-encoded — and the uploader decodes it before handing the file
+    on (MDPublic createUploader.js:452). Passing the echo through as-is
+    left names like "HDP-%E5%B9%BF%E5%91%8A40s" on posts, chat files and
+    record attachments."""
+    if not echoed:
+        return fallback
+    return unquote(str(echoed))
+
+
 def _name_and_ext(source: str, *, name: str = "") -> tuple[str, str]:
     """Derive (originalName-without-ext, ext-with-dot) from a name or path/url.
 
@@ -368,7 +379,7 @@ def upload_bytes(
         "filePath": up.get("filePath"),
         "fileName": up.get("fileName"),
         "fileExt": up.get("fileExt"),
-        "originalFileName": up.get("originalFileName"),
+        "originalFileName": _decode_original_name(up.get("originalFileName"), original),
         "key": up.get("key") or token.get("key"),
         "url": token.get("url"),
         # The signed URL above stops working at this instant — see

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/guide/en/messages.md

@@ -30,7 +30,7 @@ hap --json chat messages --category app        # or workflow, etc.
   with `viewId`, `comment.recordName` and `comment.entityName`.
 - Workflow **cc / participant** notifications have the `appId` / `worksheetId` / `rowId`
   resolved out of the record link for you.
-- One-to-one and group chats do not use `--category`; use `--with-user <accountId>` or
+- One-to-one and group chats do not use `--category`; use `--account-id <accountId>` or
   `--group-id <groupId>` (the id is the conversation's `value`).
 
 **3. Read the record and its discussion**

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/guide/zh-Hans/messages.md

@@ -29,7 +29,7 @@ hap --json chat messages --category app        # 或 workflow 等
   `comment.recordName`、`comment.entityName`。
 - 工作流**抄送 / 参与者**类通知会把记录链接里的 `appId` / `worksheetId` / `rowId`
   一并解析出来。
-- 单聊 / 群聊不走 `--category`，用 `--with-user <accountId>` 或 `--group-id <groupId>`
+- 单聊 / 群聊不走 `--category`，用 `--account-id <accountId>` 或 `--group-id <groupId>`
   （id 取会话的 `value`）。
 
 **3. 拿三元组直接读记录和讨论**

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli/locale/messages.json

@@ -3015,6 +3015,30 @@
       "en": "Output in JSON format",
       "zh-Hans": "以 JSON 格式输出"
     },
+    "attachment download": {
+      "en": "Download a file attached to a worksheet record.\n\nFILE_ID is listed in an attachment field or a record operation log.\nExisting local files are never overwritten.",
+      "zh-Hans": "下载工作表记录里的附件。\n\nFILE_ID 可以在附件字段或记录操作日志中找到。不会覆盖本地已有的文件。"
+    },
+    "attachment download --control-id": {
+      "en": "Attachment field containing the file.",
+      "zh-Hans": "附件所在的附件字段。"
+    },
+    "attachment download --json": {
+      "en": "Output in JSON format",
+      "zh-Hans": "以 JSON 格式输出"
+    },
+    "attachment download --output": {
+      "en": "Save as this path. By default, uses the attachment name.",
+      "zh-Hans": "保存到此路径。默认使用附件原名。"
+    },
+    "attachment download --row-id": {
+      "en": "Record containing the attachment.",
+      "zh-Hans": "附件所在的记录。"
+    },
+    "attachment download --worksheet-id": {
+      "en": "Worksheet containing the record.",
+      "zh-Hans": "记录所在的工作表。"
+    },
     "attachment share": {
       "en": "Create a link to a stored file that you can pass on.\n\n\b\n  hap attachment share https://doc.example.com/doc/20260830/abc.html\n  hap attachment share doc/20260830/abc.html --hours 168\n  hap attachment share --file-id <id>\n\nADDRESS is the file's link — a link that has already stopped working\nis fine, paste it as-is — or just the path part of it.",
       "zh-Hans": "为已存储的文件创建可转发的链接。\n\n\b\n  hap attachment share https://doc.example.com/doc/20260830/abc.html\n  hap attachment share doc/20260830/abc.html --hours 168\n  hap attachment share --file-id <id>\n\nADDRESS 是文件的链接——已经失效的链接也可以，原样粘贴即可——或者只传链接中的路径部分。"
@@ -3432,8 +3456,12 @@
       "zh-Hans": "工作表记录，格式 'wsId>rowId'，以 '|' 分隔"
     },
     "chat files": {
-      "en": "List files shared in a 1-on-1 or group chat.\n\nProvide exactly one of --with-user or --group-id.",
-      "zh-Hans": "列出单聊或群聊中共享的文件。\n\n--with-user 与 --group-id 必须且只能提供一个"
+      "en": "List files shared in a 1-on-1 or group chat.\n\nProvide exactly one of --account-id or --group-id.",
+      "zh-Hans": "列出单聊或群聊中共享的文件。\n\n--account-id 与 --group-id 必须且只能提供一个。"
+    },
+    "chat files --account-id": {
+      "en": "Account id of the person, for the files of your 1-on-1 chat",
+      "zh-Hans": "对方的账号 ID，列出你和此人单聊中的文件"
     },
     "chat files --end": {
       "en": "End timestamp (inclusive)",
@@ -3467,10 +3495,6 @@
       "en": "Start timestamp (inclusive)",
       "zh-Hans": "开始时间戳（含）"
     },
-    "chat files --with-user": {
-      "en": "Peer accountId for 1-on-1 files",
-      "zh-Hans": "单聊文件的对方 accountId"
-    },
     "chat list": {
       "en": "List recent chat sessions.",
       "zh-Hans": "列出最近的聊天会话"
@@ -3488,8 +3512,12 @@
       "zh-Hans": "每页条数"
     },
     "chat messages": {
-      "en": "Fetch chat message history.\n\nProvide exactly one of:\n  --with-user      1-on-1 chat with a user\n  --group-id       a group chat\n  --category       inbox category (system / post / task / calendar /\n                   kc / hr / app / workflow)\n  --inbox-type     raw inbox type code for advanced filters",
-      "zh-Hans": "获取聊天消息历史。\n\n以下选项必须且只能提供一个：\n  --with-user      与某用户的单聊\n  --group-id       群聊\n  --category       收件箱分类（system / post / task / calendar /\n                   kc / hr / app / workflow）\n  --inbox-type     原始收件箱类型代码，用于高级筛选"
+      "en": "Fetch chat message history.\n\nProvide exactly one of:\n\n\b\n  --account-id     1-on-1 chat with a person\n  --group-id       a group chat\n  --category       inbox category (system / post / task / calendar /\n                   kc / hr / app / workflow)\n  --inbox-type     raw inbox type code for advanced filters",
+      "zh-Hans": "获取聊天消息历史。\n\n以下选项必须且只能提供一个：\n\n\b\n  --account-id     与某人的单聊\n  --group-id       群聊\n  --category       收件箱分类（system / post / task / calendar /\n                   kc / hr / app / workflow）\n  --inbox-type     原始收件箱类型代码，用于高级筛选"
+    },
+    "chat messages --account-id": {
+      "en": "Account id of the person, for your 1-on-1 chat with them",
+      "zh-Hans": "对方的账号 ID，查看你和此人的单聊"
     },
     "chat messages --category": {
       "en": "Inbox category: system, post, task, calendar, kc, hr, app, workflow",
@@ -3531,14 +3559,14 @@
       "en": "Anchor timestamp, e.g. '2026-04-07 19:06:53.038' (paginate around this)",
       "zh-Hans": "锚点时间戳，例如 '2026-04-07 19:06:53.038'（以此为基准分页）"
     },
-    "chat messages --with-user": {
-      "en": "Peer accountId for 1-on-1 messages",
-      "zh-Hans": "单聊消息的对方 accountId"
-    },
     "chat recall": {
       "en": "Recall a message you sent.\n\nYou can recall your own message within 5 minutes of sending it; a group\nadmin can recall another member's message with no time limit. A recall\ncannot be undone.",
       "zh-Hans": "撤回自己发送的消息。自己的消息限发送后 5 分钟内撤回；群管理员撤回其他成员的消息不限时间。撤回后无法恢复。"
     },
+    "chat recall --account-id": {
+      "en": "Account id of the person, for a message in your 1-on-1 chat with them",
+      "zh-Hans": "对方的账号 ID，撤回你和此人单聊中的消息"
+    },
     "chat recall --as-admin": {
       "en": "Recall as a group admin. Admins may recall another member's message; ordinary recall only covers your own.",
       "zh-Hans": "以群管理员身份撤回。管理员可撤回其他成员的消息；普通撤回只能撤回自己的。"
@@ -3559,10 +3587,6 @@
       "en": "Send time of the message. Looked up from the conversation when omitted.",
       "zh-Hans": "消息的发送时间。省略时自动从会话记录中查找。"
     },
-    "chat recall --with-user": {
-      "en": "Peer accountId for a 1-on-1 message",
-      "zh-Hans": "单聊消息的对方 accountId"
-    },
     "chat send-to-group": {
       "en": "Send a message, optionally with files, to a group chat.\n\n\b\n  hap chat send-to-group -g <groupId> -m \"spec attached\" -f ./spec.pdf\n\nText and each file arrive as separate messages, in that order. An\n@-mention applies to the text line, so it needs --message.",
       "zh-Hans": "向群聊发送消息，可附带文件。\n\n\b\n  hap chat send-to-group -g <groupId> -m \"spec attached\" -f ./spec.pdf\n\n文本和每个文件会依次作为独立消息送达。@提及作用于文本行，因此需要 --message"
@@ -3599,6 +3623,10 @@
       "en": "Send a message, optionally with files, to one or more users (1-on-1).\n\n\b\n  hap chat send-to-one -t <accountId> -m \"spec attached\" -f ./spec.pdf\n\nText and each file arrive as separate messages, in that order.\n\nTo message yourself, send to the file-transfer assistant with\n-t file-transfer. Your own account id is not a valid target.",
       "zh-Hans": "向一个或多个用户发送消息（单聊），可附带文件。\n\n  hap chat send-to-one -t <accountId> -m \"spec attached\" -f ./spec.pdf\n\n文本和每个文件会依次作为独立消息送达。\n\n给自己发消息请发到文件传输助手：-t file-transfer。自己的账号 ID 不是有效目标。"
     },
+    "chat send-to-one --account-id": {
+      "en": "Account id of the person to message (repeatable)",
+      "zh-Hans": "接收消息的人的账号 ID（可重复）"
+    },
     "chat send-to-one --dry-run": {
       "en": "Show what would be sent, without uploading or sending anything.",
       "zh-Hans": "仅显示将要发送的内容，不上传也不发送"
@@ -3615,10 +3643,6 @@
       "en": "Message text",
       "zh-Hans": "消息文本"
     },
-    "chat send-to-one --to": {
-      "en": "Target user account ID (can repeat)",
-      "zh-Hans": "目标用户账号 ID（可重复）"
-    },
     "completion": {
       "en": "Alias of `hap config completion`.",
       "zh-Hans": "`hap config completion` 的别名"

{hap_cli-0.9.8 → hap_cli-0.9.10}/hap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.9.8
+Version: 0.9.10
 Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0