sophhub 0.4.63 → 0.4.64

package/skills/claw-agent-get-send/src/scripts/appia_extensions.py

@@ -0,0 +1,370 @@
+#!/usr/bin/env python3
+"""Appia Claw 扩展能力：scopes + 人员/通知/待办/未读 + 频道 + 会议纪要/总览 + 写操作 + 聚合调用。
+
+鉴权与 appia_claw.py 一致：MCP/CLAW JWT + userId + agentId。共享 helper 见 appia_common。
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from typing import Any
+
+import appia_common as ac
+
+
+def _channel_params(args: argparse.Namespace) -> dict[str, Any]:
+    """频道类接口：--rid 优先，否则用 --name / --channel-name。"""
+    rid = args.rid or ac.cfg("TARGET_RID")
+    if rid:
+        return {"rid": rid}
+    name = args.name or args.channel_name
+    if not name:
+        sys.exit("⚠️ 需要 --rid（或 TARGET_RID）或 --name")
+    return {"name": name}
+
+
+def _load_json_arg(json_str: str | None, json_file: str | None) -> Any:
+    if json_str is not None:
+        try:
+            return json.loads(json_str)
+        except json.JSONDecodeError as exc:
+            sys.exit(f"⚠️ --json 参数解析失败: {exc}")
+    if json_file:
+        import os
+
+        with open(os.path.expanduser(json_file), encoding="utf-8") as f:
+            return json.load(f)
+    return None
+
+
+def _common_params() -> dict[str, Any]:
+    return {"userId": ac.user_id(), "agentId": ac.agent_id()}
+
+
+# ---- 读：scopes / 人员 / 通知 / 待办 / 未读 ----
+
+
+def cmd_scopes(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.scopes.get", _common_params(), args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_scopes_request(args: argparse.Namespace) -> int:
+    scopes = [s.strip() for s in args.scopes.split(",") if s.strip()]
+    body = {**_common_params(), "scopes": scopes, "reason": args.reason or ""}
+    data = ac.api_post_json("agent.scopes.request", body, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_users_search(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "q": args.q, "limit": args.limit}
+    data = ac.api_get("agent.users.search", params, args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+        return 0
+    users = (data.get("data") or {}).get("users") or []
+    print(f"total={len(users)}")
+    for u in users:
+        print(f"- _id={u.get('_id')} username={u.get('username')}")
+    return 0
+
+
+def cmd_notifications(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "limit": args.limit, "since": args.since}
+    data = ac.api_get("agent.notifications.list", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_todos(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "limit": args.limit, "status": args.status}
+    data = ac.api_get("agent.todos.list", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_unread(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.unread.summary", _common_params(), args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+# ---- 读：频道 ----
+
+
+def cmd_channels_search(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "name": args.name, "keyword": args.keyword, "limit": args.limit}
+    data = ac.api_get("agent.channels.search", params, args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+        return 0
+    chans = (data.get("data") or {}).get("channels") or (data.get("data") or {}).get("items") or []
+    print(f"total={len(chans)}")
+    for c in chans:
+        print(f"- rid={c.get('rid', c.get('_id'))} name={c.get('name')}")
+    return 0
+
+
+def cmd_channel_info(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.channel.info.get", {**_common_params(), **_channel_params(args)}, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channel_messages(args: argparse.Namespace) -> int:
+    params = {**_common_params(), **_channel_params(args), "limit": args.limit}
+    data = ac.api_get("agent.channel.messages.list", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channel_messages_search(args: argparse.Namespace) -> int:
+    params = {**_common_params(), **_channel_params(args), "keyword": args.keyword, "limit": args.limit}
+    data = ac.api_get("agent.channel.messages.search", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channel_members(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.channel.members.list", {**_common_params(), **_channel_params(args)}, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channel_attachments(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.channel.attachments.list", {**_common_params(), **_channel_params(args)}, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channel_announcements(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.channel.announcements.list", {**_common_params(), **_channel_params(args)}, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_file_metadata(args: argparse.Namespace) -> int:
+    if not args.file_id:
+        sys.exit("⚠️ file-metadata 需要 --file-id")
+    params = {**_common_params(), "fileId": args.file_id}
+    data = ac.api_get("agent.file.metadata.get", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+# ---- 读：会议纪要 / 总览 ----
+
+
+def cmd_meeting_minutes(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "limit": args.limit}
+    data = ac.api_get("agent.meeting.minutes.list", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_meeting_minutes_ingest(args: argparse.Namespace) -> int:
+    params = {**_common_params(), "limit": args.limit}
+    data = ac.api_get("agent.meeting.minutes.ingest.list", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_overview_resolve(args: argparse.Namespace) -> int:
+    if not args.url:
+        sys.exit("⚠️ overview-resolve 需要 --url")
+    params = {**_common_params(), "url": args.url}
+    data = ac.api_get("agent.overview.resolve", params, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_overview_links(args: argparse.Namespace) -> int:
+    data = ac.api_get("agent.channel.overview.links.list", {**_common_params(), **_channel_params(args)}, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+# ---- 写：待办 / 频道 / 会议 ----
+
+
+def cmd_todos_update(args: argparse.Namespace) -> int:
+    if not args.id:
+        sys.exit("⚠️ todos-update 需要 --id")
+    body: dict[str, Any] = {**_common_params(), "id": args.id, "status": args.status}
+    if args.reminder_time:
+        body["reminderTime"] = args.reminder_time
+    data = ac.api_post_json("agent.todos.update-status", body, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+def cmd_channels_create(args: argparse.Namespace) -> int:
+    members = _load_json_arg(args.members_json, args.members_file)
+    if members is None:
+        members = []
+    body: dict[str, Any] = {**_common_params(), "name": args.name or "", "members": members}
+    if args.dep_ids:
+        body["depIds"] = [d.strip() for d in args.dep_ids.split(",") if d.strip()]
+    if args.read_only:
+        body["readOnly"] = True
+    extra = _load_json_arg(args.extra_json, args.extra_file)
+    if extra is not None:
+        body["extraData"] = extra
+    data = ac.api_post_json("agent.channels.create", body, args.timeout)
+    if args.json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+        return 0
+    d = data.get("data") or {}
+    print(f"created: rid={d.get('rid')} name={(d.get('channel') or {}).get('name', args.name or '')}")
+    return 0
+
+
+def cmd_tool_invoke(args: argparse.Namespace) -> int:
+    if not args.tool:
+        sys.exit("⚠️ tool-invoke 需要 --tool")
+    tool_args = _load_json_arg(args.args_json, args.args_file)
+    body = {**_common_params(), "tool": args.tool, "args": tool_args or {}}
+    data = ac.api_post_json("agent.tool.invoke", body, args.timeout)
+    return ac.emit(data, args.json, json.dumps(data.get("data", {}), ensure_ascii=False, indent=2))
+
+
+# ---- CLI ----
+
+
+def _channel_args(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--rid", help="频道 rid（覆盖 TARGET_RID）")
+    parser.add_argument("--name", "--channel-name", dest="name", help="频道名（无 rid 时用）")
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(description="Appia Claw 扩展能力（scopes / 人员 / 通知 / 待办 / 频道 / 会议 / 总览 / 写操作）")
+    ac.add_cred_arg(p)
+    ac.add_timeout_arg(p)
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    def _json(sp):
+        ac.add_json_arg(sp)
+
+    sp = sub.add_parser("scopes", help="GET agent.scopes.get")
+    _json(sp)
+    sp.set_defaults(_run=cmd_scopes)
+
+    sp = sub.add_parser("scopes-request", help="POST agent.scopes.request（发 myAgent 授权卡片）")
+    sp.add_argument("--scopes", required=True, help="逗号分隔，如 channels:write")
+    sp.add_argument("--reason", help="申请原因")
+    _json(sp)
+    sp.set_defaults(_run=cmd_scopes_request)
+
+    sp = sub.add_parser("users-search", help="GET agent.users.search")
+    sp.add_argument("--q", required=True, help="姓名/username 关键词")
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_users_search)
+
+    sp = sub.add_parser("notifications", help="GET agent.notifications.list")
+    sp.add_argument("--limit", type=int, default=20)
+    sp.add_argument("--since", help="起始时间")
+    _json(sp)
+    sp.set_defaults(_run=cmd_notifications)
+
+    sp = sub.add_parser("todos", help="GET agent.todos.list")
+    sp.add_argument("--limit", type=int, default=20)
+    sp.add_argument("--status", help="状态过滤")
+    _json(sp)
+    sp.set_defaults(_run=cmd_todos)
+
+    sp = sub.add_parser("unread", help="GET agent.unread.summary")
+    _json(sp)
+    sp.set_defaults(_run=cmd_unread)
+
+    sp = sub.add_parser("channels-search", help="GET agent.channels.search")
+    sp.add_argument("--name", help="频道名")
+    sp.add_argument("--keyword", help="关键词")
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channels_search)
+
+    sp = sub.add_parser("channel-info", help="GET agent.channel.info.get")
+    _channel_args(sp)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_info)
+
+    sp = sub.add_parser("channel-messages", help="GET agent.channel.messages.list")
+    _channel_args(sp)
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_messages)
+
+    sp = sub.add_parser("channel-messages-search", help="GET agent.channel.messages.search")
+    _channel_args(sp)
+    sp.add_argument("--keyword", required=True)
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_messages_search)
+
+    sp = sub.add_parser("channel-members", help="GET agent.channel.members.list")
+    _channel_args(sp)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_members)
+
+    sp = sub.add_parser("channel-attachments", help="GET agent.channel.attachments.list")
+    _channel_args(sp)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_attachments)
+
+    sp = sub.add_parser("channel-announcements", help="GET agent.channel.announcements.list")
+    _channel_args(sp)
+    _json(sp)
+    sp.set_defaults(_run=cmd_channel_announcements)
+
+    sp = sub.add_parser("file-metadata", help="GET agent.file.metadata.get")
+    sp.add_argument("--file-id", required=True)
+    _json(sp)
+    sp.set_defaults(_run=cmd_file_metadata)
+
+    sp = sub.add_parser("meeting-minutes", help="GET agent.meeting.minutes.list")
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_meeting_minutes)
+
+    sp = sub.add_parser("meeting-minutes-ingest", help="GET agent.meeting.minutes.ingest.list")
+    sp.add_argument("--limit", type=int, default=20)
+    _json(sp)
+    sp.set_defaults(_run=cmd_meeting_minutes_ingest)
+
+    sp = sub.add_parser("overview-resolve", help="GET agent.overview.resolve（总览链接→元数据）")
+    sp.add_argument("--url", required=True, help="总览链接")
+    _json(sp)
+    sp.set_defaults(_run=cmd_overview_resolve)
+
+    sp = sub.add_parser("overview-links", help="GET agent.channel.overview.links.list")
+    _channel_args(sp)
+    _json(sp)
+    sp.set_defaults(_run=cmd_overview_links)
+
+    sp = sub.add_parser("todos-update", help="POST agent.todos.update-status")
+    sp.add_argument("--id", required=True, help="待办 id")
+    sp.add_argument("--status", required=True)
+    sp.add_argument("--reminder-time", dest="reminder_time")
+    _json(sp)
+    sp.set_defaults(_run=cmd_todos_update)
+
+    sp = sub.add_parser("channels-create", help="POST agent.channels.create")
+    sp.add_argument("--name", help="频道名")
+    sp.add_argument("--members-json", dest="members_json", help='username 数组 JSON，如 ["zhangsan","lisi"]')
+    sp.add_argument("--members-file", dest="members_file", help="username 数组 JSON 文件")
+    sp.add_argument("--dep-ids", dest="dep_ids", help="部门 id 逗号分隔")
+    sp.add_argument("--read-only", dest="read_only", action="store_true")
+    sp.add_argument("--extra-json", dest="extra_json", help="extraData JSON")
+    sp.add_argument("--extra-file", dest="extra_file", help="extraData JSON 文件")
+    _json(sp)
+    sp.set_defaults(_run=cmd_channels_create)
+
+    sp = sub.add_parser("tool-invoke", help="POST agent.tool.invoke（聚合调用）")
+    sp.add_argument("--tool", required=True, help="如 appia.todos.list")
+    sp.add_argument("--args-json", dest="args_json", help="args JSON")
+    sp.add_argument("--args-file", dest="args_file", help="args JSON 文件")
+    _json(sp)
+    sp.set_defaults(_run=cmd_tool_invoke)
+
+    args = p.parse_args()
+    ac.init_cred(args.cred_file)
+    runner = getattr(args, "_run", None)
+    if runner is None:
+        return 1
+    return int(runner(args))
+
+
+if __name__ == "__main__":
+    try:
+        raise SystemExit(main())
+    except Exception as exc:  # pragma: no cover - CLI
+        print(f"⚠️ {exc}", file=sys.stderr)
+        raise SystemExit(1)