antitone 1.1.0

package/dist/client.js

@@ -0,0 +1,412 @@
+/**
+ * Antitone HTTP 客户端：只做三件事 —— 拼请求（含鉴权头与计费头）、解析计费回执、规范化错误。
+ *
+ * 鉴权：Authorization: Bearer <nhk_xxx.yyy>
+ *       User-Agent: antitone-mcp/0.1.0
+ *       X-Request-Id: <随机>
+ *       X-Antitone-Billing-Detail: 1  → 服务端在 body 追加 _billing 明细
+ * 注意：API Key 通道免 X-NS-SIG 签名（签名只用于桌面端 session_key 通道）。
+ */
+import { randomUUID } from "node:crypto";
+import { USER_AGENT } from "./config.js";
+import { fromResponse, normalizeAnyThrown, toInteger } from "./errors.js";
+/** 数据时刻候选字段（按优先级）。 */
+const AS_OF_KEYS = [
+    "as_of",
+    "asOf",
+    "data_as_of",
+    "dataAsOf",
+    "server_time",
+    "updated_at",
+    "update_time",
+    "generated_at",
+    "quote_time",
+    "trade_time",
+    "snapshot_at",
+    "ts",
+    "timestamp",
+    "time",
+    "date",
+    "trade_date",
+];
+/** 服务端显式 freshness 标记（若存在则优先于时间差推断）。 */
+const STALE_KEYS = ["stale", "is_stale"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toIso(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        const ms = value > 1e12 ? value : value > 1e9 ? value * 1000 : NaN;
+        if (Number.isFinite(ms))
+            return new Date(ms).toISOString();
+        return undefined;
+    }
+    if (typeof value === "string" && value.trim() !== "") {
+        const raw = value.trim();
+        const numeric = Number(raw);
+        if (Number.isFinite(numeric) && raw.length >= 10)
+            return toIso(numeric);
+        const parsed = Date.parse(raw);
+        if (Number.isFinite(parsed))
+            return new Date(parsed).toISOString();
+        // 仅日期：YYYY-MM-DD → 视为当日 00:00 UTC
+        const dateOnly = /^\d{4}-\d{2}-\d{2}$/.exec(raw);
+        if (dateOnly) {
+            const parsedDate = Date.parse(`${raw}T00:00:00Z`);
+            if (Number.isFinite(parsedDate))
+                return new Date(parsedDate).toISOString();
+        }
+    }
+    return undefined;
+}
+/** 从 payload 中挖掘数据时刻；挖不到就用响应头 Date，再退到请求时刻。 */
+export function extractAsOf(data, headerDate, now = Date.now()) {
+    const containers = [];
+    if (isRecord(data)) {
+        containers.push(["payload", data]);
+        for (const key of ["data", "meta", "result"]) {
+            const nested = data[key];
+            if (isRecord(nested))
+                containers.push([`payload.${key}`, nested]);
+        }
+    }
+    for (const [scope, container] of containers) {
+        for (const key of AS_OF_KEYS) {
+            const iso = toIso(container[key]);
+            if (iso)
+                return { asOf: iso, asOfSource: `${scope}.${key}` };
+        }
+    }
+    const headerIso = toIso(headerDate ?? undefined);
+    if (headerIso)
+        return { asOf: headerIso, asOfSource: "header.date" };
+    return { asOf: new Date(now).toISOString(), asOfSource: "request_time" };
+}
+/** 显式 stale 标记（服务端说 stale 时不能反着报 false）。 */
+export function extractExplicitStale(data) {
+    if (!isRecord(data))
+        return undefined;
+    for (const scope of [data, isRecord(data["meta"]) ? data["meta"] : undefined]) {
+        if (!scope)
+            continue;
+        for (const key of STALE_KEYS) {
+            const value = scope[key];
+            if (typeof value === "boolean")
+                return value;
+        }
+    }
+    return undefined;
+}
+/** body `_billing` + 响应头 X-Antitone-* → Billing。body 优先（含 breakdown）。 */
+export function parseBilling(body, headers) {
+    const billing = {};
+    let found = false;
+    if (isRecord(body) && isRecord(body["_billing"])) {
+        const detail = body["_billing"];
+        const credits = toInteger(detail["credits"]);
+        const balance = toInteger(detail["balance"]);
+        if (credits !== undefined) {
+            billing.credits = credits;
+            billing.credits_from = "body";
+            found = true;
+        }
+        if (balance !== undefined) {
+            billing.balance = balance;
+            found = true;
+        }
+        if (isRecord(detail["free_daily"])) {
+            const f = detail["free_daily"];
+            const limit = toInteger(f["limit"]) ?? 0;
+            const used = toInteger(f["used"]) ?? 0;
+            const remaining = toInteger(f["remaining"]) ?? Math.max(0, limit - used);
+            billing.free_daily = {
+                limit,
+                used,
+                remaining,
+                ...(typeof f["cny_remaining"] === "number" ? { cny_remaining: f["cny_remaining"] } : {}),
+                ...(typeof f["resets"] === "string" ? { resets: f["resets"] } : {}),
+            };
+            found = true;
+        }
+        if (typeof detail["settled"] === "boolean")
+            billing.settled = detail["settled"];
+        const pricingVersion = toInteger(detail["pricing_version"]);
+        if (pricingVersion !== undefined)
+            billing.pricing_version = pricingVersion;
+        if (detail["breakdown"] !== undefined)
+            billing.breakdown = detail["breakdown"];
+        if (typeof detail["source"] === "string")
+            billing.source = detail["source"];
+    }
+    const headerCredits = toInteger(headers.get("x-antitone-credits"));
+    if (headerCredits !== undefined) {
+        found = true;
+        if (billing.credits === undefined) {
+            billing.credits = headerCredits;
+            billing.credits_from = "header";
+        }
+    }
+    const headerBalance = toInteger(headers.get("x-antitone-balance"));
+    if (headerBalance !== undefined) {
+        found = true;
+        if (billing.balance === undefined)
+            billing.balance = headerBalance;
+    }
+    const headerFreeRemaining = toInteger(headers.get("x-antitone-free-remaining"));
+    const headerFreeLimit = toInteger(headers.get("x-antitone-free-limit"));
+    if (headerFreeLimit !== undefined || headerFreeRemaining !== undefined) {
+        found = true;
+        if (billing.free_daily === undefined) {
+            const limit = headerFreeLimit ?? 0;
+            const remaining = headerFreeRemaining ?? 0;
+            billing.free_daily = { limit, remaining, used: Math.max(0, limit - remaining) };
+        }
+    }
+    const headerSource = headers.get("x-antitone-credits-source");
+    if (headerSource && billing.source === undefined)
+        billing.source = headerSource;
+    const headerPricing = toInteger(headers.get("x-antitone-pricing-version"));
+    if (headerPricing !== undefined && billing.pricing_version === undefined)
+        billing.pricing_version = headerPricing;
+    return found ? billing : undefined;
+}
+/** 去掉 body 里的 _billing（已提升到 billing 字段，避免重复占预算）。 */
+export function stripBilling(body) {
+    if (!isRecord(body) || !("_billing" in body))
+        return body;
+    const clone = { ...body };
+    delete clone["_billing"];
+    return clone;
+}
+export function buildQuery(query) {
+    if (!query)
+        return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "boolean") {
+            params.append(key, value ? "1" : "0");
+            continue;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                continue;
+            params.append(key, value.map((item) => String(item)).join(","));
+            continue;
+        }
+        const text = String(value);
+        if (text === "")
+            continue;
+        params.append(key, text);
+    }
+    const qs = params.toString();
+    return qs ? `?${qs}` : "";
+}
+export class AntitoneClient {
+    config;
+    fetchImpl;
+    constructor(config, fetchImpl) {
+        this.config = config;
+        this.fetchImpl = fetchImpl ?? globalThis.fetch;
+    }
+    get baseUrl() {
+        return this.config.baseUrl;
+    }
+    get timeoutMs() {
+        return this.config.timeoutMs;
+    }
+    async get(path, options) {
+        return this.request("GET", path, options);
+    }
+    async post(path, options) {
+        return this.request("POST", path, options);
+    }
+    async request(method, path, options) {
+        const url = `${this.config.baseUrl}${path}${buildQuery(options.query)}`;
+        const requestId = randomUUID();
+        const headers = {
+            authorization: `Bearer ${this.config.apiKey}`,
+            "user-agent": USER_AGENT,
+            "x-request-id": requestId,
+            // 让服务端在 body 追加 _billing 明细（docs §7.5）
+            "x-antitone-billing-detail": "1",
+            accept: "application/json",
+        };
+        const init = { method, headers };
+        if (options.body !== undefined) {
+            headers["content-type"] = "application/json";
+            init.body = JSON.stringify(options.body);
+        }
+        const controller = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, this.config.timeoutMs);
+        const upstreamSignal = options.signal;
+        const onAbort = () => controller.abort();
+        if (upstreamSignal) {
+            if (upstreamSignal.aborted)
+                controller.abort();
+            else
+                upstreamSignal.addEventListener("abort", onAbort, { once: true });
+        }
+        init.signal = controller.signal;
+        const startedAt = Date.now();
+        let response;
+        try {
+            response = await this.fetchImpl(url, init);
+        }
+        catch (error) {
+            throw normalizeAnyThrown(error, {
+                timedOut,
+                timeoutMs: this.config.timeoutMs,
+                url,
+                signalAborted: upstreamSignal?.aborted ?? false,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+            if (upstreamSignal)
+                upstreamSignal.removeEventListener("abort", onAbort);
+        }
+        const durationMs = Date.now() - startedAt;
+        const rawText = await response.text();
+        let body;
+        if (rawText.trim() === "") {
+            body = undefined;
+        }
+        else {
+            try {
+                body = JSON.parse(rawText);
+            }
+            catch {
+                body = rawText;
+            }
+        }
+        const billing = parseBilling(body, response.headers);
+        if (!response.ok) {
+            throw fromResponse({
+                status: response.status,
+                body,
+                retryAfterHeader: response.headers.get("retry-after"),
+                ...(billing ? { billing } : {}),
+            });
+        }
+        const data = stripBilling(body);
+        const { asOf, asOfSource } = extractAsOf(data, response.headers.get("date"));
+        const explicitStale = extractExplicitStale(data);
+        const ageMs = Date.now() - Date.parse(asOf);
+        const stale = explicitStale ?? (Number.isFinite(ageMs) ? ageMs > options.staleAfterMs : false);
+        const envelope = {
+            data,
+            asOf,
+            asOfSource,
+            stale,
+            staleAfterMs: options.staleAfterMs,
+            requestId: response.headers.get("x-request-id") ?? requestId,
+            httpStatus: response.status,
+            durationMs,
+            endpoint: path,
+        };
+        if (billing)
+            envelope.billing = billing;
+        return envelope;
+    }
+}
+/**
+ * 合并多个端点的结果（market_overview / get_usage / get_entity?include_financials）。
+ * 计费取各次之和；as_of 取最早（对 stale 判定最保守）；stale 取或。
+ */
+export function mergeEnvelopes(entries) {
+    const data = {};
+    let credits = 0;
+    let hasCredits = false;
+    let balance;
+    let source;
+    let pricingVersion;
+    let settled;
+    let freeDaily;
+    let creditsFrom;
+    const perEndpoint = [];
+    let asOf = new Date().toISOString();
+    let asOfSource = "request_time";
+    let stale = false;
+    let staleAfterMs = Number.POSITIVE_INFINITY;
+    let requestId = "";
+    let httpStatus = 200;
+    let durationMs = 0;
+    for (const [key, envelope] of entries) {
+        data[key] = envelope.data;
+        perEndpoint.push({ endpoint: envelope.endpoint, credits: envelope.billing?.credits ?? null, ms: envelope.durationMs });
+        if (envelope.billing?.credits !== undefined) {
+            credits += envelope.billing.credits;
+            hasCredits = true;
+            // 来源标记：只要有一路来自 body 的 _billing，就按 body 记（信息量更大）
+            if (envelope.billing.credits_from === "body")
+                creditsFrom = "body";
+            else if (creditsFrom === undefined)
+                creditsFrom = envelope.billing.credits_from ?? "header";
+        }
+        if (envelope.billing?.balance !== undefined)
+            balance = envelope.billing.balance;
+        if (envelope.billing?.source !== undefined)
+            source = envelope.billing.source;
+        if (envelope.billing?.pricing_version !== undefined)
+            pricingVersion = envelope.billing.pricing_version;
+        if (envelope.billing?.settled !== undefined)
+            settled = envelope.billing.settled;
+        const f = envelope.billing?.free_daily;
+        if (f)
+            freeDaily = !freeDaily || f.remaining < freeDaily.remaining ? f : freeDaily;
+        if (Date.parse(envelope.asOf) < Date.parse(asOf)) {
+            asOf = envelope.asOf;
+            asOfSource = envelope.asOfSource;
+        }
+        stale = stale || envelope.stale;
+        staleAfterMs = Math.min(staleAfterMs, envelope.staleAfterMs);
+        if (!requestId)
+            requestId = envelope.requestId;
+        httpStatus = Math.max(httpStatus, envelope.httpStatus);
+        durationMs += envelope.durationMs;
+    }
+    const billing = {};
+    if (hasCredits) {
+        billing.credits = credits;
+        billing.credits_from = creditsFrom ?? "header";
+    }
+    if (balance !== undefined)
+        billing.balance = balance;
+    if (source !== undefined)
+        billing.source = source;
+    if (pricingVersion !== undefined)
+        billing.pricing_version = pricingVersion;
+    if (settled !== undefined)
+        billing.settled = settled;
+    if (freeDaily !== undefined) {
+        billing.free_daily = freeDaily;
+        // 余额 0 但还有免费额度 —— 明确告诉模型"能继续用"，这是实测踩出来的坑：
+        // 只给 balance: 0，Agent 会自行放弃调用付费端点。
+        if ((balance ?? 0) <= 0 && freeDaily.remaining > 0) {
+            billing.note = `余额为 0，但今日免费额度还剩 ${freeDaily.remaining} 积分（约 ¥${(freeDaily.cny_remaining ?? freeDaily.remaining * 0.005).toFixed(2)}），本次由免费额度覆盖，可继续调用。`;
+        }
+    }
+    if (perEndpoint.length > 1)
+        billing.breakdown = { calls: perEndpoint };
+    const merged = {
+        data,
+        asOf,
+        asOfSource,
+        stale,
+        staleAfterMs: Number.isFinite(staleAfterMs) ? staleAfterMs : 0,
+        requestId,
+        httpStatus,
+        durationMs,
+        endpoints: entries.map(([, envelope]) => envelope.endpoint),
+    };
+    if (Object.keys(billing).length > 0)
+        merged.billing = billing;
+    return merged;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 运行时配置：全部来自环境变量，缺省值见 docs/api-platform-master-plan.md §9。
+ *
+ *   ANTITONE_API_KEY     必填，形如 nhk_xxx.yyy
+ *   ANTITONE_BASE_URL    选填，默认 https://api.desicterminal.com:8443
+ *   ANTITONE_TIMEOUT_MS  选填，默认 20000
+ *   ANTITONE_MAX_BYTES   选填，单次返回预算，默认 32768（32 KB，规范硬上限）
+ */
+export declare const PACKAGE_NAME = "antitone-mcp";
+export declare const PACKAGE_VERSION: string;
+export declare const USER_AGENT: string;
+export declare const DEFAULT_BASE_URL = "https://api.desicterminal.com:8443";
+export declare const DEFAULT_TIMEOUT_MS = 20000;
+export declare const DEFAULT_LIMIT = 20;
+/** 单次工具返回的序列化预算：32 KB（文档 §9 输出规范）。 */
+export declare const MAX_RESULT_BYTES: number;
+/** API Key 形状：`nhk_<id>.<secret>`（secret 段允许缺省以便兼容早期 key）。 */
+export declare const API_KEY_PATTERN: RegExp;
+export interface AntitoneConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+    maxResultBytes: number;
+    defaultLimit: number;
+}
+/** 配置错误（缺少 key / URL 不合法）。启动阶段直接以退出码 1 结束，并打印可读中文提示。 */
+export declare class ConfigError extends Error {
+    readonly hint: string;
+    constructor(message: string, hint: string);
+}
+export declare function normalizeBaseUrl(raw: string): string;
+export interface LoadConfigOptions {
+    /** 默认 process.env；测试可注入。 */
+    env?: Record<string, string | undefined>;
+    /** 配置告警输出（默认 stderr，绝不写 stdout，stdout 是 MCP 的 JSON-RPC 通道）。 */
+    onWarn?: (message: string) => void;
+}
+export declare function loadConfig(options?: LoadConfigOptions): AntitoneConfig;
+/** 打印用：key 只留前 8 位。 */
+export declare function maskApiKey(apiKey: string): string;
+export declare function describeConfig(config: AntitoneConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAoB3C,eAAO,MAAM,eAAe,QAAuB,CAAC;AACpD,eAAO,MAAM,UAAU,QAAuC,CAAC;AAE/D,eAAO,MAAM,gBAAgB,uCAAuC,CAAC;AACrE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,eAAe,QAA4C,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AASD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBpD;AAED,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAqC1E;AAED,uBAAuB;AACvB,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAS7D"}

package/dist/config.js

@@ -0,0 +1,117 @@
+/**
+ * 运行时配置：全部来自环境变量，缺省值见 docs/api-platform-master-plan.md §9。
+ *
+ *   ANTITONE_API_KEY     必填，形如 nhk_xxx.yyy
+ *   ANTITONE_BASE_URL    选填，默认 https://api.desicterminal.com:8443
+ *   ANTITONE_TIMEOUT_MS  选填，默认 20000
+ *   ANTITONE_MAX_BYTES   选填，单次返回预算，默认 32768（32 KB，规范硬上限）
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const PACKAGE_NAME = "antitone-mcp";
+/**
+ * 版本号：**运行时从 package.json 读**，不再手写常量。
+ *
+ * 2026-09-16 修复：此前写死 "0.1.0"，发到 0.1.1 后启动横幅与 User-Agent
+ * 仍自称 0.1.0（服务端日志里看到的客户端版本永远是错的，排查问题时极具误导性）。
+ * dist/config.js → ../package.json 即包根，npm 发布时 package.json 一定在。
+ */
+function readPackageVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const raw = readFileSync(join(here, "..", "package.json"), "utf8");
+        const v = JSON.parse(raw)?.version;
+        return typeof v === "string" && v ? v : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export const PACKAGE_VERSION = readPackageVersion();
+export const USER_AGENT = `${PACKAGE_NAME}/${PACKAGE_VERSION}`;
+export const DEFAULT_BASE_URL = "https://api.desicterminal.com:8443";
+export const DEFAULT_TIMEOUT_MS = 20_000;
+export const DEFAULT_LIMIT = 20;
+/** 单次工具返回的序列化预算：32 KB（文档 §9 输出规范）。 */
+export const MAX_RESULT_BYTES = 32 * 1024;
+/** API Key 形状：`nhk_<id>.<secret>`（secret 段允许缺省以便兼容早期 key）。 */
+export const API_KEY_PATTERN = /^nhk_[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+)?$/;
+/** 配置错误（缺少 key / URL 不合法）。启动阶段直接以退出码 1 结束，并打印可读中文提示。 */
+export class ConfigError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.name = "ConfigError";
+        this.hint = hint;
+    }
+}
+function parsePositiveInt(raw, fallback, min, max) {
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.floor(n)));
+}
+export function normalizeBaseUrl(raw) {
+    const trimmed = raw.trim().replace(/\/+$/, "");
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new ConfigError(`ANTITONE_BASE_URL 不是合法的 URL：${raw}`, `示例：https://api.desicterminal.com:8443（注意保留 :8443 端口）`);
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+        throw new ConfigError(`ANTITONE_BASE_URL 仅支持 http/https：${raw}`, `示例：https://api.desicterminal.com:8443`);
+    }
+    return trimmed;
+}
+export function loadConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const warn = options.onWarn ?? ((message) => process.stderr.write(`${message}\n`));
+    const apiKey = (env.ANTITONE_API_KEY ?? "").trim();
+    if (!apiKey) {
+        throw new ConfigError("缺少环境变量 ANTITONE_API_KEY。", [
+            "先到 Antitone 个人中心创建 API Key（只显示一次，形如 nhk_xxx.yyy），再把它写进 MCP 客户端配置：",
+            '{',
+            '  "mcpServers": {',
+            '    "antitone": {',
+            '      "command": "npx",',
+            '      "args": ["-y", "antitone-mcp"],',
+            '      "env": { "ANTITONE_API_KEY": "nhk_xxx.yyy" }',
+            "    }",
+            "  }",
+            "}",
+        ].join("\n"));
+    }
+    if (!API_KEY_PATTERN.test(apiKey)) {
+        warn(`[antitone-mcp] 警告：ANTITONE_API_KEY 形如 nhk_xxx.yyy，当前值前缀/形状不匹配（已按原值继续，若被 401 请优先检查此处）。`);
+    }
+    const baseUrl = normalizeBaseUrl(env.ANTITONE_BASE_URL ?? DEFAULT_BASE_URL);
+    return {
+        apiKey,
+        baseUrl,
+        timeoutMs: parsePositiveInt(env.ANTITONE_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, 1_000, 300_000),
+        maxResultBytes: parsePositiveInt(env.ANTITONE_MAX_BYTES, MAX_RESULT_BYTES, 4 * 1024, 4 * 1024 * 1024),
+        defaultLimit: DEFAULT_LIMIT,
+    };
+}
+/** 打印用：key 只留前 8 位。 */
+export function maskApiKey(apiKey) {
+    if (apiKey.length <= 10)
+        return `${apiKey.slice(0, 4)}****`;
+    return `${apiKey.slice(0, 10)}…${apiKey.slice(-4)}`;
+}
+export function describeConfig(config) {
+    return [
+        `${PACKAGE_NAME} v${PACKAGE_VERSION} (stdio)`,
+        `  base_url   = ${config.baseUrl}`,
+        `  api_key    = ${maskApiKey(config.apiKey)}`,
+        `  timeout    = ${config.timeoutMs} ms`,
+        `  max_bytes  = ${config.maxResultBytes} B`,
+        `  auth       = Authorization: Bearer <key>（API Key 通道免 X-NS-SIG 签名）`,
+    ].join("\n");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 错误规范化：把 HTTP 状态码 / 网络异常翻译成 agent 可读的中文语义，
+ * 并保留 402 / 403 / 429 的结构化字段（need_credits / required_scope / Retry-After）。
+ *
+ * 依据：docs/api-platform-master-plan.md §7.4 错误语义、§7.5 计费回执。
+ */
+import type { Billing } from "./client.js";
+export type ErrorKind = "config" | "invalid_key" | "insufficient_credits" | "missing_scope" | "rate_limited" | "bad_request" | "not_found" | "timeout" | "network" | "server_error" | "bad_response" | "cancelled" | "unknown";
+export interface NormalizedError {
+    kind: ErrorKind;
+    message: string;
+    hint?: string;
+    status?: number;
+    retryable: boolean;
+    retry_after_ms?: number;
+    retry_after_s?: number;
+    need_credits?: number;
+    balance?: number;
+    required_scope?: string;
+    topup_url?: string;
+    server_error?: string;
+    detail?: unknown;
+}
+export declare function toInteger(value: unknown): number | undefined;
+/** 解析 Retry-After：支持秒数或 HTTP-date。 */
+export declare function parseRetryAfter(raw: string | null | undefined, now?: number): number | undefined;
+export declare function humanizeRetryAfter(ms: number | undefined): string;
+export declare class AntitoneError extends Error {
+    readonly normalized: NormalizedError;
+    readonly billing?: Billing;
+    constructor(normalized: NormalizedError, billing?: Billing);
+    get kind(): ErrorKind;
+    get retryable(): boolean;
+}
+export interface ResponseErrorContext {
+    status: number;
+    body: unknown;
+    retryAfterHeader?: string | null;
+    billing?: Billing;
+}
+/** 把一次失败的 HTTP 响应规范化。体里若带 error/limit/required_scope 等字段则直通。 */
+export declare function fromResponse(ctx: ResponseErrorContext): AntitoneError;
+export interface ThrownErrorContext {
+    timedOut?: boolean;
+    timeoutMs?: number;
+    url?: string;
+    signalAborted?: boolean;
+}
+/** 把 fetch 抛出的异常（超时 / DNS / 连接重置 / 用户取消）规范化。 */
+export declare function normalizeThrown(error: unknown, ctx?: ThrownErrorContext): AntitoneError;
+/** 统一出口：把任意异常转成 AntitoneError（工具层绝不让异常冒泡打断 MCP 连接）。 */
+export declare function normalizeAnyThrown(error: unknown, ctx?: ThrownErrorContext): AntitoneError;
+//# sourceMappingURL=errors.d.ts.map