antitone 1.1.0

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,aAAa,GACb,sBAAsB,GACtB,eAAe,GACf,cAAc,GACd,aAAa,GACb,WAAW,GACX,SAAS,GACT,SAAS,GACT,cAAc,GACd,cAAc,GACd,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO5D;AAUD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,SAAS,CAS5G;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMjE;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,OAAO;IAO1D,IAAI,IAAI,IAAI,SAAS,CAEpB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,aAAa,CA8IrE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,kBAAuB,GAAG,aAAa,CAsC3F;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,kBAAuB,GAAG,aAAa,CAE9F"}

package/dist/errors.js

@@ -0,0 +1,224 @@
+/**
+ * 错误规范化：把 HTTP 状态码 / 网络异常翻译成 agent 可读的中文语义，
+ * 并保留 402 / 403 / 429 的结构化字段（need_credits / required_scope / Retry-After）。
+ *
+ * 依据：docs/api-platform-master-plan.md §7.4 错误语义、§7.5 计费回执。
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function toInteger(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === "string" && value.trim() !== "") {
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return Math.trunc(n);
+    }
+    return undefined;
+}
+function firstString(source, keys) {
+    for (const key of keys) {
+        const value = source[key];
+        if (typeof value === "string" && value.trim() !== "")
+            return value.trim();
+    }
+    return undefined;
+}
+/** 解析 Retry-After：支持秒数或 HTTP-date。 */
+export function parseRetryAfter(raw, now = Date.now()) {
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return undefined;
+    const seconds = Number(trimmed);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.round(seconds * 1000);
+    const date = Date.parse(trimmed);
+    if (Number.isFinite(date))
+        return Math.max(0, date - now);
+    return undefined;
+}
+export function humanizeRetryAfter(ms) {
+    if (ms === undefined)
+        return "稍后";
+    const s = Math.ceil(ms / 1000);
+    if (s < 60)
+        return `${s} 秒后`;
+    const m = Math.ceil(s / 60);
+    return `${m} 分钟后`;
+}
+export class AntitoneError extends Error {
+    normalized;
+    billing;
+    constructor(normalized, billing) {
+        super(normalized.message);
+        this.name = "AntitoneError";
+        this.normalized = normalized;
+        if (billing)
+            this.billing = billing;
+    }
+    get kind() {
+        return this.normalized.kind;
+    }
+    get retryable() {
+        return this.normalized.retryable;
+    }
+}
+/** 把一次失败的 HTTP 响应规范化。体里若带 error/limit/required_scope 等字段则直通。 */
+export function fromResponse(ctx) {
+    const { status } = ctx;
+    const body = isRecord(ctx.body) ? ctx.body : {};
+    const code = firstString(body, ["error", "code", "detail_code"]);
+    const detailMessage = firstString(body, ["message", "detail", "msg"]);
+    const balance = toInteger(body["balance"]);
+    const needCredits = toInteger(body["need_credits"]);
+    const topupUrl = firstString(body, ["topup_url", "topup_hint"]);
+    const requiredScope = firstString(body, ["required_scope", "scope"]);
+    const retryAfterMs = parseRetryAfter(ctx.retryAfterHeader);
+    if (status === 401) {
+        const paused = code === "key_paused" || typeof body["until"] === "string";
+        const reason = firstString(body, ["reason"]);
+        const until = firstString(body, ["until"]);
+        return new AntitoneError({
+            kind: "invalid_key",
+            status,
+            message: paused
+                ? `API Key 已被暂停${reason ? `（原因：${reason}）` : ""}${until ? `，恢复时间 ${until}` : ""}。`
+                : "API Key 无效或已吊销",
+            hint: paused
+                ? "登录个人中心 → API Keys 查看该 Key 状态；被暂停的 Key 可手动恢复或改用其他 Key。"
+                : "检查 ANTITONE_API_KEY 是否为完整值 nhk_xxx.yyy（含 . 后的 secret，创建时只显示一次），以及 Key 是否已被吊销。",
+            retryable: false,
+            ...(balance !== undefined ? { balance } : {}),
+            ...(detailMessage ? { detail: detailMessage } : {}),
+        }, ctx.billing);
+    }
+    if (status === 402) {
+        const need = needCredits ?? 0;
+        const have = balance ?? 0;
+        return new AntitoneError({
+            kind: "insufficient_credits",
+            status,
+            message: `余额不足：本次调用至少需要 ${need} 积分，当前余额 ${have} 积分。`,
+            hint: "到个人中心充值（1 积分 = ¥0.005）；每日有 100 积分免费额度，北京时间 0 点重置。可先用免费端点 get_usage 查看余额与今日消耗。",
+            retryable: false,
+            ...(needCredits !== undefined ? { need_credits: needCredits } : {}),
+            ...(balance !== undefined ? { balance } : {}),
+            ...(topupUrl ? { topup_url: topupUrl } : {}),
+        }, ctx.billing);
+    }
+    if (status === 403) {
+        return new AntitoneError({
+            kind: "missing_scope",
+            status,
+            message: `缺少 scope / 权益：${requiredScope ?? code ?? "服务端未说明"}`,
+            hint: requiredScope
+                ? `在个人中心编辑该 API Key，勾选 ${requiredScope} 作用域后重试（修改即时生效）。`
+                : "在个人中心编辑该 API Key 的作用域；若确认已勾选，请检查 Key 是否被降权。",
+            retryable: false,
+            ...(requiredScope ? { required_scope: requiredScope } : {}),
+            ...(topupUrl ? { topup_url: topupUrl } : {}),
+        }, ctx.billing);
+    }
+    if (status === 429) {
+        const limit = firstString(body, ["limit"]);
+        const resetAt = firstString(body, ["reset_at"]);
+        const wait = retryAfterMs !== undefined ? humanizeRetryAfter(retryAfterMs) : "稍后";
+        return new AntitoneError({
+            kind: "rate_limited",
+            status,
+            message: `速率或配额超限${limit ? `（${limit === "daily" ? "日配额" : "每分钟速率"}）` : ""}，请 ${wait}重试。`,
+            hint: [
+                limit === "daily"
+                    ? "日配额按北京时间 0 点重置；也可用更少的调用次数完成同样的事（合并批量参数）。"
+                    : "降低并发/频率，或把多次小请求合并成一次批量请求（如 get_quotes 一次传多只）。",
+                resetAt ? `服务端建议的重置时间：${resetAt}` : "",
+            ]
+                .filter(Boolean)
+                .join(" "),
+            retryable: true,
+            ...(retryAfterMs !== undefined ? { retry_after_ms: retryAfterMs } : {}),
+            ...(retryAfterMs !== undefined ? { retry_after_s: Math.ceil(retryAfterMs / 1000) } : {}),
+        }, ctx.billing);
+    }
+    if (status === 404) {
+        return new AntitoneError({
+            kind: "not_found",
+            status,
+            message: `资源不存在（HTTP 404）${detailMessage ? `：${detailMessage}` : "，请检查 ID / 代码是否拼写正确"}`,
+            hint: "新闻用 search_news 拿到 public_id；题材/板块代码先调 list_themes / list_sectors 取；股票代码用 6 位数字（如 600519）。",
+            retryable: false,
+        }, ctx.billing);
+    }
+    if (status >= 400 && status < 500) {
+        return new AntitoneError({
+            kind: "bad_request",
+            status,
+            message: `请求被服务端拒绝（HTTP ${status}）${detailMessage ? `：${detailMessage}` : ""}`,
+            hint: "检查参数取值范围（limit / days / symbols 数量）与参数名拼写后重试。",
+            retryable: false,
+            ...(detailMessage ? { detail: detailMessage } : {}),
+        }, ctx.billing);
+    }
+    if (status >= 500) {
+        return new AntitoneError({
+            kind: "server_error",
+            status,
+            message: `Antitone 服务端错误（HTTP ${status}）${detailMessage ? `：${detailMessage}` : ""}`,
+            hint: "这是服务端问题，可原样重试 1–2 次；持续失败请在个人中心查看状态页或联系支持。",
+            retryable: true,
+        }, ctx.billing);
+    }
+    return new AntitoneError({
+        kind: "unknown",
+        status,
+        message: `请求失败（HTTP ${status}）${detailMessage ? `：${detailMessage}` : ""}`,
+        retryable: false,
+    }, ctx.billing);
+}
+/** 把 fetch 抛出的异常（超时 / DNS / 连接重置 / 用户取消）规范化。 */
+export function normalizeThrown(error, ctx = {}) {
+    if (error instanceof AntitoneError)
+        return error;
+    const name = error instanceof Error ? error.name : "";
+    const rawMessage = error instanceof Error ? error.message : String(error);
+    if (ctx.signalAborted && !ctx.timedOut) {
+        return new AntitoneError({
+            kind: "cancelled",
+            message: "请求已被取消（客户端中断）。",
+            hint: "重试即可；若频繁发生请检查 MCP 客户端的超时设置。",
+            retryable: true,
+        });
+    }
+    if (ctx.timedOut || name === "AbortError" || name === "TimeoutError") {
+        return new AntitoneError({
+            kind: "timeout",
+            message: `请求超时（${ctx.timeoutMs ?? "?"} ms 未收到响应）。`,
+            hint: "调大环境变量 ANTITONE_TIMEOUT_MS（如 60000），或收窄参数（更小的 limit / days、更短的时间窗）后重试。",
+            retryable: true,
+        });
+    }
+    if (error instanceof TypeError || /fetch failed|ENOTFOUND|ECONNREFUSED|ECONNRESET|EAI_AGAIN|socket hang up|network/i.test(rawMessage)) {
+        return new AntitoneError({
+            kind: "network",
+            message: `网络错误：无法连接 Antitone API${ctx.url ? `（${ctx.url}）` : ""}。`,
+            hint: "检查本机网络/代理/DNS，以及 ANTITONE_BASE_URL 是否正确（默认 https://api.desicterminal.com:8443，端口 8443 不能省）。原始错误：" + rawMessage,
+            retryable: true,
+            detail: rawMessage,
+        });
+    }
+    return new AntitoneError({
+        kind: "unknown",
+        message: `未预期的错误：${rawMessage}`,
+        hint: "可重试一次；持续失败请带上 X-Request-Id 联系支持。",
+        retryable: true,
+        detail: rawMessage,
+    });
+}
+/** 统一出口：把任意异常转成 AntitoneError（工具层绝不让异常冒泡打断 MCP 连接）。 */
+export function normalizeAnyThrown(error, ctx = {}) {
+    return normalizeThrown(error, ctx);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * antitone-mcp 主入口 = CLI（2026-09-17 去 MCP）。
+ *
+ * 产品决策：MCP 协议适配层已移除，全面转向「CLI + Skill」——
+ * 所有主流 Agent（DSH / Claude Code / Codex / Cursor / Kimi / Trae / Gemini CLI …）
+ * 都有 shell，且 Skill 的祈使式触发远好于 MCP 的被动能力清单。
+ *
+ * 用法：antitone-mcp <命令>，例如
+ *   antitone-mcp news --q "半导体 利空" --limit 10
+ *   antitone-mcp skill --install
+ *   antitone-mcp tools
+ */
+export { AntitoneClient } from "./client.js";
+export { loadConfig, describeConfig } from "./config.js";
+export { TOOL_NAMES, TOOL_SCOPES } from "./tools/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * antitone-mcp 主入口 = CLI（2026-09-17 去 MCP）。
+ *
+ * 产品决策：MCP 协议适配层已移除，全面转向「CLI + Skill」——
+ * 所有主流 Agent（DSH / Claude Code / Codex / Cursor / Kimi / Trae / Gemini CLI …）
+ * 都有 shell，且 Skill 的祈使式触发远好于 MCP 的被动能力清单。
+ *
+ * 用法：antitone-mcp <命令>，例如
+ *   antitone-mcp news --q "半导体 利空" --limit 10
+ *   antitone-mcp skill --install
+ *   antitone-mcp tools
+ */
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+export { AntitoneClient } from "./client.js";
+export { loadConfig, describeConfig } from "./config.js";
+export { TOOL_NAMES, TOOL_SCOPES } from "./tools/index.js";
+const invokedDirectly = (() => {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        // npx / npm 的 bin 是 node_modules/.bin 下的符号链接，必须先 realpath 再与 import.meta.url 比对，
+        // 否则 `npx -y antitone-mcp` 会静默什么都不做。
+        return import.meta.url === pathToFileURL(realpathSync(entry)).href;
+    }
+    catch {
+        return true;
+    }
+})();
+if (invokedDirectly) {
+    const { runCli } = await import("./cli.js");
+    process.exitCode = await runCli(process.argv.slice(2));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,iFAAiF;QACjF,qCAAqC;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,IAAI,eAAe,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 输出规范（文档 §9 要求，MCP 最容易翻车的地方）：
+ *   1. 单次返回序列化后 ≤ 32 KB，超出则截断并标 `truncated: true` + 给出收窄参数提示；
+ *   2. 每条结果附 `as_of`（数据时刻）与 `stale`（是否过期）布尔；
+ *   3. 列表默认 limit=20（在工具层实现）；
+ *   4. `_billing` 明细透出为 `billing: {credits, balance, ...}`（body 与响应头合并）；
+ *   5. 错误一律 isError: true 返回，绝不抛异常打断 MCP 连接。
+ */
+/**
+ * 工具调用结果的统一形状（本地定义，2026-09-17 起不再依赖 MCP SDK）。
+ * 与 MCP 的 CallToolResult 结构兼容：content 为块数组，isError 标记失败。
+ */
+export interface ContentBlock {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+export interface CallToolResult {
+    content: ContentBlock[];
+    isError?: boolean;
+    structuredContent?: unknown;
+    [key: string]: unknown;
+}
+import type { Billing } from "./client.js";
+import { AntitoneError } from "./errors.js";
+export interface SuccessInput {
+    tool: string;
+    data: unknown;
+    endpoints: string[];
+    asOf: string;
+    asOfSource: string;
+    stale: boolean;
+    staleAfterMs: number;
+    billing?: Billing;
+    requestId?: string;
+    httpStatus?: number;
+    durationMs?: number;
+    /** 列表条数（截断后实际返回的条数）。 */
+    count?: number;
+    /** 截断时给 LLM 的收窄建议。 */
+    narrowHints?: string[];
+    maxBytes?: number;
+    meta?: Record<string, unknown>;
+}
+export interface DropInfo {
+    path: string;
+    kept: number;
+    total: number;
+    reason: string;
+}
+export interface FitResult {
+    text: string;
+    truncated: boolean;
+    originalBytes: number;
+    finalBytes: number;
+    dropped: DropInfo[];
+}
+export declare function byteLength(text: string): number;
+/**
+ * 把信封压进字节预算：先缩数组 → 再截超长字符串 → 最后退化为预览对象。
+ * 返回的 text 一定是合法 JSON，且一定 ≤ budget。
+ */
+export declare function fitToBudget(envelope: Record<string, unknown>, budget: number, narrowHints: string[]): FitResult;
+export declare function buildSuccessResult(input: SuccessInput): CallToolResult;
+export interface ErrorInput {
+    tool: string;
+    error: AntitoneError;
+    requestId?: string;
+    endpoints?: string[];
+    durationMs?: number;
+}
+/** 失败也走正常 content 返回，仅把 isError 置 true —— 这样 MCP 连接不会断。 */
+export declare function buildErrorResult(input: ErrorInput): CallToolResult;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AA4ED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CA6D/G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CA0FtE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoCD,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAOlE"}

package/dist/output.js

@@ -0,0 +1,283 @@
+/**
+ * 输出规范（文档 §9 要求，MCP 最容易翻车的地方）：
+ *   1. 单次返回序列化后 ≤ 32 KB，超出则截断并标 `truncated: true` + 给出收窄参数提示；
+ *   2. 每条结果附 `as_of`（数据时刻）与 `stale`（是否过期）布尔；
+ *   3. 列表默认 limit=20（在工具层实现）；
+ *   4. `_billing` 明细透出为 `billing: {credits, balance, ...}`（body 与响应头合并）；
+ *   5. 错误一律 isError: true 返回，绝不抛异常打断 MCP 连接。
+ */
+import { MAX_RESULT_BYTES } from "./config.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function byteLength(text) {
+    return Buffer.byteLength(text, "utf8");
+}
+function serialize(value) {
+    try {
+        const json = JSON.stringify(value, null, 2);
+        return json === undefined ? "null" : json;
+    }
+    catch {
+        return JSON.stringify({ ok: false, note: "结果无法序列化为 JSON（可能包含循环引用）" }, null, 2);
+    }
+}
+/** 只收集「不在其他数组内部」的数组（外层数组一缩小，内层自然跟着缩）。 */
+function collectTopLevelArrays(node, path, out, insideArray, depth = 0) {
+    if (depth > 10 || node === null || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        if (!insideArray && node.length > 0) {
+            const size = byteLength(JSON.stringify(node) ?? "");
+            if (size >= 256)
+                out.push({ path, arr: node, size });
+        }
+        for (const child of node)
+            collectTopLevelArrays(child, path, out, true, depth + 1);
+        return;
+    }
+    for (const [key, value] of Object.entries(node)) {
+        collectTopLevelArrays(value, path ? `${path}.${key}` : key, out, insideArray, depth + 1);
+    }
+}
+/** 逐级缩小的候选保留条数（从大到小）。 */
+function keepSteps(length) {
+    const steps = new Set();
+    for (const factor of [0.75, 0.5, 0.35, 0.25, 0.15]) {
+        const value = Math.max(1, Math.floor(length * factor));
+        if (value < length)
+            steps.add(value);
+    }
+    for (const fixed of [200, 100, 50, 40, 20, 10, 5, 3, 2, 1, 0]) {
+        if (fixed < length)
+            steps.add(fixed);
+    }
+    return [...steps].sort((a, b) => b - a);
+}
+const STRING_LIMIT = 2048;
+function truncateLongStrings(node, path, dropped, depth = 0) {
+    if (depth > 12 || node === null || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        node.forEach((child, index) => truncateLongStrings(child, `${path}[${index}]`, dropped, depth + 1));
+        return;
+    }
+    const record = node;
+    for (const [key, value] of Object.entries(record)) {
+        const childPath = path ? `${path}.${key}` : key;
+        if (typeof value === "string" && value.length > STRING_LIMIT) {
+            record[key] = `${value.slice(0, STRING_LIMIT / 2)}…（超长字段已截断，原长度 ${value.length} 字符）`;
+            dropped.push({ path: childPath, kept: STRING_LIMIT / 2, total: value.length, reason: "long_string_truncated" });
+            continue;
+        }
+        truncateLongStrings(value, childPath, dropped, depth + 1);
+    }
+}
+function buildTruncationHint(originalBytes, finalBytes, budget, hints) {
+    const parts = [
+        `结果超过单次 ${budget} B 上限已自动截断（原始 ${originalBytes} B → 实际 ${finalBytes} B）。`,
+    ];
+    if (hints.length > 0) {
+        parts.push(`收窄建议：${hints.map((hint, index) => `${index + 1}) ${hint}`).join("；")}。`);
+    }
+    return parts.join(" ");
+}
+/**
+ * 把信封压进字节预算：先缩数组 → 再截超长字符串 → 最后退化为预览对象。
+ * 返回的 text 一定是合法 JSON，且一定 ≤ budget。
+ */
+export function fitToBudget(envelope, budget, narrowHints) {
+    let text = serialize(envelope);
+    let bytes = byteLength(text);
+    if (bytes <= budget) {
+        return { text, truncated: false, originalBytes: bytes, finalBytes: bytes, dropped: [] };
+    }
+    const originalBytes = bytes;
+    const dropped = [];
+    const targets = [];
+    collectTopLevelArrays(envelope["data"], "data", targets, false);
+    targets.sort((a, b) => b.size - a.size);
+    for (const target of targets) {
+        if (byteLength(serialize(envelope)) <= budget)
+            break;
+        const total = target.arr.length;
+        if (total === 0)
+            continue;
+        let kept = total;
+        for (const candidate of keepSteps(total)) {
+            target.arr.length = candidate;
+            kept = candidate;
+            if (byteLength(serialize(envelope)) <= budget)
+                break;
+        }
+        dropped.push({ path: target.path, kept, total, reason: "list_trimmed" });
+    }
+    if (byteLength(serialize(envelope)) > budget) {
+        truncateLongStrings(envelope["data"], "data", dropped);
+    }
+    if (byteLength(serialize(envelope)) > budget) {
+        const previewSource = serialize(envelope["data"]);
+        let preview = previewSource.slice(0, 4000);
+        envelope["data"] = {
+            _truncated_preview: true,
+            note: "原始结果过大，已截断为预览；请用更窄的参数重新调用。",
+            original_bytes: byteLength(previewSource),
+            preview,
+        };
+        for (const limit of [2000, 800, 200, 0]) {
+            if (byteLength(serialize(envelope)) <= budget)
+                break;
+            preview = previewSource.slice(0, limit);
+            envelope["data"] = {
+                _truncated_preview: true,
+                note: "原始结果过大，已截断为预览；请用更窄的参数重新调用。",
+                original_bytes: byteLength(previewSource),
+                preview,
+            };
+        }
+    }
+    text = serialize(envelope);
+    bytes = byteLength(text);
+    // 兜底：极端情况下（巨大的 meta）直接把 preview 清空为骨架。
+    if (bytes > budget) {
+        envelope["data"] = { _truncated: true, note: "结果过大且无法安全裁剪，请收窄参数后重试。" };
+        text = serialize(envelope);
+        bytes = byteLength(text);
+    }
+    return { text, truncated: true, originalBytes, finalBytes: bytes, dropped };
+}
+export function buildSuccessResult(input) {
+    const budget = input.maxBytes ?? MAX_RESULT_BYTES;
+    const hints = input.narrowHints ?? [];
+    const meta = {
+        endpoints: input.endpoints,
+        data_as_of_source: input.asOfSource,
+        stale_after_ms: input.staleAfterMs,
+        ...(input.requestId ? { request_id: input.requestId } : {}),
+        ...(input.httpStatus !== undefined ? { http_status: input.httpStatus } : {}),
+        ...(input.durationMs !== undefined ? { duration_ms: input.durationMs } : {}),
+        ...(input.count !== undefined ? { count: input.count } : {}),
+        ...(input.meta ?? {}),
+    };
+    const makeEnvelope = (truncation) => ({
+        ok: true,
+        tool: input.tool,
+        as_of: input.asOf,
+        stale: input.stale,
+        truncated: truncation !== undefined,
+        ...(input.billing ? { billing: input.billing } : {}),
+        ...(truncation ? { truncation } : {}),
+        data: input.data ?? null,
+        meta,
+    });
+    const first = fitToBudget(makeEnvelope(), budget, hints);
+    if (!first.truncated) {
+        return { content: [{ type: "text", text: first.text }] };
+    }
+    let dropped = [...first.dropped];
+    const originalBytes = first.originalBytes;
+    let truncation = {
+        budget_bytes: budget,
+        original_bytes: originalBytes,
+        final_bytes: first.finalBytes,
+        dropped,
+        hint: buildTruncationHint(originalBytes, first.finalBytes, budget, hints),
+    };
+    // 固定点迭代：把 truncation 元信息本身占用的字节也纳入预算，最多 4 轮。
+    for (let round = 0; round < 4; round += 1) {
+        const envelope = makeEnvelope(truncation);
+        const text = serialize(envelope);
+        const bytes = byteLength(text);
+        if (bytes <= budget) {
+            truncation["final_bytes"] = bytes;
+            const settled = serialize(makeEnvelope(truncation));
+            if (byteLength(settled) <= budget) {
+                return { content: [{ type: "text", text: settled }] };
+            }
+            continue;
+        }
+        const shrunk = fitToBudget(envelope, budget, hints);
+        dropped = [
+            ...dropped,
+            ...shrunk.dropped.filter((item) => !dropped.some((seen) => seen.path === item.path && seen.kept === item.kept)),
+        ];
+        truncation = {
+            budget_bytes: budget,
+            original_bytes: originalBytes,
+            final_bytes: shrunk.finalBytes,
+            dropped,
+            hint: buildTruncationHint(originalBytes, shrunk.finalBytes, budget, hints),
+        };
+    }
+    // 极端兜底：只保留元信息骨架（仍是合法 JSON）。
+    const minimal = {
+        ok: true,
+        tool: input.tool,
+        as_of: input.asOf,
+        stale: input.stale,
+        truncated: true,
+        truncation: {
+            budget_bytes: budget,
+            original_bytes: originalBytes,
+            dropped,
+            hint: buildTruncationHint(originalBytes, 0, budget, hints),
+        },
+        data: { _truncated: true, note: "结果过大，仅保留元信息；请收窄参数后重试。" },
+    };
+    let text = serialize(minimal);
+    if (byteLength(text) > budget) {
+        delete minimal["truncation"];
+        minimal["truncation_note"] = `原始 ${originalBytes} B 超预算，已仅保留骨架`;
+        text = serialize(minimal);
+    }
+    return { content: [{ type: "text", text }] };
+}
+function errorPayload(error, tool, requestId, endpoints, durationMs) {
+    const normalized = error.normalized;
+    const detail = {
+        kind: normalized.kind,
+        message: normalized.message,
+        retryable: normalized.retryable,
+    };
+    if (normalized.status !== undefined)
+        detail["status"] = normalized.status;
+    if (normalized.hint)
+        detail["hint"] = normalized.hint;
+    if (normalized.need_credits !== undefined)
+        detail["need_credits"] = normalized.need_credits;
+    if (normalized.balance !== undefined)
+        detail["balance"] = normalized.balance;
+    if (normalized.required_scope !== undefined)
+        detail["required_scope"] = normalized.required_scope;
+    if (normalized.topup_url !== undefined)
+        detail["topup_url"] = normalized.topup_url;
+    if (normalized.retry_after_ms !== undefined) {
+        detail["retry_after"] = normalized.retry_after_s ?? Math.ceil(normalized.retry_after_ms / 1000);
+        detail["retry_after_ms"] = normalized.retry_after_ms;
+    }
+    if (normalized.detail !== undefined)
+        detail["detail"] = normalized.detail;
+    return {
+        ok: false,
+        tool,
+        as_of: new Date().toISOString(),
+        stale: false,
+        error: detail,
+        ...(error.billing ? { billing: error.billing } : {}),
+        meta: {
+            ...(endpoints && endpoints.length > 0 ? { endpoints } : {}),
+            ...(requestId ? { request_id: requestId } : {}),
+            ...(durationMs !== undefined ? { duration_ms: durationMs } : {}),
+        },
+    };
+}
+/** 失败也走正常 content 返回，仅把 isError 置 true —— 这样 MCP 连接不会断。 */
+export function buildErrorResult(input) {
+    const payload = errorPayload(input.error, input.tool, input.requestId, input.endpoints, input.durationMs);
+    const text = serialize(payload);
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=output.js.map