@shulex/cxclawctl 0.1.2 → 0.1.3

package/skills/shulex-support/references/product-docs.md

@@ -1,70 +0,0 @@
-# 产品文档查询
-
-产品使用、配置、排障、功能说明类问题，只使用产品文档查询命令，不再调用旧的 GPT 售后知识库查询链路。
-
-### 搜索 query 写法
-
-文档搜索同时看语义和关键词。调用 `search-docs` 时，query 要像用户真实问题，但保留核心产品词、功能词和对象名：
-
-- 推荐：`我该怎么使用人机协同节点`、`Human in Loop 人机协同节点怎么配置`
-- 不推荐：只堆叠 2-3 个短关键词，尤其包含“使用”“设置”“功能”等泛词时，容易带出无关结果
-
-查看搜索结果时，优先采用标题、页面路径、内容片段都命中核心概念的结果；只因为泛词命中的结果不要引用。
-
-```bash
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py search-docs \
-  --query "<用户问题>" \
-  --pretty
-```
-
-`search-docs` 用于搜索产品文档，返回结构化结果：
-
-```json
-{
-  "query": "<用户问题>",
-  "results": [
-    {
-      "title": "<文档标题>",
-      "url": "<文档链接>",
-      "page": "<页面路径>",
-      "content": "<相关片段>"
-    }
-  ]
-}
-```
-
-当需要进一步定位或读取文档文件时，使用文件查询命令：
-
-```bash
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py query-docs-filesystem \
-  --command 'rg -il "<关键词>" / | head -10' \
-  --pretty
-```
-
-常用只读命令示例：
-
-```bash
-# 找相关文件
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py query-docs-filesystem \
-  --command 'rg -il "变量" / | head -10' \
-  --pretty
-
-# 读取某个文档开头
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py query-docs-filesystem \
-  --command 'sed -n "1,160p" /solvea/bot_cn/function-manual/agents/variables/variable-definition.mdx' \
-  --pretty
-```
-
-基于文档回答时：
-
-- 只使用 `search-docs` / `query-docs-filesystem` 返回的内容，不要编造文档里没有的信息。
-- 如果文档结果不足以回答，直接说明文档中没有找到确定依据，再引导用户补充信息或提交工单。
-- 回复末尾必须列出「参考文档」，使用命令返回的 `title` 和 `url`；没有 `url` 时只列 `page`，不要自行拼链接。
-- 有 `url` 时使用 Markdown 链接格式，避免写成 `标题：URL`。
-
-参考文档格式：
-
-```text
-参考文档：
-- [<title>](<url>)
-```

package/skills/shulex-support/references/tickets.md

