botmux 3.18.6 → 3.18.7

package/dist/services/budget-tracker.js

@@ -0,0 +1,306 @@
+/**
+ * Budget tracker — per-bot monthly cost budget state machine.
+ *
+ * Sits passively on the usage-ledger write path: the daemon wires a record
+ * sink (see usage-ledger.ts `setUsageLedgerRecordSink`) that feeds every
+ * positive-delta ledger record's `costCny` here. The tracker accumulates the
+ * month's spend per bot in a small state file
+ * (`budget-state-<appId>.json`, same per-bot partitioning + temp+rename
+ * durability as the ledger's `state-<appId>.json`) and decides when a
+ * budget threshold has been crossed.
+ *
+ * Alerting is edge-triggered and de-duplicated: each threshold fires at most
+ * once per month (`alertedThresholds` persisted), and a single jump that
+ * crosses several thresholds fires exactly one alert carrying the HIGHEST
+ * crossed threshold while marking ALL crossed thresholds as alerted.
+ *
+ * Pure decision + file I/O: no bot-registry, no lark client. The daemon owns
+ * notification delivery (DM to the bot owner) and the hard-stop admission
+ * gate; this module only answers "how much have we spent" and "what crossed".
+ *
+ * 升级注意：升级前的 ledger 记录没有 costCny，状态丢失重建时一律计 0——
+ * 预算统计从升级后开始累加，不回溯历史花费。
+ */
+import { mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { defaultLedgerDir } from './usage-ledger.js';
+// ─── Config parsing (loose; garbage in → feature off, never throws) ──────────
+/** Parse a `budget` block from bots.json. `monthlyCny` is the gate: a
+ *  missing/non-positive/non-finite value disables the feature (null).
+ *  Thresholds default to [80]; non-finite or out-of-(0,1000] entries are
+ *  dropped, duplicates removed, ascending order. hardStop defaults false. */
+export function parseBudgetConfig(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const r = raw;
+    const monthlyCny = typeof r.monthlyCny === 'number' && Number.isFinite(r.monthlyCny) && r.monthlyCny > 0
+        ? r.monthlyCny
+        : null;
+    if (monthlyCny === null)
+        return null;
+    const rawThresholds = Array.isArray(r.alertThresholdPercent) ? r.alertThresholdPercent : [];
+    const thresholds = [...new Set(rawThresholds.filter((t) => typeof t === 'number' && Number.isFinite(t) && t > 0 && t <= 1000))].sort((a, b) => a - b);
+    return {
+        monthlyCny,
+        alertThresholdPercent: thresholds.length > 0 ? thresholds : [80],
+        hardStop: r.hardStop === true,
+    };
+}
+// ─── State persistence ───────────────────────────────────────────────────────
+function monthOf(now) {
+    return now.toISOString().slice(0, 7);
+}
+function freshState(month) {
+    return { month, spentCny: 0, alertedThresholds: [] };
+}
+function sanitizeAppId(larkAppId) {
+    return larkAppId.replace(/[^A-Za-z0-9_-]/g, '') || 'default';
+}
+function statePath(dir, larkAppId) {
+    return join(dir, `budget-state-${sanitizeAppId(larkAppId)}.json`);
+}
+const stateCache = new Map();
+export function _resetBudgetTrackerForTest() {
+    stateCache.clear();
+}
+function normalizeState(parsed, month) {
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const p = parsed;
+    if (typeof p.month !== 'string' || !/^\d{4}-\d{2}$/.test(p.month))
+        return null;
+    if (p.month !== month)
+        return freshState(month); // lazy rollover
+    const spentCny = typeof p.spentCny === 'number' && Number.isFinite(p.spentCny) && p.spentCny >= 0
+        ? p.spentCny
+        : 0;
+    const alerted = Array.isArray(p.alertedThresholds)
+        ? [...new Set(p.alertedThresholds.filter((t) => typeof t === 'number' && Number.isFinite(t)))]
+        : [];
+    return { month: p.month, spentCny, alertedThresholds: alerted };
+}
+/** Rebuild this month's spend from the daily ledger files when the state
+ *  file is missing (deleted, or first run after upgrade). Records without
+ *  costCny (pre-upgrade) count as 0 — historical spend is NOT backfilled. */
+function rebuildBudgetStateFromLedger(dir, larkAppId, month) {
+    const state = freshState(month);
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.startsWith(`usage-${month}-`) && f.endsWith('.jsonl'));
+    }
+    catch {
+        return state;
+    }
+    for (const name of files.sort()) {
+        let content;
+        try {
+            content = readFileSync(join(dir, name), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        for (const line of content.split('\n')) {
+            if (!line.includes(larkAppId))
+                continue;
+            try {
+                const rec = JSON.parse(line);
+                if (rec?.larkAppId === larkAppId
+                    && typeof rec.costCny === 'number'
+                    && Number.isFinite(rec.costCny)
+                    && rec.costCny > 0) {
+                    state.spentCny += rec.costCny;
+                }
+            }
+            catch { /* skip malformed lines */ }
+        }
+    }
+    return state;
+}
+function loadState(dir, larkAppId, month) {
+    const path = statePath(dir, larkAppId);
+    let fileMtime = null;
+    try {
+        fileMtime = statSync(path).mtimeMs;
+    }
+    catch {
+        fileMtime = null;
+    }
+    if (fileMtime !== null) {
+        const cached = stateCache.get(path);
+        if (cached && cached.mtimeMs === fileMtime) {
+            // Cache hit — still apply lazy rollover on the way out.
+            return cached.state.month === month ? cached.state : freshState(month);
+        }
+        try {
+            const state = normalizeState(JSON.parse(readFileSync(path, 'utf8')), month);
+            if (state) {
+                stateCache.set(path, { mtimeMs: fileMtime, state });
+                return state;
+            }
+            // Unparseable shape: fall through to fresh. Do NOT cache — the next
+            // successful save overwrites the file.
+        }
+        catch {
+            // Corrupt JSON: same, fall through.
+        }
+    }
+    else {
+        // State file missing (or externally deleted): rebuild once from the
+        // current month's ledger so a lost state file doesn't lose the month's
+        // accumulated spend.
+        const rebuilt = rebuildBudgetStateFromLedger(dir, larkAppId, month);
+        if (rebuilt.spentCny > 0)
+            persistState(dir, larkAppId, rebuilt);
+        return rebuilt;
+    }
+    return freshState(month);
+}
+function persistState(dir, larkAppId, state) {
+    mkdirSync(dir, { recursive: true });
+    const target = statePath(dir, larkAppId);
+    // temp+rename keeps a crash from truncating state; the pid suffix keeps
+    // concurrent daemons from stomping each other's tmp file (same scheme as
+    // the ledger's state-<appId>.json).
+    const tmp = `${target}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify(state));
+    renameSync(tmp, target);
+    try {
+        stateCache.set(target, { mtimeMs: statSync(target).mtimeMs, state });
+    }
+    catch { /* mtime refresh is best-effort */ }
+}
+function resolveOpts(opts) {
+    const now = opts?.now ?? new Date();
+    return {
+        now,
+        dir: opts?.ledgerDir ?? defaultLedgerDir(),
+        month: monthOf(now),
+        budget: opts?.budget ?? null,
+    };
+}
+/**
+ * Accumulate one positive-delta record's cost into the bot's monthly spend.
+ * Returns an alert when this spend newly crosses one or more configured
+ * thresholds (highest crossed threshold wins; all crossed thresholds are
+ * marked alerted so they never re-fire this month). Returns null otherwise
+ * and on ANY error — budget tracking must never break the ledger path.
+ */
+export function trackBudgetSpend(larkAppId, costCny, opts) {
+    try {
+        if (!larkAppId || typeof larkAppId !== 'string')
+            return null;
+        if (!Number.isFinite(costCny))
+            return null;
+        const { dir, month, budget } = resolveOpts(opts);
+        const state = loadState(dir, larkAppId, month);
+        state.month = month;
+        state.spentCny += costCny;
+        let alert = null;
+        if (budget && budget.monthlyCny > 0) {
+            const percent = (state.spentCny / budget.monthlyCny) * 100;
+            const effective = [...budget.alertThresholdPercent];
+            // hardStop implies a 100% line even when not explicitly configured.
+            if (budget.hardStop === true && !effective.includes(100))
+                effective.push(100);
+            const newlyCrossed = effective.filter((t) => percent >= t && !state.alertedThresholds.includes(t));
+            if (newlyCrossed.length > 0) {
+                const threshold = Math.max(...newlyCrossed);
+                for (const t of effective) {
+                    if (percent >= t && !state.alertedThresholds.includes(t))
+                        state.alertedThresholds.push(t);
+                }
+                alert = {
+                    larkAppId,
+                    month,
+                    spentCny: state.spentCny,
+                    monthlyCny: budget.monthlyCny,
+                    percent,
+                    threshold,
+                    hardStop: budget.hardStop === true,
+                };
+            }
+        }
+        persistState(dir, larkAppId, state);
+        return alert;
+    }
+    catch (err) {
+        logger.warn(`budget-tracker: trackBudgetSpend failed for ${larkAppId}: ${err?.message ?? err}`);
+        return null;
+    }
+}
+/** Current month's status. Null only when there is neither a budget nor any
+ *  recorded spend. With a budget but no spend → zero values (monthlyCny and
+ *  percent present). With spend but no budget → monthlyCny/percent omitted. */
+export function getBudgetStatus(larkAppId, opts) {
+    try {
+        if (!larkAppId || typeof larkAppId !== 'string')
+            return null;
+        const { dir, month, budget } = resolveOpts(opts);
+        const state = loadState(dir, larkAppId, month);
+        if (!budget && state.spentCny <= 0)
+            return null;
+        const status = {
+            month: state.month,
+            spentCny: state.spentCny,
+            hardStop: budget?.hardStop === true,
+        };
+        if (budget && budget.monthlyCny > 0) {
+            status.monthlyCny = budget.monthlyCny;
+            status.percent = (state.spentCny / budget.monthlyCny) * 100;
+        }
+        return status;
+    }
+    catch (err) {
+        logger.warn(`budget-tracker: getBudgetStatus failed for ${larkAppId}: ${err?.message ?? err}`);
+        return null;
+    }
+}
+/** Whether new turns should be refused for this bot this month. Fails OPEN:
+ *  any error (unreadable state, bad config) returns false.
+ *
+ *  ⚠️ 判定原语已就绪但**尚未接入任何 turn 准入路径**——目前没有调用方，
+ *  所以 `hardStop: true` 只影响告警口径（隐含 100% 阈值），不会真的拦下
+ *  任务。要落地拦截需在 daemon 的入站入口（handleNewTopicAdmitted /
+ *  handleThreadReplyAdmitted）调用本函数并回复用户；那是全 bot 共用的最热
+ *  路径，属独立改动。改动时请同步 formatBudgetAlert 的文案口径。 */
+export function isBudgetHardStopped(larkAppId, opts) {
+    try {
+        if (!larkAppId || typeof larkAppId !== 'string')
+            return false;
+        const budget = opts?.budget ?? null;
+        if (!budget || budget.hardStop !== true || !(budget.monthlyCny > 0))
+            return false;
+        const { dir, month } = resolveOpts(opts);
+        const state = loadState(dir, larkAppId, month);
+        if (state.month !== month)
+            return false; // rolled over before we persisted
+        return state.spentCny >= budget.monthlyCny;
+    }
+    catch {
+        return false;
+    }
+}
+function formatMoney(v) {
+    return v.toFixed(2);
+}
+function formatThreshold(v) {
+    // Thresholds are config numbers (e.g. 80, 80.5); trim float noise.
+    return String(Math.round(v * 100) / 100);
+}
+/** Plain-text alert body for the owner DM.
+ *
+ *  ⚠️ 文案不得承诺「拒绝新任务」：hardStop 目前只有判定原语
+ *  （isBudgetHardStopped），没有任何 turn 准入路径调用它，所以配了
+ *  hardStop 也不会真的拦下任何任务。承诺拦截会让 owner 以为已被保护
+ *  而不再人工关注（比不告警更糟）。真接入准入路径后再改回强口径。 */
+export function formatBudgetAlert(alert) {
+    const spent = formatMoney(alert.spentCny);
+    const budget = formatMoney(alert.monthlyCny);
+    const percent = Math.round(alert.percent);
+    if (alert.hardStop && alert.threshold >= 100) {
+        return `🚫 月度预算已用尽：本月已用 ¥${spent} / ¥${budget}（${percent}%）。请人工关注并按需暂停会话——当前版本不会自动拒绝新任务。下月 1 日预算重置。`;
+    }
+    return `⚠️ 月度预算告警：本月已用 ¥${spent} / ¥${budget}（${percent}%），越过 ${formatThreshold(alert.threshold)}% 告警线。`;
+}
+//# sourceMappingURL=budget-tracker.js.map

package/dist/services/budget-tracker.js.map

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

package/dist/services/connector-store.d.ts

@@ -64,6 +64,22 @@ export interface ConnectorDefinition {
     lifecycleExtractors: null | {
         dedupKey: string;
     };
+    /** Inbound duplicate-delivery suppression for an at-least-once upstream.
+     *
+     *  Header/query carriage needs NO config — a key presented by the sender is
+     *  always honoured (sending it IS the declaration that the delivery is
+     *  uniquely identified), which is what makes this fix land on existing
+     *  connectors without an edit. These two knobs only cover what can't be
+     *  inferred:
+     *  - `keyPath`: dotted body path for senders that can't set a header (they can
+     *    only paste a URL), so the unique id lives inside the event JSON.
+     *  - `disabled`: escape hatch for an upstream that reuses one id across
+     *    genuinely distinct events, where suppression would lose real events.
+     *  Absent (older stores) = header/query honoured, no body path. */
+    idempotency?: {
+        keyPath?: string;
+        disabled?: boolean;
+    };
     rateLimit?: {
         windowSeconds: number;
         maxRequests: number;

package/dist/services/connector-store.d.ts.map

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

package/dist/services/connector-store.js.map

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

package/dist/services/failed-turn-retry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Failed-turn bookkeeping for the `/retry` command.
+ *
+ * A turn that ends `failed` or `ambiguous` records its exact CLI input here
+ * (persisted on the Session as `lastFailedTurn`) so the user can re-inject it
+ * with `/retry` instead of copy-pasting. Recording is guarded by the session's
+ * current reply target: a type-ahead successor already owns the prompt, so the
+ * failed predecessor must not capture it.
+ *
+ * Pure functions only — persistence and IPC stay with the daemon/command-handler
+ * callers, mirroring the ordinary-turn-recovery split.
+ */
+import type { CodexAppTurnInput, FailedTurnRecord } from '../types.js';
+/** Cooldown between two `/retry` attempts on the same session. */
+export declare const RETRY_COOLDOWN_MS = 10000;
+/** Whether a turn_terminal event should be recorded as the session's last
+ *  failed turn. `completed`/`cancelled` never qualify. When the session's
+ *  current reply target already points at a NEWER turn (type-ahead), the
+ *  failed turn's prompt has been superseded and must not be captured. */
+export declare function shouldRecordFailedTurn(terminal: {
+    turnId: string;
+    status: string;
+}, currentReplyTargetTurnId: string | undefined): boolean;
+/** Build the persisted record for a failed/interrupted turn. Returns undefined
+ *  when there is no CLI input to re-inject (e.g. a turn that died before its
+ *  prompt was wrapped). */
+export declare function buildFailedTurnRecord(terminal: {
+    turnId: string;
+    status: 'failed' | 'ambiguous';
+    errorCode?: string;
+}, sources: {
+    userPrompt?: string;
+    cliInput?: string;
+    codexAppInput?: CodexAppTurnInput;
+}, now?: Date): FailedTurnRecord | undefined;
+/** Remaining cooldown in ms before `/retry` may fire again (0 = ready). */
+export declare function retryCooldownRemaining(record: FailedTurnRecord, now?: Date, cooldownMs?: number): number;
+/** Stamp one accepted `/retry` attempt onto the session's record. No-op when
+ *  the session has no failed turn recorded. */
+export declare function markRetryAttempt(session: {
+    lastFailedTurn?: FailedTurnRecord;
+}, now?: Date): void;
+//# sourceMappingURL=failed-turn-retry.d.ts.map

package/dist/services/failed-turn-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failed-turn-retry.d.ts","sourceRoot":"","sources":["../../src/services/failed-turn-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;yEAGyE;AACzE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,wBAAwB,EAAE,MAAM,GAAG,SAAS,GAC3C,OAAO,CAMT;AAED;;2BAE2B;AAC3B,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAChF,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAAE,EACtF,GAAG,GAAE,IAAiB,GACrB,gBAAgB,GAAG,SAAS,CAY9B;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,GAAG,GAAE,IAAiB,EACtB,UAAU,GAAE,MAA0B,GACrC,MAAM,CAKR;AAED;+CAC+C;AAC/C,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,cAAc,CAAC,EAAE,gBAAgB,CAAA;CAAE,EAC9C,GAAG,GAAE,IAAiB,GACrB,IAAI,CAKN"}

package/dist/services/failed-turn-retry.js

@@ -0,0 +1,50 @@
+/** Cooldown between two `/retry` attempts on the same session. */
+export const RETRY_COOLDOWN_MS = 10_000;
+/** Whether a turn_terminal event should be recorded as the session's last
+ *  failed turn. `completed`/`cancelled` never qualify. When the session's
+ *  current reply target already points at a NEWER turn (type-ahead), the
+ *  failed turn's prompt has been superseded and must not be captured. */
+export function shouldRecordFailedTurn(terminal, currentReplyTargetTurnId) {
+    if (terminal.status !== 'failed' && terminal.status !== 'ambiguous')
+        return false;
+    if (currentReplyTargetTurnId !== undefined && currentReplyTargetTurnId !== terminal.turnId) {
+        return false;
+    }
+    return true;
+}
+/** Build the persisted record for a failed/interrupted turn. Returns undefined
+ *  when there is no CLI input to re-inject (e.g. a turn that died before its
+ *  prompt was wrapped). */
+export function buildFailedTurnRecord(terminal, sources, now = new Date()) {
+    if (!sources.cliInput)
+        return undefined;
+    return {
+        turnId: terminal.turnId,
+        userPrompt: sources.userPrompt ?? sources.cliInput,
+        cliInput: sources.cliInput,
+        ...(sources.codexAppInput ? { codexAppInput: sources.codexAppInput } : {}),
+        failedAt: now.toISOString(),
+        ...(terminal.errorCode ? { errorCode: terminal.errorCode } : {}),
+        status: terminal.status,
+        retryCount: 0,
+    };
+}
+/** Remaining cooldown in ms before `/retry` may fire again (0 = ready). */
+export function retryCooldownRemaining(record, now = new Date(), cooldownMs = RETRY_COOLDOWN_MS) {
+    if (!record.lastRetryAt)
+        return 0;
+    const last = new Date(record.lastRetryAt).getTime();
+    if (Number.isNaN(last))
+        return 0;
+    return Math.max(0, cooldownMs - (now.getTime() - last));
+}
+/** Stamp one accepted `/retry` attempt onto the session's record. No-op when
+ *  the session has no failed turn recorded. */
+export function markRetryAttempt(session, now = new Date()) {
+    const record = session.lastFailedTurn;
+    if (!record)
+        return;
+    record.retryCount += 1;
+    record.lastRetryAt = now.toISOString();
+}
+//# sourceMappingURL=failed-turn-retry.js.map

package/dist/services/failed-turn-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failed-turn-retry.js","sourceRoot":"","sources":["../../src/services/failed-turn-retry.ts"],"names":[],"mappings":"AAcA,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC;;;yEAGyE;AACzE,MAAM,UAAU,sBAAsB,CACpC,QAA4C,EAC5C,wBAA4C;IAE5C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,wBAAwB,KAAK,SAAS,IAAI,wBAAwB,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;2BAE2B;AAC3B,MAAM,UAAU,qBAAqB,CACnC,QAAgF,EAChF,OAAsF,EACtF,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ;QAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;QAC3B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,CAAC;KACd,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CACpC,MAAwB,EACxB,MAAY,IAAI,IAAI,EAAE,EACtB,aAAqB,iBAAiB;IAEtC,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;+CAC+C;AAC/C,MAAM,UAAU,gBAAgB,CAC9B,OAA8C,EAC9C,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC"}

package/dist/services/model-pricing.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Model pricing — token→金额估算的内置公开价格表与解析函数。
+ *
+ * 价格采集日：2026-08-21。来源（USD / 1M token，公开标价）：
+ *   - https://www.anthropic.com/pricing
+ *   - https://openai.com/api/pricing/
+ *   - https://ai.google.dev/pricing
+ * 汇率默认 USD→CNY = 7.2（DEFAULT_USD_CNY），可被 bots.json 的 pricing.usdCny 覆盖。
+ *
+ * 纯函数模块：禁止 import bot-registry / daemon / lark client，保证
+ * cost-calculator、usage-ledger 与单测的依赖图不被污染。未收录模型一律
+ * fail-closed（resolveModelPrice 返回 null，绝不猜价），调用方据此省略金额
+ * 字段而非错报。新模型发布需补 BUILT_IN_MODEL_PRICES。
+ */
+/** USD / 1M token。cacheRead/cacheWrite 缺省时回退 input 价。 */
+export interface ModelPrice {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
+/** bots.json `pricing` 块经宽松解析后的形态。 */
+export interface PricingOverrides {
+    usdCny?: number;
+    /** 键为模型族前缀（如 'claude-sonnet-4'），整项替换内置同键。 */
+    models?: Record<string, ModelPrice>;
+}
+/** 一次定价解析的结果：汇率 + 可选覆盖表。 */
+export interface ResolvedModelPricing {
+    usdCny: number;
+    overrides?: PricingOverrides;
+}
+/** estimateCostCny 的输入（与 SessionTokenUsage 结构兼容）。 */
+export interface TokenUsagePricingInput {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreateTokens: number;
+    model: string;
+}
+export declare const DEFAULT_USD_CNY = 7.2;
+/**
+ * 把一个 bot 的 `pricing` 块（已经过 normalizePricingOverrides）提升为一次
+ * 定价解析结果：填上汇率默认值。未配置 pricing 时返回 undefined，调用方据此
+ * 省略金额字段（fail-closed，绝不猜价）。
+ *
+ * 这里刻意只接 pricing 对象、不接 larkAppId——本模块是纯函数模块，不能 import
+ * bot-registry（会污染 cost-calculator / usage-ledger / 单测的依赖图）。各调用方
+ * 自己做 `getBot(larkAppId).config.pricing` 查表，再把结果喂进来。
+ */
+export declare function resolvePricingConfig(pricing?: PricingOverrides): ResolvedModelPricing | undefined;
+/**
+ * 内置价格表，键用模型族前缀（resolveModelPrice 做精确 + 最长前缀匹配）。
+ * 每项为 [input, output, cacheRead?, cacheWrite?]，单位 USD/1M token；
+ * cacheWrite 缺省 = input。
+ */
+export declare const BUILT_IN_MODEL_PRICES: Record<string, ModelPrice>;
+/**
+ * 宽松解析 bots.json 的 `pricing` 块：对象才接受；usdCny 须为有限正数；
+ * models 逐项校验（非法项丢弃）。没有任何有效字段时返回 undefined
+ * （整体非法 → 功能关闭，fail-open 回退内置表），绝不抛错。
+ */
+export declare function normalizePricingOverrides(raw: unknown): PricingOverrides | undefined;
+/** 剥掉 provider 前缀与日期后缀，得到可匹配内置表的规范形态。 */
+export declare function normalizeModelId(modelId: string): string;
+/**
+ * 解析模型单价（USD/1M token）。匹配顺序：
+ *   overrides 精确 → 内置精确 → overrides 最长前缀 → 内置最长前缀 → null。
+ * 未定价模型返回 null（fail-closed，绝不猜价）。
+ */
+export declare function resolveModelPrice(modelId: string, overrides?: PricingOverrides): ModelPrice | null;
+/**
+ * 按四桶 token × 单价估算人民币金额：
+ *   (input*p.input + output*p.output + cacheRead*p.cacheRead + cacheWrite*p.cacheWrite)
+ *   / 1e6 * usdCny
+ * cacheRead/cacheWrite 缺省回退 input 价。无 pricing 或模型未定价 → null
+ * （调用方省略金额字段，绝不错报）。
+ */
+export declare function estimateCostCny(usage: TokenUsagePricingInput, pricing?: ResolvedModelPricing): number | null;
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/services/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/services/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AAED,4BAA4B;AAC5B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,SAAS,CAMjG;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAuB5D,CAAC;AAsBF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAkBpF;AASD,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAUlG;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAa5G"}