echopai 2.3.0 → 2.5.0

package/dist/_generated/operations.js

@@ -1,2385 +0,0 @@
-/**
- * AUTO-GENERATED — DO NOT EDIT BY HAND.
- *
- * Source: docs/api-contract/openapi.yaml (operations with x-cli-key + x-visibility: public)
- * Generator: scripts/codegen/generate_cli_v2.py
- *
- * Regenerate:
- *   make codegen
- */
-export const OPERATIONS = {
-    "agent.session-end": {
-        "cliKey": "agent.session-end",
-        "cliName": "agent session-end",
-        "method": "POST",
-        "path": "/v1/agent/session/{id}/end",
-        "description": "关闭 `/v1/agent/session/start` 开启的会话，最终用量提交入库。",
-        "summary": "End a billable agent session",
-        "positional": [
-            "id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": true,
-        "scopesAny": [
-            "agent:session.create",
-            "agent:session.read"
-        ],
-        "sideEffect": "write",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "id": {
-                    "type": "string",
-                    "description": "Session id returned by /v1/agent/session/start."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "id"
-            ]
-        }
-    },
-    "agent.session-start": {
-        "cliKey": "agent.session-start",
-        "cliName": "agent session-start",
-        "method": "POST",
-        "path": "/v1/agent/session/start",
-        "description": "开启 agent kind 凭据的计费会话。返回 session_id，用于将多次调用归并到一次 billable 单位。需要 `Idempotency-Key` 头。",
-        "summary": "Start a billable agent session",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": true,
-        "scopesAny": [
-            "agent:session.create"
-        ],
-        "sideEffect": "write",
-        "dryRunSupported": true,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "agent_id": {
-                    "type": "string",
-                    "maxLength": 200,
-                    "description": "Partner-defined agent identifier (max 200 chars).",
-                    "example": "agent-prod-1"
-                },
-                "conversation_id": {
-                    "type": "string",
-                    "maxLength": 200,
-                    "description": "Optional conversation thread id (max 200 chars)."
-                },
-                "scopes": {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    },
-                    "description": "Subset of partner scopes to derive into the agent token. Omit for \"all derivable from partner scopes\"."
-                },
-                "budget_usd": {
-                    "type": "number",
-                    "exclusiveMinimum": 0,
-                    "maximum": 1000,
-                    "default": 1.0,
-                    "description": "Hard USD budget cap; session terminates when exhausted (0 < x ≤ 1000).",
-                    "example": 1.0
-                },
-                "ttl_seconds": {
-                    "type": "integer",
-                    "minimum": 60,
-                    "maximum": 28800,
-                    "default": 3600,
-                    "description": "Session lifetime cap (60 ≤ x ≤ 28800, default 1h)."
-                },
-                "metadata": {
-                    "type": "object",
-                    "description": "Free-form JSON object for partner bookkeeping (e.g. user_intent, model name)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "agent_id"
-            ]
-        }
-    },
-    "agent.session-usage": {
-        "cliKey": "agent.session-usage",
-        "cliName": "agent session-usage",
-        "method": "GET",
-        "path": "/v1/agent/session/{id}/usage",
-        "description": "返回 session 内累计 billable 调用次数、各 scope 配额消耗。",
-        "summary": "Get cumulative usage of an agent session",
-        "positional": [
-            "id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "agent:session.create",
-            "agent:session.read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "id": {
-                    "type": "string",
-                    "description": "Session id returned by /v1/agent/session/start."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "id"
-            ]
-        }
-    },
-    "announcements.detail": {
-        "cliKey": "announcements.detail",
-        "cliName": "announcements detail",
-        "method": "GET",
-        "path": "/v1/announcements/{announcement_id}",
-        "description": "返回公告完整内容：content_md、content_text、cninfo 元数据、解析状态。",
-        "summary": "Fetch a single announcement by id",
-        "positional": [
-            "announcement_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "announcements:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "announcement_id": {
-                    "type": "string",
-                    "format": "uuid",
-                    "description": "UUID（feed / stock 返回的 items[].id）。"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "announcement_id"
-            ]
-        }
-    },
-    "announcements.feed": {
-        "cliKey": "announcements.feed",
-        "cliName": "announcements feed",
-        "method": "GET",
-        "path": "/v1/announcements/feed",
-        "description": "A 股公告 feed，按 published_at 降序、同日按 cninfo source_id 降序。可按 type / since 过滤。需要 `announcements:read` scope。",
-        "summary": "List recent A-share announcements",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "offset",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "announcements:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "since": {
-                    "type": "string",
-                    "format": "date-time",
-                    "description": "ISO datetime 下限（published_at >= since）。"
-                },
-                "type": {
-                    "type": "string",
-                    "maxLength": 64,
-                    "description": "分类 slug（见 classifier.py TYPES，如 annual_report、equity_change）。"
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 200,
-                    "default": 50,
-                    "description": "Max items per page."
-                },
-                "offset": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "default": 0,
-                    "description": "Pagination offset (items to skip)."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "announcements.stock": {
-        "cliKey": "announcements.stock",
-        "cliName": "announcements stock",
-        "method": "GET",
-        "path": "/v1/announcements/stock",
-        "description": "指定股票代码的公告列表（含历史窗口）。代码接受 6 位纯数字或 SSE:600519 / SZSE:000001 / BSE:430000 形式。需要 `announcements:read` scope。",
-        "summary": "List announcements for a specific A-share security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "offset",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "announcements:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "since_days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 1825,
-                    "default": 30,
-                    "description": "回看天数（最多 5 年）。"
-                },
-                "type": {
-                    "type": "string",
-                    "maxLength": 64,
-                    "description": "分类 slug 过滤（与 /v1/announcements/feed 同集合）。"
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 200,
-                    "default": 50,
-                    "description": "Max items per page."
-                },
-                "offset": {
-                    "type": "integer",
-                    "minimum": 0,
-                    "default": 0,
-                    "description": "Pagination offset (items to skip)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "auth.whoami": {
-        "cliKey": "auth.whoami",
-        "cliName": "auth whoami",
-        "method": "GET",
-        "path": "/v1/auth/whoami",
-        "description": "Returns the calling token's kind, scopes, audience, app metadata,\nrate_limit, allowed_clients, agent_budget (if kind=agent), api_version,\nfeature_flags. Any valid JWT can call — no specific scope required.\n\nCLI/MCP call this once at startup, cache 5 minutes in-process, and use\nthe response to derive `verbs.available` (intersection of curated verb\nscopes with token scopes) and to populate `echopai doctor` checks.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §5.1.\n",
-        "summary": "Token introspection (CLI/MCP capability discovery)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "bars.daily": {
-        "cliKey": "bars.daily",
-        "cliName": "bars daily",
-        "method": "GET",
-        "path": "/v1/bars/daily",
-        "description": "Daily OHLC bars for one A-share security over a date range. Returns open / high / low / close / volume / turnover per trading day. Requires `bars:30d` (last 30 trading days) or `bars:full` (full history) scope.",
-        "summary": "Daily OHLC bars for one A-share security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:30d",
-            "bars:full"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive start date (YYYY-MM-DD).",
-                    "example": "2026-01-01"
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date (YYYY-MM-DD).",
-                    "example": "2026-05-01"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "bars.daily-batch": {
-        "cliKey": "bars.daily-batch",
-        "cliName": "bars daily-batch",
-        "method": "GET",
-        "path": "/v1/bars/daily-batch",
-        "description": "Batch daily OHLC bars for multiple A-share securities. Up to 100 codes\nper call, up to 1-year date range. Single round-trip; ClickHouse `IN(...)`\nunder the hood.\n\nReturns partial success envelope: codes denied by `allowed_securities`\nappear in `errors[]`, others in `items[]` (with empty `bars[]` if no\ndata found). Order in `items[]` matches input order.\n\nRequires `bars:30d` or `bars:full` scope.\n",
-        "summary": "Batch daily OHLC bars for up to 100 A-share securities",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:30d",
-            "bars:full"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                        "example": "SSE:600519"
-                    },
-                    "minItems": 1,
-                    "maxItems": 100,
-                    "description": "1-100 canonical codes; CSV-encoded on the wire.",
-                    "example": [
-                        "SSE:600519",
-                        "SZSE:000001"
-                    ]
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive start date (YYYY-MM-DD)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date (YYYY-MM-DD). Range must be ≤ 365 days."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "codes",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "bars.minute": {
-        "cliKey": "bars.minute",
-        "cliName": "bars minute",
-        "method": "GET",
-        "path": "/v1/bars/minute",
-        "description": "Minute-level OHLC bars for one A-share security on a single trade date. Requires `bars:30d` or `bars:full` scope.",
-        "summary": "Minute-level OHLC bars for one A-share security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:30d",
-            "bars:full"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Single trade date (YYYY-MM-DD). Returns 240 minute bars for that session.",
-                    "example": "2026-05-09"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code",
-                "date"
-            ]
-        }
-    },
-    "bars.minute-batch": {
-        "cliKey": "bars.minute-batch",
-        "cliName": "bars minute-batch",
-        "method": "GET",
-        "path": "/v1/bars/minute-batch",
-        "description": "Batch minute OHLC bars for multiple A-share securities. Up to 20 codes\nper call, up to 7 calendar days (≈5 trading days) date range. Single\nClickHouse round-trip; app groups rows by canonical_code.\n\nPartial success envelope same as daily-batch: codes denied by\n`allowed_securities` go to `errors[]`; others to `items[]` with flat\n`bars[]` (each bar carries its own `trade_date` for client grouping).\n\nRequires `bars:30d` or `bars:full` scope.\n",
-        "summary": "Batch minute OHLC bars for up to 20 A-share securities",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:30d",
-            "bars:full"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                        "example": "SSE:600519"
-                    },
-                    "minItems": 1,
-                    "maxItems": 20,
-                    "description": "1-20 canonical codes; CSV-encoded on the wire.",
-                    "example": [
-                        "SSE:600519",
-                        "SZSE:000001"
-                    ]
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive start date (YYYY-MM-DD)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date. Range must be ≤ 7 calendar days."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "codes",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "concepts.alerts": {
-        "cliKey": "concepts.alerts",
-        "cliName": "concepts alerts",
-        "method": "GET",
-        "path": "/v1/concepts/alerts",
-        "description": "Returns the live `concept_alerts:active` hash. Two rules:\n  - big_move: abs(pct_change) > 3%\n  - limit_up_cluster: limit_up_count >= 3 AND stock_count >= 5\nSee PLAN_CONCEPT_INDUSTRY_QUOTE §5.5 \"异动检测与推送\".\n",
-        "summary": "Currently active concept alerts (big_move / limit_up_cluster)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "concepts.alerts-history": {
-        "cliKey": "concepts.alerts-history",
-        "cliName": "concepts alerts-history",
-        "method": "GET",
-        "path": "/v1/concepts/alerts/history",
-        "description": "Concept异动 historical events (default last 24h). Filter by rule (big_move / limit_up_cluster) and time window. Used by AI agent / admin review.",
-        "summary": "Concept alerts history (last 24h)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "from": {
-                    "type": "integer",
-                    "description": "Unix ms; default = now - 24h"
-                },
-                "to": {
-                    "type": "integer",
-                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
-                },
-                "rule": {
-                    "type": "string",
-                    "enum": [
-                        "big_move",
-                        "limit_up_cluster"
-                    ],
-                    "description": "Filter by alert rule: big_move (|pct| > 3%) or limit_up_cluster (≥3 limit-ups & ≥5 stocks)."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 2000,
-                    "default": 500,
-                    "description": "Maximum number of items to return."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "concepts.daily-bars": {
-        "cliKey": "concepts.daily-bars",
-        "cliName": "concepts daily-bars",
-        "method": "GET",
-        "path": "/v1/concepts/{concept_id}/daily-bars",
-        "description": "Returns daily OHLC (concept index points, not stock prices average),\nbreadth fields, and is_backfilled flag. See PLAN §5.4 algorithm.\n",
-        "summary": "Concept index daily bars (chain-linked equal-weight, base 1000)",
-        "positional": [
-            "concept_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "concept_id": {
-                    "type": "integer",
-                    "description": "Concept primary key (PG concepts.id)."
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "concept_id",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "concepts.list": {
-        "cliKey": "concepts.list",
-        "cliName": "concepts list",
-        "method": "GET",
-        "path": "/v1/concepts",
-        "description": "Concept list joining CH `v_concept_meta` with Redis snapshot hash\n`stockpulse:concept_snapshots:latest`. Each item includes 6 live\nfields (pct_change / index_value / up/down_count / limit_up_count /\namount) refreshed every ~15s by stockpulse-rs collector.\n\nSource / status / index are computed per PLAN_CONCEPT_INDUSTRY_QUOTE\n§5.4 algorithm (chain-linked equal-weight returns, base = 1000).\n",
-        "summary": "List concepts with live snapshot (6 fields)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "status": {
-                    "type": "string",
-                    "enum": [
-                        "active",
-                        "pending_review",
-                        "deprecated"
-                    ],
-                    "default": "active",
-                    "description": "Concept status filter (active / pending_review / deprecated)."
-                },
-                "sort": {
-                    "type": "string",
-                    "enum": [
-                        "pct",
-                        "amount",
-                        "limit_up",
-                        "stock_count"
-                    ],
-                    "default": "pct",
-                    "description": "Sort field for the snapshot view: pct / amount / limit_up / stock_count."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 1000,
-                    "default": 500,
-                    "description": "Maximum number of items to return."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "concepts.minute-bars": {
-        "cliKey": "concepts.minute-bars",
-        "cliName": "concepts minute-bars",
-        "method": "GET",
-        "path": "/v1/concepts/{concept_id}/minute-bars",
-        "description": "Concept index minute-level OHLC (chain-linked equal-weight, base = 1000), max 7 days per request. See PLAN_CONCEPT_INDUSTRY_QUOTE §5.4.",
-        "summary": "Concept index minute bars (max 7 days)",
-        "positional": [
-            "concept_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "concept_id": {
-                    "type": "integer",
-                    "description": "Concept primary key (PG concepts.id)."
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "concept_id",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "concepts.news": {
-        "cliKey": "concepts.news",
-        "cliName": "concepts news",
-        "method": "GET",
-        "path": "/v1/concepts/{concept_id}/news",
-        "description": "Short-term implementation: ILIKE on news.title + content with the\nconcept name and full_name. Long-term: news AI tagging.\n",
-        "summary": "Related news matching concept name (ILIKE)",
-        "positional": [
-            "concept_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "news:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "concept_id": {
-                    "type": "integer",
-                    "description": "Concept primary key (PG concepts.id)."
-                },
-                "days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 365,
-                    "default": 30,
-                    "description": "Lookback window in days for news search."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 200,
-                    "default": 50,
-                    "description": "Maximum number of items to return."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "concept_id"
-            ]
-        }
-    },
-    "concepts.show": {
-        "cliKey": "concepts.show",
-        "cliName": "concepts show",
-        "method": "GET",
-        "path": "/v1/concepts/{concept_id}",
-        "description": "Detail view for one concept: meta (full_name / source / status / approved_at / first_listed_at) plus current member securities with their latest snapshots.",
-        "summary": "Concept detail (meta + member securities)",
-        "positional": [
-            "concept_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "concept_id": {
-                    "type": "integer",
-                    "description": "Concept primary key (PG concepts.id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "concept_id"
-            ]
-        }
-    },
-    "concepts.snapshot": {
-        "cliKey": "concepts.snapshot",
-        "cliName": "concepts snapshot",
-        "method": "GET",
-        "path": "/v1/concepts/snapshot",
-        "description": "Returns the full concept_snapshots:latest hash. Use ?codes= to filter.",
-        "summary": "Bulk Redis snapshot of all concepts",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "string",
-                    "description": "Comma-separated concept_id list (e.g. `1,2,3`); omit for all."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "concepts.views": {
-        "cliKey": "concepts.views",
-        "cliName": "concepts views",
-        "method": "GET",
-        "path": "/v1/concepts/{concept_id}/views",
-        "description": "JOIN concept_views × broker_views (ai_status=done) sorted by published_at desc.",
-        "summary": "Broker views associated with this concept",
-        "positional": [
-            "concept_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "views:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "concept_id": {
-                    "type": "integer",
-                    "description": "Concept primary key (PG concepts.id)."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 200,
-                    "default": 50,
-                    "description": "Maximum number of items to return."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "concept_id"
-            ]
-        }
-    },
-    "digest.get": {
-        "cliKey": "digest.get",
-        "cliName": "digest get",
-        "method": "GET",
-        "path": "/v1/digest/{code}",
-        "description": "Composite endpoint: in one HTTP call returns views (PRIMARY research),\nreal-time quote, valuation snapshot (PE/PB/PS/换手率/股息率/量比 等 14 字段),\nmarket sentiment context, and supplementary news.\nPartial-failure tolerant:\neach bucket is independently fetched and per-bucket failures surface\nin `meta.partial_failures[]` rather than poisoning the response. If\nevery sub-bucket fails the endpoint returns 502.\n\nBucket scopes are checked *per bucket* (not at gateway level): a\ntoken with only `views:read` gets the views bucket populated and the\nrest reported as `scope_insufficient` partial failures. This mirrors\nthe CLI fan-out contract exactly so `echopai digest` can either call\nthis endpoint (preferred, single round-trip) or fall back to local\nfan-out without behavior drift.\n\nSee `docs/PLAN_CLI_V2_AGENT_SURFACE.md` §3.3 (digest spec) and §11\nPhase 5.2 (server endpoint).\n",
-        "summary": "One-shot research digest for a single security (composite)",
-        "positional": [
-            "code"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "views_since_days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 90,
-                    "default": 7,
-                    "description": "Views lookback in days (1-90)."
-                },
-                "news_hours": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 168,
-                    "default": 24,
-                    "description": "News lookback in hours (1-168)."
-                },
-                "limit_per_bucket": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 50,
-                    "default": 10,
-                    "description": "Per-bucket item cap for views / news (1-50)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "financials.pit": {
-        "cliKey": "financials.pit",
-        "cliName": "financials pit",
-        "method": "GET",
-        "path": "/v1/financials/pit",
-        "description": "基于 TDX 财务数据的 Point-in-time 查询。给定 `code` 和 `date`，返回该\n`trade_date` 当时市场上可见的最新一期财务报告（`announce_date <= date`，\n无公告日时保守延迟 90 天）。专为回测、AI agent、量化策略防未来函数泄漏。\n\n返回字段包括：EPS（基本/扣非/稀释）、BPS、ROE、毛利率、营收/净利润/总资产/\n归母权益等核心 ~25 字段。\n",
-        "summary": "Point-in-time financial indicators for one A-share at a given date",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "financials:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Trade date in YYYY-MM-DD; defaults to today.",
-                    "example": "2024-11-01"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "financials.quote-snapshot": {
-        "cliKey": "financials.quote-snapshot",
-        "cliName": "financials quote-snapshot",
-        "method": "GET",
-        "path": "/v1/financials/quote-snapshot",
-        "description": "一站式估值快照 —— 一次返回 14 个字段，**全部基于 TDX 原始数据 + Sina 实时\n价自算，不依赖 Tushare**：\n\n- 估值: `pe` / `pe_ttm` / `pb` / `ps` / `ps_ttm`\n- 股本（万股）: `total_share` / `float_share` / `free_share`\n- 市值（万元）: `total_mv` / `circ_mv`\n- 流动性: `turnover_rate` / `turnover_rate_f`（%）/ `volume_ratio`（倍）\n- 分红: `dv_ratio` / `dv_ttm`（%）\n\n计算口径：\n- PE-TTM = 当前总市值 / 近 4 季度滚动净利润（PIT 表 `ni_parent_ttm`）\n- PE     = 当前总市值 / 上年报净利润（`ni_parent_last1y`）\n- PB     = 当前总市值 / 归母净资产（`equity_parent`，PIT 防穿越）\n- 换手率 = 当日累计成交量 / 流通股本 × 100\n- 量比   = 当日累计 / 近 5 日同时段累计平均（实时模式）\n          / 近 5 日全日成交量平均（指定历史日期模式）\n- 股息率 = Σ(去年 / 近12月内派息事件 派现/10) / 现价 × 100\n\n默认 `date` 留空 → 实时（Sina 5s 快照价 + 当日累计成交量）；\n给 `date=YYYY-MM-DD` 则按当日 close 取值（用于历史回测 / 校验）。\n\n财报数据走 `security_financial_indicators_pit` PIT 视图：保证 `visible_date`\n≤ trade_date，避免未来函数。\n\n准确性已对照 Tushare `daily_basic` 校验（见 `scripts/validation/validate_quote_snapshot_vs_tushare.py`）。\n",
-        "summary": "Real-time valuation / share / turnover snapshot for one A-share",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "financials:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Trade date YYYY-MM-DD; omit for real-time (Redis snapshot price).\n",
-                    "example": "2026-05-13"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "financials.reports": {
-        "cliKey": "financials.reports",
-        "cliName": "financials reports",
-        "method": "GET",
-        "path": "/v1/financials/reports",
-        "description": "返回该股票最近 N 期财务报告的核心指标（EPS/BPS/ROE/毛利率/营收/净利润/总\n资产/归母权益/经营现金流/总股本 等 ~25 字段）。可按 `kind` 过滤季报/半年报/\n年报。每期 `announce_date` 字段告知何时市场可见，建议结合回测时使用。\n\n**`kind` 口径说明**：\n\n- `Q1` / `H1` / `Q3` / `annual` —— 四个标准季度末快照（3-31 / 6-30 /\n  9-30 / 12-31），TDX 财务源数据全部落在这四个 report_date。\n- `preliminary` —— **当前数据源结构上不存在**。业绩预告 / 快报 是 indicators\n  行内的字段（`forecast_ni_lower` / `forecast_ni_upper` /\n  `express_ni_parent` / `express_revenue` 等），通过 `financials.series`\n  metric 参数访问，不是单独的 report_kind 行。`kind=preliminary` 会返\n  空列表 + meta.note。\n",
-        "summary": "Recent financial reports for one A-share security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "financials:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 100,
-                    "default": 12,
-                    "description": "Max periods to return (1-100, default 12)."
-                },
-                "kind": {
-                    "type": "string",
-                    "enum": [
-                        "Q1",
-                        "H1",
-                        "Q3",
-                        "annual",
-                        "preliminary"
-                    ],
-                    "description": "Filter by report kind."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "financials.series": {
-        "cliKey": "financials.series",
-        "cliName": "financials series",
-        "method": "GET",
-        "path": "/v1/financials/series",
-        "description": "返回某只股票某个财务指标的历史时间序列（按报告期排列）。`metric` 是\nindicators 表中的字段名（如 `roe_simple` / `revenue` / `ni_parent` /\n`debt_asset_ratio` / `gross_margin` / `eps_basic` 等共 150 个）。\n\n典型用法：画茅台 10 年 ROE 走势、对比 5 只白酒股 net_margin。\n",
-        "summary": "Time series of a single financial metric for one security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "financials:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                },
-                "metric": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 64,
-                    "description": "Indicator field name (e.g. roe_simple, revenue, ni_parent).",
-                    "example": "roe_simple"
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive earliest report_date."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive latest report_date."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 200,
-                    "default": 40,
-                    "description": "Max points (1-200, default 40)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code",
-                "metric"
-            ]
-        }
-    },
-    "index.daily-bars": {
-        "cliKey": "index.daily-bars",
-        "cliName": "index daily-bars",
-        "method": "GET",
-        "path": "/v1/index/bars/daily",
-        "description": "指数日线 OHLC。覆盖 v2 表中的指数（上证综指 `SSE:000001` / 深证成指\n`SZSE:399001` / 沪深300 `SSE:000300` / 北证50 `BSE:899050` / 中证系列 `CSI:000922` 等）。\n与 `/v1/bars/daily` 同语义，但 index 没有 `turnover_rate` / `paused` 等股票特有字段。\n",
-        "summary": "Daily OHLC bars for one A-share index",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "Canonical index code.",
-                    "example": "SSE:000001"
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive start date (YYYY-MM-DD).",
-                    "example": "2024-01-01"
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date.",
-                    "example": "2024-12-31"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "index.minute-bars": {
-        "cliKey": "index.minute-bars",
-        "cliName": "index minute-bars",
-        "method": "GET",
-        "path": "/v1/index/bars/minute",
-        "description": "指数 1min OHLC。日期范围 ≤ 7 天（与 `/v1/bars/minute-batch` 对齐）。\n返回 `bar_time` / `trade_date` / OHLC / volume / amount / pct_change。\n",
-        "summary": "Minute OHLC bars for one A-share index",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "Canonical index code.",
-                    "example": "SSE:000001"
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive start date (YYYY-MM-DD)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Inclusive end date. Range ≤ 7 calendar days."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "index.snapshot": {
-        "cliKey": "index.snapshot",
-        "cliName": "index snapshot",
-        "method": "GET",
-        "path": "/v1/index/snapshot",
-        "description": "Returns the latest real-time snapshot for the 172 indices that Sina\nexposes a quote for (SSE / SZSE / BSE — includes 北证50 `BSE:899050`\nand 专精特新 `899601.BJ`). Source is the Redis hash\n`stockpulse:index_snapshots:latest` which the Rust collector refreshes\nevery ~15 seconds during market hours; outside trading hours the last\nintraday snapshot is returned.\n\nUse `codes` to narrow to a subset (canonical format `SSE:000001` (exchange-prefix; legacy `000001.SH` is also accepted but discouraged)).\nOmit to receive all 172.\n\nNote: CSI-series indices (e.g. `CSI:000922`) are not available here —\nSina has no quote feed for them. Daily/minute history for those still\nlives behind `/api/internal/index/{daily-bars,minute-bars-range}`.\n\nRequires `quote:l1`, `quote:l2`, or `quote:delayed` scope.\n",
-        "summary": "Real-time snapshot of all Sina-OK A-share indices (172 indices)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "string",
-                    "description": "Comma-separated canonical index codes (e.g. `SSE:000001,SZSE:399001,BSE:899050`).\nOmit to return all 172.\n",
-                    "example": "SSE:000001,SZSE:399001,BSE:899050"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "industries.alerts": {
-        "cliKey": "industries.alerts",
-        "cliName": "industries alerts",
-        "method": "GET",
-        "path": "/v1/industries/alerts",
-        "description": "Currently active industry alerts (big_move / limit_up_cluster). Same rule set as concepts.",
-        "summary": "Currently active industry alerts",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "industries.daily-bars": {
-        "cliKey": "industries.daily-bars",
-        "cliName": "industries daily-bars",
-        "method": "GET",
-        "path": "/v1/industries/{key}/daily-bars",
-        "description": "Industry index daily OHLC (chain-linked equal-weight, base = 1000). Path key format `<sw_industry_code>:<sw_level>` (e.g. `401001:1`).",
-        "summary": "Industry index daily bars",
-        "positional": [
-            "key"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "bars:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "key": {
-                    "type": "string",
-                    "description": "Industry key in `<sw_industry_code>:<sw_level>` format (e.g. `401001:1`).",
-                    "example": "401001:1"
-                },
-                "from": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window start. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now - 24h)."
-                },
-                "to": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "Window end. For daily/minute bars: ISO date `YYYY-MM-DD`. For alerts history: Unix milliseconds (default = now)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "key",
-                "from",
-                "to"
-            ]
-        }
-    },
-    "industries.list": {
-        "cliKey": "industries.list",
-        "cliName": "industries list",
-        "method": "GET",
-        "path": "/v1/industries",
-        "description": "Industry index list joining CH `v_industry_meta` with Redis snapshot.\n申万一级 (level=1) ≈ 127 industries, 申万二级 (level=2) ≈ 348.\nChain-linked equal-weight algorithm identical to concepts (PLAN §5.4).\n",
-        "summary": "List industries (申万 L1/L2) with live snapshot",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "level": {
-                    "type": "integer",
-                    "enum": [
-                        1,
-                        2
-                    ],
-                    "default": 1,
-                    "description": "申万 industry level (1 or 2)."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 1000,
-                    "default": 500,
-                    "description": "Maximum number of items to return."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "industries.show": {
-        "cliKey": "industries.show",
-        "cliName": "industries show",
-        "method": "GET",
-        "path": "/v1/industries/{key}",
-        "description": "Path key format: `<sw_industry_code>:<sw_level>` (e.g. `401001:1`).",
-        "summary": "Industry detail (meta + today members)",
-        "positional": [
-            "key"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "key": {
-                    "type": "string",
-                    "description": "Industry key in `<sw_industry_code>:<sw_level>` format (e.g. `401001:1`).",
-                    "example": "401001:1"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "key"
-            ]
-        }
-    },
-    "industries.snapshot": {
-        "cliKey": "industries.snapshot",
-        "cliName": "industries snapshot",
-        "method": "GET",
-        "path": "/v1/industries/snapshot",
-        "description": "Bulk Redis snapshot for 申万 industries (level 1 ≈ 127, level 2 ≈ 348). Use `codes` to narrow. Mirrors `/v1/concepts/snapshot` shape.",
-        "summary": "Bulk Redis snapshot of all industries",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "string",
-                    "description": "Comma-separated `sw_code:level` (e.g. `401001:1,401002:1`); omit for all"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "limit-up.history": {
-        "cliKey": "limit-up.history",
-        "cliName": "limit-up history",
-        "method": "GET",
-        "path": "/v1/limit-up/history",
-        "description": "近 N 个交易日每日涨停数 + 最高连板 + 炸板数。涨停数 / 最高连板来源\n`market_limit_up_pool` (仅 status=limit_up)；炸板数来源\n`market_breadth_intraday`（all_a_ex_st 当日最新分钟行）。\n\n响应按 trade_date asc 排序（旧日期在前）。需要 `quote:*` scope。\n",
-        "summary": "A-share limit-up daily trend (last N days)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 250,
-                    "default": 30,
-                    "description": "回看天数（1-250，默认 30）。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "limit-up.pool": {
-        "cliKey": "limit-up.pool",
-        "cliName": "limit-up pool",
-        "method": "GET",
-        "path": "/v1/limit-up/pool",
-        "description": "当日（或指定 `trade_date`）涨停股池逐股明细：首/末次封板时间、最终涨幅、\n封单金额/封单量、炸板次数、连板数、N 日板内统计、一字板标记、当前 status\n(limit_up / broken)、板块分类。\n\n盘前回退规则（与所有行情类页面一致）：\n  - `< 9:00`：返回 max(trade_date) 的最新一日数据（昨日）\n  - `9:00-9:14`：集合竞价前空窗期，items=[] / trade_date=null\n  - `>= 9:15`：collector 已写入今日数据\n\n排序：连板数 desc → 板内板数 desc → 封单金额 desc。需要 `quote:*` scope。\n",
-        "summary": "A-share limit-up pool (per-stock detail) for a given trade date",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "trade_date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "ISO date YYYY-MM-DD；不传走 latest（含盘前回退）。"
-                },
-                "include": {
-                    "type": "string",
-                    "enum": [
-                        "active",
-                        "all"
-                    ],
-                    "default": "active",
-                    "description": "active（默认）= 排除 ST/退市；all = 全部。"
-                },
-                "include_broken": {
-                    "type": "boolean",
-                    "default": false,
-                    "description": "true 时连炸板（status=broken）也一起返回；默认只返回当前封板 status=limit_up。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "limit-up.summary": {
-        "cliKey": "limit-up.summary",
-        "cliName": "limit-up summary",
-        "method": "GET",
-        "path": "/v1/limit-up/summary",
-        "description": "涨停股池聚合统计：涨停数、炸板数、跌停数、最高连板高度、连板梯队\n`ladder: [{ height, count }, ...]`。\n\n炸板数 / 跌停数 与情绪页同源（`market_breadth_intraday` 当日最新分钟行）；\n连板梯队仅统计当前封板 status=limit_up 的个股。\n\n盘前回退规则与 `limit-up/pool` 一致。需要 `quote:*` scope。\n",
-        "summary": "A-share limit-up summary (counts + height ladder) for a given trade date",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "trade_date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "ISO date YYYY-MM-DD；不传走 latest。"
-                },
-                "include": {
-                    "type": "string",
-                    "enum": [
-                        "active",
-                        "all"
-                    ],
-                    "default": "active",
-                    "description": "active（默认 all_a_ex_st 口径）/ all（all_a 口径）。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "market.status": {
-        "cliKey": "market.status",
-        "cliName": "market status",
-        "method": "GET",
-        "path": "/v1/market/status",
-        "description": "Current A-share market session: pre-open / open / lunch / closed; current and next trading day; holiday flag. Requires `market:read` or any `quote:*` scope.",
-        "summary": "Current A-share market session state",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "market:read",
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "news.feed": {
-        "cliKey": "news.feed",
-        "cliName": "news feed",
-        "method": "GET",
-        "path": "/v1/news",
-        "description": "与 `/v1/news/list` 行为一致，旧客户端兼容用。",
-        "summary": "List recent news (alias of /v1/news/list)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "offset",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "news.get": {
-        "cliKey": "news.get",
-        "cliName": "news get",
-        "method": "GET",
-        "path": "/v1/news/{news_id}",
-        "description": "返回新闻完整内容：title、content snippet、tagged securities。（采集端字段 source / source_id / source_url 对外不暴露，admin 路径 /v1/admin/news/{id} 可见。）",
-        "summary": "Fetch a single news item by id",
-        "positional": [
-            "news_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "news_id": {
-                    "type": "string",
-                    "description": "News item id (returned by news.list / search items[].id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "news_id"
-            ]
-        }
-    },
-    "news.list": {
-        "cliKey": "news.list",
-        "cliName": "news list",
-        "method": "GET",
-        "path": "/v1/news/list",
-        "description": "List news mentioning a specific A-share security, ordered by published_at desc. Requires `news:read` scope.",
-        "summary": "List news mentioning a specific security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "news:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "security": {
-                    "type": "string",
-                    "description": "Any-market canonical code: A-share | HK (5-digit zero-padded) | US (uppercase ticker). For search/views/news endpoints.",
-                    "pattern": "^((SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$",
-                    "example": "HK:00700"
-                },
-                "since_hours": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 720,
-                    "default": 24,
-                    "description": "Lookback window in hours (max 720 = 30 days)."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 100,
-                    "default": 20,
-                    "description": "Max items per page."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "security"
-            ]
-        }
-    },
-    "news.search": {
-        "cliKey": "news.search",
-        "cliName": "news search",
-        "method": "GET",
-        "path": "/v1/news/search",
-        "description": "Full-text search recent news / market briefs. Returns title, published_at, snippet, tagged securities. (Internal collector identifiers — `source`/`source_id`/`source_url` — are NOT exposed publicly; admin tools see them via /v1/admin/*.) Requires `news:read` scope. Note: news fields are user-generated; meta.untrusted_text_fields lists fields that need sanitization before passing to an LLM.",
-        "summary": "Full-text search recent news",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "news:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "query": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 200,
-                    "description": "Free-text query (Chinese or English).",
-                    "example": "光伏龙头"
-                },
-                "since_hours": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 168,
-                    "default": 24,
-                    "description": "Lookback window in hours."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 100,
-                    "default": 20,
-                    "description": "Max items per page."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "query"
-            ]
-        }
-    },
-    "payment.plans": {
-        "cliKey": "payment.plans",
-        "cliName": "payment plans",
-        "method": "GET",
-        "path": "/v1/payment/plans",
-        "description": "返回订阅计划清单（plan_id + 价格 + 时长 + 描述）。",
-        "summary": "List subscription plans",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "quote": {
-        "cliKey": "quote",
-        "cliName": "quote",
-        "method": "GET",
-        "path": "/v1/quote/realtime",
-        "description": "Real-time quote for one or more A-share securities. Returns last price, volume, change %, bid/ask. Up to 200 codes per call. Requires `quote:l1`, `quote:l2`, or `quote:delayed` scope.",
-        "summary": "Real-time quote for one or more A-share securities",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "codes": {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                        "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                        "example": "SSE:600519"
-                    },
-                    "minItems": 1,
-                    "maxItems": 200,
-                    "description": "1-200 canonical codes; CSV-encoded on the wire.",
-                    "example": [
-                        "SSE:600519",
-                        "SZSE:000001"
-                    ]
-                },
-                "include_l2": {
-                    "type": "boolean",
-                    "default": false,
-                    "description": "Include L2 5-level order book (requires quote:l2 scope)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "codes"
-            ]
-        }
-    },
-    "quote.scan": {
-        "cliKey": "quote.scan",
-        "cliName": "quote scan",
-        "method": "GET",
-        "path": "/v1/quote/scan",
-        "description": "Dumps the entire Redis snapshot of A-share real-time quotes in a single\nround-trip. Use for \"全市场扫描\" / agent universe-of-interest discovery\nwhen you don't yet know which codes to query.\n\nFiltering:\n- `exchange=SSE|SZSE|BSE` narrows to one exchange (canonical_code prefix)\n- `app.allowed_securities` is ALWAYS applied; codes outside drop silently\n\nResponse size: ~3 MB unfiltered (~5800 items). CLI users should pair\nwith `--max-bytes` / `--fields` / `--query` from Phase 1.4.\n\n9:00–9:14 集合竞价时段返回空 items + `note` 字段说明。\n\nRequires `quote:l1`, `quote:l2`, or `quote:delayed` scope.\n",
-        "summary": "Full-market real-time quote scan (~5800 A-share securities)",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "quote:l1",
-            "quote:l2",
-            "quote:delayed"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "exchange": {
-                    "type": "string",
-                    "enum": [
-                        "SSE",
-                        "SZSE",
-                        "BSE",
-                        "sse",
-                        "szse",
-                        "bse"
-                    ],
-                    "description": "Filter by exchange: SSE / SZSE / BSE (case-insensitive). Omit for all."
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "search.semantic": {
-        "cliKey": "search.semantic",
-        "cliName": "search semantic",
-        "method": "GET",
-        "path": "/v1/search",
-        "description": "语义 + 模糊泛化搜索。结合 entity 精确匹配（公司代码/分析师）、向量召回（pgvector\n+ DashScope embedding）、trigram 模糊、ILIKE 精确四路召回，RRF 融合后用 reranker\n精排，叠时间衰减 + views 加权（views 主源优先）。\n\n- 搜\"锂电池\"会带出新能源产业链（正极/负极/碳酸锂/宁德时代…）\n- 搜\"芯片\"会带出存储芯片/洁净室/晶圆代工…\n- mode=exact 兼容老 ILIKE 行为，仅在精确关键词命中时返回。\n",
-        "summary": "Hybrid semantic search across news + analyst views",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "news:read",
-            "views:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "q": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 200,
-                    "description": "Free-text query (Chinese or English).",
-                    "example": "锂电池"
-                },
-                "type": {
-                    "type": "string",
-                    "enum": [
-                        "news",
-                        "views",
-                        "all"
-                    ],
-                    "default": "all",
-                    "description": "Search scope: news | views | all"
-                },
-                "mode": {
-                    "type": "string",
-                    "enum": [
-                        "hybrid",
-                        "exact"
-                    ],
-                    "default": "hybrid",
-                    "description": "hybrid = 语义 + 精确融合 + rerank；exact = 仅 ILIKE 兼容老逻辑"
-                },
-                "hours": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 720,
-                    "description": "Lookback window in hours."
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 50,
-                    "default": 20,
-                    "description": "Max items returned."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "q"
-            ]
-        }
-    },
-    "securities.industry": {
-        "cliKey": "securities.industry",
-        "cliName": "securities industry",
-        "method": "GET",
-        "path": "/v1/securities/industry",
-        "description": "返回该股票的 TDX 自定义行业代码（T1001 食品饮料等）与申万行业三级代码\nL1/L2/L3（X5001 食品饮料 / X500102 白酒 等）。\n\n用法：\n- 股票详情页\"申万行业：白酒 / 食品饮料\"标签\n- 筛选器交叉过滤：行业 + ROE/营收增长率\n- AI agent `find_peers(code)` 用申万二级行业找同业\n",
-        "summary": "TDX + 申万 industry classification for one A-share security",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "code": {
-                    "type": "string",
-                    "description": "A-share canonical code (SSE/SZSE/BSE only). For quote/chart/bars/financials endpoints.",
-                    "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$",
-                    "example": "SSE:600519"
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "code"
-            ]
-        }
-    },
-    "semantic.find": {
-        "cliKey": "semantic.find",
-        "cliName": "semantic find",
-        "method": "GET",
-        "path": "/v1/securities/search",
-        "description": "Find A-share securities matching a name (Chinese), code (e.g. 600519), or pinyin initials (e.g. gzmt). Use this when an agent has a description and needs canonical codes.",
-        "summary": "Find A-share securities by name / code / pinyin",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "query": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 20,
-                    "description": "Search query: Chinese name, A-share code, or pinyin initials.",
-                    "example": "贵州茅台"
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 30,
-                    "default": 10,
-                    "description": "Max matches."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "query"
-            ]
-        }
-    },
-    "sentiment.breadth": {
-        "cliKey": "sentiment.breadth",
-        "cliName": "sentiment breadth",
-        "method": "GET",
-        "path": "/v1/sentiment/breadth",
-        "description": "Intraday breadth time series for one trading day.\n`trade_date` 缺省 → 今日（盘前 9:00 前返回空 items）；显式传 YYYY-MM-DD 可\n拉历史任意交易日（来源 ClickHouse `market_breadth_intraday`，剔除 13:00\n稀疏分钟，单日最多 241 行）。Requires `sentiment:read` scope.\n",
-        "summary": "Intraday breadth time series",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "sentiment:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "scope": {
-                    "type": "string",
-                    "enum": [
-                        "all_a",
-                        "all_a_ex_st",
-                        "main_board",
-                        "star_market",
-                        "chinext",
-                        "bse"
-                    ],
-                    "default": "all_a_ex_st",
-                    "description": "Universe filter."
-                },
-                "trade_date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "ISO date YYYY-MM-DD；不传走今日（盘前 9:00 前返空）。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "sentiment.overview": {
-        "cliKey": "sentiment.overview",
-        "cliName": "sentiment overview",
-        "method": "GET",
-        "path": "/v1/sentiment/overview",
-        "description": "Aggregate sentiment snapshot for one trading day's latest minute:\nlimit-up/down counts, breadth, divergence index, MA / 52w breadth.\n`trade_date` 缺省 → 今日（Redis 实时，盘前 9:00 前返空结构）；显式传\nYYYY-MM-DD 拉历史任意日（最后一分钟聚合行，来源 ClickHouse\n`market_breadth_intraday`）。Requires `sentiment:read` scope.\n",
-        "summary": "Aggregate market sentiment indicators",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "sentiment:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "scope": {
-                    "type": "string",
-                    "enum": [
-                        "all_a",
-                        "all_a_ex_st",
-                        "main_board",
-                        "star_market",
-                        "chinext",
-                        "bse"
-                    ],
-                    "default": "all_a_ex_st",
-                    "description": "Universe filter.",
-                    "example": "main_board"
-                },
-                "trade_date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "ISO date YYYY-MM-DD；不传走今日（实时）。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "sentiment.pct-distribution": {
-        "cliKey": "sentiment.pct-distribution",
-        "cliName": "sentiment pct-distribution",
-        "method": "GET",
-        "path": "/v1/sentiment/pct-distribution",
-        "description": "返回 A 股全市场涨跌幅分桶（≤-10% / -9% / ... / +10% / 涨停）的家数分布，用于市场宽度可视化。",
-        "summary": "Distribution of intraday percent change across the universe",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "sentiment:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "sentiment.turnover": {
-        "cliKey": "sentiment.turnover",
-        "cliName": "sentiment turnover",
-        "method": "GET",
-        "path": "/v1/sentiment/turnover",
-        "description": "Intraday turnover time series across one or more trading days.\n`trade_date` 缺省 → 今日（盘前 9:00 前返空 items）；显式 YYYY-MM-DD 拉\n历史任意交易日的当日 + 之前 `days-1` 天。Response 含 `current_turnover`\n/ `predicted_total` / `delta_vs_yesterday` headline 字段。Requires\n`sentiment:read` scope.\n",
-        "summary": "Intraday turnover time series",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "sentiment:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "scope": {
-                    "type": "string",
-                    "enum": [
-                        "all_a",
-                        "all_a_ex_st",
-                        "main_board",
-                        "star_market",
-                        "chinext",
-                        "bse"
-                    ],
-                    "default": "all_a_ex_st",
-                    "description": "Universe filter."
-                },
-                "trade_date": {
-                    "type": "string",
-                    "format": "date",
-                    "description": "ISO date YYYY-MM-DD；不传走今日。"
-                },
-                "days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 5,
-                    "default": 1,
-                    "description": "取该 trade_date 当日 + 之前 days-1 天的时序，用于同分钟同比 (1-5)。"
-                }
-            },
-            "additionalProperties": false
-        }
-    },
-    "squawk.audio": {
-        "cliKey": "squawk.audio",
-        "cliName": "squawk audio",
-        "method": "GET",
-        "path": "/v1/squawk/{item_id}/audio",
-        "description": "返回 squawk 项的 TTS 音频（MP3）。直接 stream，可作为 `<audio>` src 用。",
-        "summary": "Stream squawk TTS audio",
-        "positional": [
-            "item_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "item_id": {
-                    "type": "string",
-                    "description": "Squawk item id (returned by squawk.recent items[].id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "item_id"
-            ]
-        }
-    },
-    "squawk.waveform": {
-        "cliKey": "squawk.waveform",
-        "cliName": "squawk waveform",
-        "method": "GET",
-        "path": "/v1/squawk/{item_id}/waveform",
-        "description": "返回 squawk 音频的预计算波形 peak 数据，用于客户端波形可视化。",
-        "summary": "Waveform peaks for squawk audio",
-        "positional": [
-            "item_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "item_id": {
-                    "type": "string",
-                    "description": "Squawk item id (returned by squawk.recent items[].id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "item_id"
-            ]
-        }
-    },
-    "stocks.hot": {
-        "cliKey": "stocks.hot",
-        "cliName": "stocks hot",
-        "method": "GET",
-        "path": "/v1/stocks/hot",
-        "description": "今日最热股票榜（来源 East-Money），按搜索 / 关注 / 评论综合分排序。",
-        "summary": "Today's hot-stock leaderboard",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "stocks.social-hot": {
-        "cliKey": "stocks.social-hot",
-        "cliName": "stocks social-hot",
-        "method": "GET",
-        "path": "/v1/stocks/social-hot",
-        "description": "跨平台（微博 / 雪球 / Twitter）社交媒体提及聚合榜，按提及量 / 情感打分。",
-        "summary": "Cross-platform social-hot stocks",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "views.feed": {
-        "cliKey": "views.feed",
-        "cliName": "views feed",
-        "method": "GET",
-        "path": "/v1/views",
-        "description": "分析师观点 / 卖方研报 / 长文本观点流。可按机构 / 分析师 / 证券 / hours 过滤。需要 `views:read` scope。",
-        "summary": "List analyst views",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "offset",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-        }
-    },
-    "views.get": {
-        "cliKey": "views.get",
-        "cliName": "views get",
-        "method": "GET",
-        "path": "/v1/views/{view_id}",
-        "description": "返回单条 view 完整内容、附件图片、tagged securities、AI 摘要。",
-        "summary": "Fetch a single analyst view",
-        "positional": [
-            "view_id"
-        ],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": false,
-        "idempotencyRequired": false,
-        "scopesAny": [],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "view_id": {
-                    "type": "string",
-                    "description": "Analyst-view id (returned by views.recent / list items[].id)."
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "view_id"
-            ]
-        }
-    },
-    "views.recent": {
-        "cliKey": "views.recent",
-        "cliName": "views recent",
-        "method": "GET",
-        "path": "/v1/views/recent",
-        "description": "List recent broker / analyst views (research notes, price targets, ratings). Filter by analyst, institution, or a specific security. Requires `views:read` scope.",
-        "summary": "Recent broker / analyst views",
-        "positional": [],
-        "outputDefault": "json",
-        "pagination": "none",
-        "stream": false,
-        "billable": true,
-        "idempotencyRequired": false,
-        "scopesAny": [
-            "views:read"
-        ],
-        "sideEffect": "read",
-        "dryRunSupported": false,
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "analyst": {
-                    "type": "string",
-                    "description": "Analyst name (Chinese), exact or fuzzy."
-                },
-                "institution": {
-                    "type": "string",
-                    "description": "Broker / institution Chinese name."
-                },
-                "security": {
-                    "type": "string",
-                    "description": "Any-market canonical code: A-share | HK (5-digit zero-padded) | US (uppercase ticker). For search/views/news endpoints.",
-                    "pattern": "^((SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$",
-                    "example": "HK:00700"
-                },
-                "since_days": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 90,
-                    "default": 7,
-                    "description": "Lookback window in days. (Translated to hours upstream.)"
-                },
-                "limit": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 100,
-                    "default": 30,
-                    "description": "Max items per page."
-                }
-            },
-            "additionalProperties": false
-        }
-    }
-};
-export function getOperation(key) {
-    return OPERATIONS[key];
-}
-export function listOperations() {
-    return Object.values(OPERATIONS);
-}