@@ -1,184 +0,0 @@
-# 售后工单
-
-所有创建动作都遵循“先确认后提交”：先向用户展示整理后的工单明细，获得明确确认后才能调用创建接口。
-
-## CLI 入口
-
-工单创建、列表查询、详情查询、追加消息，继续通过本 skill 的 CLI 调用 GPT support API：
-
-```bash
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py <command> --pretty
-```
-
-可用命令：
-
-```bash
-# 创建工单（基本）
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py create-ticket \
-  --content "<问题描述>" \
-  --brand "<brand，可选>" \
-  --issue-type "<工单类型 code，见下方问题分类表>" \
-  --ext '<{"chatId":"<chatId>"}>' \
-  --subject "<工单标题，可选>" \
-  --contact-email "<邮箱，可选>" \
-  --pretty
-
-# 创建工单（带附件，可重复 --attachment）
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py create-ticket \
-  --content "<问题描述>" \
-  --issue-type "<工单类型 code>" \
-  --attachment "<沙箱内文件路径>" \
-  --attachment "<另一个文件路径（可选）>" \
-  --pretty
-
-# 分页查询工单列表
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py list-tickets \
-  --page 1 \
-  --page-size 20 \
-  --pretty
-
-# 查询工单详情和消息
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py get-ticket \
-  --ticket-number "<工单号>" \
-  --pretty
-
-# 追加客户消息
-npx --yes @shulex/cxclawctl@latest script skills/shulex-support/scripts/support.py append-message \
-  --ticket-number "<工单号>" \
-  --content "<用户补充描述>" \
-  --pretty
-```
-
-## 提交工单信息
-
-创建工单前尽量整理以下信息：
-
-| 字段 | 说明 |
-|---|---|
-| 问题描述 | 用户遇到的问题、期望结果、实际结果 |
-| 问题分类 | 见下方「问题分类」表，选对应 code |
-| 扩展字段 | 按分类填写必要字段（见下方「按分类必填」） |
-| 附件 | 用户提供的截图/日志等文件，通过 `--attachment` 上传 |
-| 来源信息 | 当前会话或页面上下文中可用的 sourceType/sourceId |
-| 品牌 | 如果上下文能拿到 brand 则带上；拿不到不要让用户反复补 |
-| 联系邮箱 | 可选，用于后续通知 |
-
-### 问题描述：使用纯文本
-
-`--content` 里的工单描述使用纯文本，不使用 Markdown 标题、列表、表格或 HTML。内容要准确、精准、客观，方便客服和研发直接阅读、定位和复制处理。建议包含：
-
-- 问题现象
-- 期望结果和实际结果
-- 已尝试的排查步骤
-- 相关 ID、时间点、截图或日志说明
-
-不要写 `# 标题`、`- 列表项`、Markdown 表格、HTML 标签或 `\n` 这种字面量转义。需要分段时，直接使用正常换行。
-
-### 问题分类
-
-| code | 中文含义 |
-|---|---|
-| `agent_badcase` | AI 客服异常/Bug |
-| `consult` | 产品咨询 |
-| `agent_feature` | AI 客服功能需求 |
-| `integration_feature` | 集成需求 |
-| `ticket_feature` | 工单功能需求 |
-| `ticket_bug` | 工单 Bug |
-| `other` | 其他 |
-
-### 按分类必填（放 `--ext`）
-
-| 分类 code | 必填 ext 字段 | 说明 |
-|---|---|---|
-| `agent_badcase` | `chatId` | 异常对话的 Chat ID，用于定位问题 |
-| `ticket_bug` | `relatedTicketId` | 相关工单 ID，便于复现和定位 |
-
-其余分类无强制 ext 字段；`--ext` 可省略。
-
-### 附件上传说明
-
-用户上传的截图、日志等文件，脚本内部会在建单前自动先将每个附件 POST 到上传端点取得 URL，再随建单请求一并提交，整个过程对 agent 透明。调用方式：
-
-```bash
---attachment <沙箱内文件路径>
-```
-
-- 每个 `--attachment` 指定一个文件，可重复使用以上传多个文件。
-- 正文里只写图片说明；真实截图、日志等文件通过 `--attachment` 上传。
-
-### 问题描述：准确、精准地整理
-
-`--content` 不是简单复制用户某一句话，而是结合整段对话上下文，**站在用户立场**重新整理，准确表达用户当前真正的诉求：
-
-- **准确、精准、客观**：用专业清晰的描述表达问题，不要太口语化、情绪化或闲聊化；可以保留必要的第一人称，但不要写成第三人称客服转述（不要"该用户反馈……"）。
-- **整合上下文**：把多轮对话里零散的信息（现象、已尝试的操作、期望结果、实际结果、相关 ID/截图说明）汇总成一段完整、自洽的描述。
-- **准确不夸大**：只写对话里真实出现的信息，不要替用户编造未确认的细节、原因或诉求；用户表达模糊时如实保留，不要脑补。
-- **聚焦真实诉求**：先点明用户现在最想解决/想要的是什么，再补背景，避免被中间的闲聊带偏。
-
-### 创建前必须先确认（强制）
-
-整理好工单明细后，**先把明细完整列给用户确认，得到明确同意才调用 `create-ticket`**。不要跳过确认直接创建。
-
-向用户展示的明细至少包含：
-
-```text
-即将为你创建售后工单，请确认以下内容：
-
-- 问题描述：<以用户口吻整理后的完整描述>
-- 问题分类：<分类中文名>
-- 扩展字段：<如 chatId、relatedTicketId 等，无则省略>
-- 附件：<文件名列表，无则省略>
-- 工单标题：<subject，可选>
-- 联系邮箱：<contactEmail，可选>
-
-确认无误我就提交；需要修改的话告诉我要改哪里。
-```
-
-- 用户确认后再执行 `create-ticket`，并把确认后的描述作为 `--content`。
-- 用户要求修改时，按反馈改完重新展示明细，再次确认后才提交。
-- 用户没有明确确认前，不要调用创建接口。
-
-创建后必须根据接口返回的 `status` 判断结果，并且只向用户展示客户可见工单号 `ticketNumber`。不要向用户解释"本地工单""同步""Tars""内部客服系统"等实现细节：
-
-- `status == "created"`：明确告知工单创建成功，给出工单号，并把工单号渲染成可点击的 Markdown 链接，链接使用脚本返回的 `ticketDetailUrl`；同时按下方话术规范给出预估跟进时效与后续方式。
-- `status == "syncing"`：说明已收到并正在受理工单，可给工单号；同样把工单号渲染成可点击的 Markdown 链接，链接使用脚本返回的 `ticketDetailUrl`；用"正在受理"措辞，不要承诺客服已接单，跟进时效可照常给出。
-- `status == "sync_failed"`：说明工单暂时提交失败，致歉并建议稍后重试或联系 Shulex 客服；不要说"创建成功"，也不要给跟进时效承诺。
-- `tarsTicketNumber` / `shulexTicketNumber` 是内部字段，不能展示给用户，不能拿它替代 `ticketNumber`。
-
-### 售后客服话术规范（创建成功后）
-
-用专业、有温度的售后客服语气回复，包含以下要素（按需裁剪，不要机械堆砌）：
-
-1. **确认受理 + 适度共情**：先告诉用户问题已收到、工单已建好；若用户明显受困扰，简短致歉（"给你带来不便很抱歉"），不要过度道歉。
-2. **工单号**：先直接展示 `ticketNumber`，再用脚本返回的 `ticketDetailUrl` 拼出“工单详情页”的 Markdown 链接，方便后续追踪。
-3. **预估时效**：给出明确的跟进时效，默认 **售后团队会在 2–5 个工作日内跟进处理（节假日顺延）**；可按紧急度调整措辞（严重问题会优先处理），但**只承诺"跟进 / 回复"的时效，不承诺具体解决时间或结果**。
-4. **后续跟进方式**：说明会有售后人员跟进；用户可凭工单号在「售后工单」列表查看进度、随时把工单号发给我继续补充信息 / 上传截图日志；若填写了联系邮箱，进展也会通过邮件通知。
-5. **礼貌收尾**：感谢用户的耐心与反馈。
-
-约束：
-
-- 不透露任何内部实现（Tars、本地工单、同步、内部客服系统等）。
-- 不编造未发生的事（如"客服已接单""预计今天解决"）；时效只说预估，不打包票。
-- 时效与 `status` 匹配：仅 `created` / `syncing` 给跟进时效；`sync_failed` 不给时效，改为致歉 + 重试 / 联系客服建议。
-
-成功话术示例：
-
-```text
-你好，你的售后工单已经创建好了。
-
-工单号：CX-1
-你可以点击跳转至[工单详情页](https://ai-staging.solvea.cx/chatbot#/support/tickets/CX-1)查看此工单进展，建议留存方便后续追踪。
-
-我们已经收到你反馈的问题，售后团队会在 2–5 个工作日内跟进处理（节假日顺延），有进展会第一时间同步给你。处理期间你可以：
-- 在「售后工单」列表凭工单号查看最新进度；
-- 直接把工单号发给我，继续补充信息或上传截图 / 日志，我会同步到这条工单；
-- 若你留了联系邮箱，后续进展也会通过邮件通知你。
-
-给你带来不便很抱歉，感谢你的耐心与反馈！
-```
-
-## 查询与追加
-
-- 查询时回答当前状态、最新一条人工回复、下一步建议。
-- 追加时先确认目标工单号，再把用户的新描述作为客户补充消息追加到该工单。
-- 如果用户在当前对话里直接问"我那个工单怎么样了"，但没有可定位的工单号，先让用户提供工单号。

package/skills/shulex-support/scripts/support.py

@@ -1,427 +0,0 @@
-#!/usr/bin/env python3
-"""CLI for Shulex product docs lookup and support ticket APIs.
-
-Usage:
-  python3 /skills/shulex-support/scripts/support.py search-docs --query "how to connect" --pretty
-  python3 /skills/shulex-support/scripts/support.py query-docs-filesystem --command 'rg -il "变量" / | head -10' --pretty
-  python3 /skills/shulex-support/scripts/support.py create-ticket --content "help me" --pretty
-  python3 /skills/shulex-support/scripts/support.py list-tickets --page 1 --page-size 20 --pretty
-  python3 /skills/shulex-support/scripts/support.py get-ticket --ticket-number CX-1 --pretty
-  python3 /skills/shulex-support/scripts/support.py append-message --ticket-number CX-1 --content "more details" --pretty
-"""
-from __future__ import annotations
-
-import argparse
-import asyncio
-import json
-import mimetypes
-import os
-import re
-import sys
-import uuid
-from typing import Any
-from urllib import error, parse, request
-
-sys.path.insert(0, os.path.join(os.environ["SOLVEA_LIB_DIR"], "skill-runtime"))
-from bootstrap import *  # noqa: F401,F403
-
-
-def _base_url() -> str:
-    env = os.environ.get("SOLVEA_ENV", "prod")
-    if env == "prod":
-        base_url = os.environ.get("SOLVEA_PROD_URL", "https://apps.voc.ai").strip()
-    else:
-        base_url = os.environ.get("SOLVEA_BASE_URL", "https://apps-staging.voc.ai").strip()
-    return f"{base_url.rstrip('/')}/api_v2/gpt"
-
-
-def _support_ticket_origin() -> str:
-    env = os.environ.get("SOLVEA_ENV", "prod")
-    if env == "prod":
-        return os.environ.get("SOLVEA_SUPPORT_PORTAL_URL", "https://ai.solvea.cx").rstrip("/")
-    return os.environ.get("SOLVEA_SUPPORT_PORTAL_URL_STAGING", "https://ai-staging.solvea.cx").rstrip("/")
-
-
-def _headers() -> dict[str, str]:
-    headers = {"Content-Type": "application/json"}
-    env = os.environ.get("SOLVEA_ENV", "prod")
-    if env == "prod":
-        token = os.environ.get("SOLVEA_PROD_TOKEN", "").strip() or os.environ.get("SOLVEA_TOKEN", "").strip()
-        cookie_name = "_token"
-    else:
-        token = os.environ.get("SOLVEA_TOKEN", "").strip()
-        cookie_name = "_token_staging"
-    if token:
-        headers["Cookie"] = f"{cookie_name}={token}"
-    # 透传当前请求的 trace，让 gpt/ARMS 续上同一条链路（SLS 可按一个 trace 串到底）；env 没有就不带，不影响独立运行
-    traceparent = os.environ.get("TRACEPARENT", "").strip()
-    if traceparent:
-        headers["traceparent"] = traceparent
-    return headers
-
-
-def _request(
-    method: str,
-    path: str,
-    payload: dict[str, Any] | bytes | None = None,
-    headers: dict[str, str] | None = None,
-) -> dict[str, Any]:
-    url = f"{_base_url()}{path}"
-    if payload is None:
-        data = None
-    elif isinstance(payload, bytes):
-        data = payload
-    else:
-        data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
-    req = request.Request(url, data=data, method=method.upper(), headers=headers or _headers())
-    try:
-        with request.urlopen(req, timeout=30) as resp:
-            body = resp.read().decode("utf-8")
-    except error.HTTPError as exc:
-        body = exc.read().decode("utf-8", errors="replace")
-        raise RuntimeError(f"HTTP {exc.code} {method.upper()} {url}: {body}") from exc
-    except error.URLError as exc:
-        raise RuntimeError(f"HTTP request failed {method.upper()} {url}: {exc.reason}") from exc
-    return json.loads(body) if body else {}
-
-
-def _unwrap_result(payload: dict[str, Any]) -> Any:
-    if payload.get("code") != 200:
-        raise RuntimeError(payload.get("message") or "support ticket API failed")
-    return payload.get("data")
-
-
-_DOCS_SERVICE_URL = "https://solvea-39f11a36.mintlify.app/mcp"
-_DOCS_PREVIEW_URL_PREFIX = "https://solvea-39f11a36.mintlify.app/"
-_PUBLIC_DOCS_URL_PREFIX = "https://www.voc.ai/cn/docs/"
-
-
-def _tool_text_blocks(result: Any) -> list[str]:
-    blocks = []
-    for item in getattr(result, "content", None) or []:
-        text = getattr(item, "text", None)
-        if isinstance(text, str):
-            blocks.append(text)
-        elif isinstance(item, dict) and isinstance(item.get("text"), str):
-            blocks.append(item["text"])
-    return blocks
-
-
-def _call_docs_tool(tool_name: str, arguments: dict[str, Any]) -> list[str]:
-    """Call the product docs service and return text content blocks."""
-
-    timeout = float(os.environ.get("SOLVEA_DOCS_MCP_TIMEOUT_SECONDS", "30"))
-
-    async def _call() -> list[str]:
-        from mcp import ClientSession
-        from mcp.client.streamable_http import streamablehttp_client
-
-        async with streamablehttp_client(_DOCS_SERVICE_URL, timeout=timeout, sse_read_timeout=timeout) as (
-            read,
-            write,
-            _get_session_id,
-        ):
-            async with ClientSession(read, write) as session:
-                await session.initialize()
-                result = await session.call_tool(tool_name, arguments)
-
-        if getattr(result, "isError", False):
-            text = "\n".join(_tool_text_blocks(result)).strip()
-            raise RuntimeError(text or f"Product docs query failed: {tool_name}")
-        return _tool_text_blocks(result)
-
-    return asyncio.run(asyncio.wait_for(_call(), timeout=timeout + 5))
-
-
-def _parse_search_result_block(text: str) -> dict[str, Any]:
-    lines = text.splitlines()
-    result: dict[str, Any] = {}
-    content_lines: list[str] = []
-    in_content = False
-    for line in lines:
-        if in_content:
-            content_lines.append(line)
-            continue
-        if line.startswith("Title: "):
-            result["title"] = line[len("Title: "):].strip()
-        elif line.startswith("Link: "):
-            result["url"] = line[len("Link: "):].strip()
-        elif line.startswith("Page: "):
-            result["page"] = line[len("Page: "):].strip()
-        elif line.startswith("Content:"):
-            first_line = line[len("Content:"):].lstrip()
-            if first_line:
-                content_lines.append(first_line)
-            in_content = True
-    content = "\n".join(content_lines).strip()
-    if content:
-        result["content"] = content
-    if not result:
-        result["content"] = text
-    return result
-
-
-def _public_docs_url(url: str) -> str:
-    if not url.startswith(_DOCS_PREVIEW_URL_PREFIX):
-        return url
-    path = url[len(_DOCS_PREVIEW_URL_PREFIX):]
-    fragment = ""
-    if "#" in path:
-        path, fragment = path.split("#", 1)
-        fragment = f"#{fragment}"
-    if path.startswith("solvea/bot_cn/"):
-        return _PUBLIC_DOCS_URL_PREFIX + "bot/" + path.rsplit("/", 1)[-1] + fragment
-    if path.startswith("updates/log_cn/log/"):
-        version = path.rsplit("/", 1)[-1]
-        version = re.sub(r"^(V|v)(\d+)-(\d+)-(\d+)$", r"\1\2.\3.\4", version)
-        version = re.sub(r"^(version\d+)-(\d+)-(\d+)$", r"\1.\2.\3", version)
-        return _PUBLIC_DOCS_URL_PREFIX + "log/" + version + fragment
-    return _PUBLIC_DOCS_URL_PREFIX + path + fragment
-
-
-def _cmd_search_docs(args: argparse.Namespace) -> Any:
-    blocks = _call_docs_tool("search_solvea", {"query": args.query})
-    results = [_parse_search_result_block(block) for block in blocks]
-    for result in results:
-        url = result.get("url")
-        if isinstance(url, str):
-            result["url"] = _public_docs_url(url)
-    return {
-        "query": args.query,
-        "results": results,
-    }
-
-
-def _cmd_query_docs_filesystem(args: argparse.Namespace) -> Any:
-    blocks = _call_docs_tool("query_docs_filesystem_solvea", {"command": args.command})
-    return {
-        "command": args.command,
-        "output": blocks,
-    }
-
-
-def _normalize_create_ticket_result(ticket: Any) -> Any:
-    if not isinstance(ticket, dict):
-        return ticket
-    # 只返回客户相关字段；内部字段（sourceType/sourceId、tars/shulex 工单号、同步时间戳等）一律不透出
-    ticket_number = ticket.get("ticketNumber")
-    result = {
-        "ticketNumber": ticket_number,
-        "ticketDetailUrl": (
-            f"{_support_ticket_origin()}/chatbot#/support/tickets/{ticket_number}"
-            if ticket_number
-            else None
-        ),
-        "status": ticket.get("status"),
-        "subject": ticket.get("subject"),
-        "issueType": ticket.get("issueType"),
-        "createdAt": ticket.get("createdAt"),
-    }
-    return {k: v for k, v in result.items() if v is not None}
-
-
-def _upload_attachment(path: str) -> dict[str, Any]:
-    """上传本地文件到附件端点，返回 {name, url, mimeType}。
-
-    用 stdlib urllib 手工构造 multipart/form-data body，字段名 file。
-    保留 token cookie，Content-Type 换成 multipart/form-data; boundary=...。
-    """
-    filename = os.path.basename(path)
-    mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
-
-    with open(path, "rb") as f:
-        file_bytes = f.read()
-
-    boundary = uuid.uuid4().hex
-
-    def _field_bytes(name: str, data: bytes, fname: str, content_type: str) -> bytes:
-        header = (
-            f"--{boundary}\r\n"
-            f'Content-Disposition: form-data; name="{name}"; filename="{fname}"\r\n'
-            f"Content-Type: {content_type}\r\n"
-            f"\r\n"
-        ).encode("utf-8")
-        return header + data + b"\r\n"
-
-    body = _field_bytes("file", file_bytes, filename, mime_type)
-    body += f"--{boundary}--\r\n".encode("utf-8")
-
-    hdrs = _headers()
-    hdrs["Content-Type"] = f"multipart/form-data; boundary={boundary}"
-
-    return _unwrap_result(_request("POST", "/support/tickets/attachments/upload", body, hdrs))
-
-
-def _report_ticket_created(result: Any, source_id: str) -> None:
-    """非阻塞上报“创建了工单”到 support_skill_metrics；失败只打日志，绝不影响建单。
-
-    带当前请求 token，tenantId 由 gpt 从 token 解析。
-    """
-    ticket_number = result.get("ticketNumber") if isinstance(result, dict) else None
-    try:
-        _request(
-            "POST",
-            "/support/skill-metrics",
-            {
-                "chatId": source_id,
-                "ticketNumber": ticket_number,
-            },
-            _headers(),
-        )
-    except Exception as exc:  # noqa: BLE001 上报失败不影响建单
-        print(
-            f"support_skill_metrics ticket report failed chatId={source_id} error={exc}",
-            file=sys.stderr,
-        )
-
-
-def _cmd_create_ticket(args: argparse.Namespace) -> Any:
-    source_id = os.environ.get("CHAT_ID", "").strip()
-    if not source_id:
-        raise RuntimeError("CHAT_ID is not configured")
-
-    # 先上传附件，收集 attachments 列表
-    attachments = []
-    for att_path in getattr(args, "attachment", None) or []:
-        att = _upload_attachment(att_path)
-        attachments.append(att)
-
-    # 工单类型：--issue-type 优先，没有时回退到 --category（兼容别名）
-    issue_type = getattr(args, "issue_type", None) or getattr(args, "category", None)
-
-    # 扩展字段
-    ext_fields: dict[str, Any] | None = None
-    ext_str = getattr(args, "ext", None)
-    if ext_str:
-        ext_fields = json.loads(ext_str)
-
-    payload: dict[str, Any] = {
-        "content": args.content,
-        "sourceType": "cxclaw",
-        "sourceId": source_id,
-        "brand": args.brand,
-        "issueType": issue_type,
-        "subject": args.subject,
-        "contactEmail": args.contact_email,
-    }
-    if ext_fields is not None:
-        payload["extFields"] = ext_fields
-    if attachments:
-        payload["attachments"] = attachments
-
-    result = _unwrap_result(
-        _request(
-            "POST",
-            "/support/tickets/create",
-            payload,
-            _headers(),
-        )
-    )
-    _report_ticket_created(result, source_id)
-    return _normalize_create_ticket_result(result)
-
-
-def _cmd_list_tickets(args: argparse.Namespace) -> Any:
-    return _unwrap_result(
-        _request(
-            "POST",
-            "/support/tickets",
-            {"page": args.page, "pageSize": args.page_size},
-            _headers(),
-        )
-    )
-
-
-def _cmd_get_ticket(args: argparse.Namespace) -> Any:
-    ticket_number = parse.quote(args.ticket_number, safe="")
-    return _unwrap_result(
-        _request(
-            "GET",
-            f"/support/tickets/{ticket_number}",
-            None,
-            _headers(),
-        )
-    )
-
-
-def _cmd_append_message(args: argparse.Namespace) -> Any:
-    ticket_number = parse.quote(args.ticket_number, safe="")
-    return _unwrap_result(
-        _request(
-            "POST",
-            f"/support/tickets/{ticket_number}/messages",
-            {"content": args.content},
-            _headers(),
-        )
-    )
-
-
-def _add_pretty_arg(parser: argparse.ArgumentParser) -> None:
-    parser.add_argument("--pretty", action="store_true", help="Pretty-print JSON output.")
-
-
-def _build_arg_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(description="Call Shulex docs lookup and support ticket APIs.")
-    _add_pretty_arg(parser)
-    sub = parser.add_subparsers(dest="command", required=True)
-
-    search = sub.add_parser("search-docs", help="Search Shulex product docs.")
-    _add_pretty_arg(search)
-    search.add_argument("--query", required=True)
-    search.set_defaults(func=_cmd_search_docs)
-
-    docs_fs = sub.add_parser("query-docs-filesystem", help="Run a read-only query against product docs files.")
-    _add_pretty_arg(docs_fs)
-    docs_fs.add_argument("--command", required=True)
-    docs_fs.set_defaults(func=_cmd_query_docs_filesystem)
-
-    create = sub.add_parser("create-ticket", help="Create a support ticket.")
-    _add_pretty_arg(create)
-    create.add_argument("--content", required=True)
-    create.add_argument("--brand", default=None)
-    create.add_argument("--issue-type", default=None,
-                        help="Issue type code: agent_badcase / consult / agent_feature / "
-                             "integration_feature / ticket_feature / ticket_bug / other")
-    create.add_argument("--category", default=None, help="Deprecated alias for --issue-type.")
-    create.add_argument("--ext", default=None,
-                        help="JSON string of extra fields, e.g. '{\"chatId\":\"c1\"}'")
-    create.add_argument("--attachment", action="append", default=None,
-                        help="Path to a local file to attach (may be repeated).")
-    create.add_argument("--subject", default=None)
-    create.add_argument("--contact-email", default=None)
-    create.set_defaults(func=_cmd_create_ticket)
-
-    list_tickets = sub.add_parser("list-tickets", help="List current tenant support tickets.")
-    _add_pretty_arg(list_tickets)
-    list_tickets.add_argument("--page", type=int, default=1)
-    list_tickets.add_argument("--page-size", type=int, default=20)
-    list_tickets.set_defaults(func=_cmd_list_tickets)
-
-    get = sub.add_parser("get-ticket", help="Get support ticket detail and messages.")
-    _add_pretty_arg(get)
-    get.add_argument("--ticket-number", required=True)
-    get.set_defaults(func=_cmd_get_ticket)
-
-    append = sub.add_parser("append-message", help="Append a customer message to a support ticket.")
-    _add_pretty_arg(append)
-    append.add_argument("--ticket-number", required=True)
-    append.add_argument("--content", required=True)
-    append.set_defaults(func=_cmd_append_message)
-
-    return parser
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = _build_arg_parser()
-    args = parser.parse_args(argv)
-    result = args.func(args)
-    print(json.dumps(result, ensure_ascii=False, indent=2 if args.pretty else None))
-    return 0
-
-
-if __name__ == "__main__":
-    try:
-        raise SystemExit(main())
-    except Exception as exc:
-        print(json.dumps({"error": str(exc)}, ensure_ascii=False), file=sys.stderr)
-        raise SystemExit(1)