@skillfm/local 2.6.3 → 2.7.0

package/dist/asset-connectors/vultr.js

@@ -0,0 +1,73 @@
+// sdk/skillfm-local/src/asset-connectors/vultr.ts
+//
+// Vultr connector — Instances + 余额 (Day 2 真实现)
+// Doc: https://www.vultr.com/api/
+// Endpoints:
+//   - GET /v2/instances
+//   - GET /v2/account
+// Auth: Authorization: Bearer <api-key>
+import { AssetBaseConnector } from './base.js';
+import { sanitizeError } from '../connectors/types.js';
+const BASE_URL = 'https://api.vultr.com/v2';
+export class VultrConnector extends AssetBaseConnector {
+    id = 'vultr';
+    name = 'Vultr';
+    is_real = true;
+    async fetchAssets(byok_key, opts) {
+        const headers = { authorization: `Bearer ${byok_key}` };
+        const assets = [];
+        try {
+            const ar = await this.safeFetch(`${BASE_URL}/account`, { method: 'GET', headers }, byok_key);
+            if (ar.ok) {
+                const ad = (await ar.json());
+                assets.push({
+                    asset_type: 'api_credit',
+                    identifier: 'vultr-account-balance',
+                    display_name: `Vultr (${ad.account.email ?? 'account'})`,
+                    expires_at: null,
+                    days_left: null,
+                    provider: this.id,
+                    balance_usd: ad.account.balance,
+                    status: 'active',
+                    raw: { pending_charges: ad.account.pending_charges },
+                });
+            }
+        }
+        catch {
+            /* tolerate */
+        }
+        const r = await this.safeFetch(`${BASE_URL}/instances?per_page=${opts?.limit ?? 50}`, { method: 'GET', headers }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '');
+            throw new Error(sanitizeError(`Vultr ${r.status}: ${text}`, byok_key));
+        }
+        const data = (await r.json());
+        for (const i of data.instances ?? []) {
+            assets.push({
+                asset_type: 'vps',
+                identifier: i.id,
+                display_name: i.label || i.hostname,
+                expires_at: null,
+                days_left: null,
+                provider: this.id,
+                status: i.power_status,
+                raw: { plan: i.plan, region: i.region, date_created: i.date_created },
+            });
+        }
+        return assets;
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const r = await this.safeFetch(`${BASE_URL}/account`, { method: 'GET', headers: { authorization: `Bearer ${byok_key}` } }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return { ok: false, error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`, key_fingerprint: fp };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=vultr.js.map

package/dist/asset-connectors/vultr.js.map

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

package/dist/connectors/anthropic.d.ts

@@ -0,0 +1,10 @@
+import { BaseConnector } from './base.js';
+import type { ConnectorId, FetchUsageOptions, PingResult, UsageRecord } from './types.js';
+export declare class AnthropicConnector extends BaseConnector {
+    id: ConnectorId;
+    name: string;
+    is_real: boolean;
+    fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/connectors/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/connectors/anthropic.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuC1F,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,EAAE,EAAE,WAAW,CAAe;IAC9B,IAAI,SAAsB;IAC1B,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkD7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA8BlD"}

package/dist/connectors/anthropic.js

@@ -0,0 +1,103 @@
+// sdk/skillfm-local/src/connectors/anthropic.ts
+//
+// Anthropic Admin API connector — 真实现
+// Doc: https://docs.anthropic.com/en/api/admin-api/usage
+// Endpoint: GET /v1/organizations/usage_report/messages
+// Auth: x-api-key (admin-level key, sk-ant-admin-*)
+// Header: anthropic-version: 2023-06-01
+//
+// 注意: 用户必须使用 admin-level key 才能调 admin API。普通 user key 调会 401。
+// UI 应该明确提示用户去 console.anthropic.com 创建 admin key。
+import { BaseConnector } from './base.js';
+import { sanitizeError } from './types.js';
+const BASE_URL = 'https://api.anthropic.com';
+const VERSION = '2023-06-01';
+// 价格估算 (USD per 1M tokens, 2026-04 公开价目, 仅近似)
+const PRICE_TABLE = {
+    'claude-opus-4': { in: 15, out: 75 },
+    'claude-sonnet-4': { in: 3, out: 15 },
+    'claude-3-5-sonnet': { in: 3, out: 15 },
+    'claude-3-5-haiku': { in: 0.8, out: 4 },
+    'claude-3-opus': { in: 15, out: 75 },
+};
+function estimateUsd(model, in_tok, out_tok) {
+    const key = Object.keys(PRICE_TABLE).find((k) => model.toLowerCase().includes(k));
+    const p = key ? PRICE_TABLE[key] : { in: 3, out: 15 }; // 兜底用 sonnet 价
+    return (in_tok / 1_000_000) * p.in + (out_tok / 1_000_000) * p.out;
+}
+export class AnthropicConnector extends BaseConnector {
+    id = 'anthropic';
+    name = 'Anthropic Claude';
+    is_real = true;
+    async fetchUsage(byok_key, opts) {
+        const params = new URLSearchParams({
+            starting_at: opts.start_date.toISOString(),
+            ending_at: opts.end_date.toISOString(),
+            bucket_width: '1d',
+            limit: String(opts.limit ?? 100),
+        });
+        let url = `${BASE_URL}/v1/organizations/usage_report/messages?${params}`;
+        const records = [];
+        while (url) {
+            const r = await this.safeFetch(url, {
+                method: 'GET',
+                headers: {
+                    'x-api-key': byok_key,
+                    'anthropic-version': VERSION,
+                    'content-type': 'application/json',
+                },
+            }, byok_key);
+            if (!r.ok) {
+                const text = await r.text().catch(() => '<no body>');
+                throw new Error(sanitizeError(`Anthropic ${r.status}: ${text}`, byok_key));
+            }
+            const data = (await r.json());
+            for (const bucket of data.data ?? []) {
+                for (const item of bucket.results ?? []) {
+                    const in_tok = item.input_tokens + (item.cache_creation_input_tokens ?? 0);
+                    const out_tok = item.output_tokens;
+                    records.push({
+                        provider: 'anthropic',
+                        model: item.model,
+                        timestamp: bucket.starting_at,
+                        input_tokens: in_tok,
+                        output_tokens: out_tok,
+                        estimated_usd: estimateUsd(item.model, in_tok, out_tok),
+                        calls: 1,
+                    });
+                }
+            }
+            url = data.has_more && data.next_page ? `${BASE_URL}${data.next_page}` : null;
+        }
+        return records;
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            // 拉一个最短窗口 (近 1 天) 验 key
+            const end = new Date();
+            const start = new Date(end.getTime() - 24 * 3600 * 1000);
+            const params = new URLSearchParams({
+                starting_at: start.toISOString(),
+                ending_at: end.toISOString(),
+                bucket_width: '1d',
+                limit: '1',
+            });
+            const r = await this.safeFetch(`${BASE_URL}/v1/organizations/usage_report/messages?${params}`, {
+                method: 'GET',
+                headers: {
+                    'x-api-key': byok_key,
+                    'anthropic-version': VERSION,
+                },
+            }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return { ok: false, error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`, key_fingerprint: fp };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/connectors/anthropic.js.map

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

package/dist/connectors/base.d.ts

@@ -0,0 +1,11 @@
+import type { Connector, ConnectorId, FetchUsageOptions, UsageRecord, PingResult } from './types.js';
+export declare abstract class BaseConnector implements Connector {
+    abstract id: ConnectorId;
+    abstract name: string;
+    abstract is_real: boolean;
+    protected safeFetch(url: string, init: RequestInit, byok_key: string): Promise<Response>;
+    protected fingerprint(key: string): string;
+    abstract fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    abstract ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGrG,8BAAsB,aAAc,YAAW,SAAS;IACtD,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;cAEV,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC;IASpB,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACtF,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CACrD"}

package/dist/connectors/base.js

@@ -0,0 +1,19 @@
+// sdk/skillfm-local/src/connectors/base.ts
+//
+// BaseConnector — 共用 fetch / retry / error 脱敏
+import { maskKey, sanitizeError } from './types.js';
+export class BaseConnector {
+    async safeFetch(url, init, byok_key) {
+        try {
+            const r = await fetch(url, init);
+            return r;
+        }
+        catch (e) {
+            throw new Error(sanitizeError(e, byok_key));
+        }
+    }
+    fingerprint(key) {
+        return maskKey(key);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/connectors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,8CAA8C;AAG9C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,OAAgB,aAAa;IAKvB,KAAK,CAAC,SAAS,CACvB,GAAW,EACX,IAAiB,EACjB,QAAgB;QAEhB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAES,WAAW,CAAC,GAAW;QAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;CAIF"}

package/dist/connectors/deepseek.d.ts

@@ -0,0 +1,14 @@
+import { BaseConnector } from './base.js';
+import type { ConnectorId, FetchUsageOptions, PingResult, UsageRecord } from './types.js';
+export declare class DeepSeekConnector extends BaseConnector {
+    id: ConnectorId;
+    name: string;
+    is_real: boolean;
+    /**
+     * DeepSeek 没公开 usage 时序 API, 此方法返当前 balance 作为单点 record。
+     * sidecar 内由 cron 每 15min 调用一次, brain 端做差量计算反推 usage。
+     */
+    fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=deepseek.d.ts.map

package/dist/connectors/deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/connectors/deepseek.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAe1F,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,EAAE,EAAE,WAAW,CAAc;IAC7B,IAAI,SAAc;IAClB,OAAO,UAAQ;IAEf;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsC7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAsBlD"}

package/dist/connectors/deepseek.js

@@ -0,0 +1,77 @@
+// sdk/skillfm-local/src/connectors/deepseek.ts
+//
+// DeepSeek connector — 真实现 (Day 2 D2-1)
+// Doc: https://api-docs.deepseek.com/api/get-user-balance
+// Endpoint: GET /user/balance
+// Auth: Authorization: Bearer <api-key>
+//
+// 注意:
+//   - DeepSeek 当前**没有**公开 admin-level usage 时序 API (2026-04 现状)
+//   - 我们用 balance API 间接追踪: 跟时间序列 diff 推算 token 消耗
+//   - sidecar 内 cron 定期 poll (15 min/次), brain 端做差量计算
+//   - Day 3+ 关注 DeepSeek 是否开放 admin usage API, 一旦开放切换
+import { BaseConnector } from './base.js';
+import { sanitizeError } from './types.js';
+const BASE_URL = 'https://api.deepseek.com';
+export class DeepSeekConnector extends BaseConnector {
+    id = 'deepseek';
+    name = 'DeepSeek';
+    is_real = true;
+    /**
+     * DeepSeek 没公开 usage 时序 API, 此方法返当前 balance 作为单点 record。
+     * sidecar 内由 cron 每 15min 调用一次, brain 端做差量计算反推 usage。
+     */
+    async fetchUsage(byok_key, opts) {
+        const r = await this.safeFetch(`${BASE_URL}/user/balance`, {
+            method: 'GET',
+            headers: {
+                authorization: `Bearer ${byok_key}`,
+                'content-type': 'application/json',
+            },
+        }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '<no body>');
+            throw new Error(sanitizeError(`DeepSeek ${r.status}: ${text}`, byok_key));
+        }
+        const data = (await r.json());
+        // Convert balance snapshot to a synthetic UsageRecord (balance 当前值, 不含历史)
+        // 真用量需 sidecar 缓存上一次 balance 做 diff
+        const usd_balance = (data.balance_infos ?? []).find((b) => b.currency === 'USD');
+        const cny_balance = (data.balance_infos ?? []).find((b) => b.currency === 'CNY');
+        const usd = usd_balance ? parseFloat(usd_balance.total_balance) : 0;
+        const cny = cny_balance ? parseFloat(cny_balance.total_balance) : 0;
+        return [
+            {
+                provider: 'deepseek',
+                model: 'balance-snapshot', // 特殊 marker, 表示这不是真 usage
+                timestamp: opts.end_date.toISOString(),
+                input_tokens: 0,
+                output_tokens: 0,
+                // estimated_usd 字段复用为"当前剩余余额 USD" (sidecar 解析时处理)
+                estimated_usd: usd > 0 ? usd : cny / 7.3,
+                calls: 0,
+            },
+        ];
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const r = await this.safeFetch(`${BASE_URL}/user/balance`, {
+                method: 'GET',
+                headers: { authorization: `Bearer ${byok_key}` },
+            }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return {
+                ok: false,
+                error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`,
+                key_fingerprint: fp,
+            };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/connectors/deepseek.js.map

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

package/dist/connectors/doubao.d.ts

@@ -0,0 +1,10 @@
+import { BaseConnector } from './base.js';
+import type { ConnectorId, FetchUsageOptions, PingResult, UsageRecord } from './types.js';
+export declare class DoubaoConnector extends BaseConnector {
+    id: ConnectorId;
+    name: string;
+    is_real: boolean;
+    fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=doubao.d.ts.map

package/dist/connectors/doubao.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubao.d.ts","sourceRoot":"","sources":["../../src/connectors/doubao.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAc1F,qBAAa,eAAgB,SAAQ,aAAa;IAChD,EAAE,EAAE,WAAW,CAAY;IAC3B,IAAI,SAAU;IACd,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgC7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAmBlD"}

package/dist/connectors/doubao.js

@@ -0,0 +1,64 @@
+// sdk/skillfm-local/src/connectors/doubao.ts
+//
+// Doubao (字节火山方舟 Ark) connector — Day 4 真实现
+// Doc: https://www.volcengine.com/docs/82379
+// Endpoint: Ark API https://ark.cn-beijing.volces.com (Bearer + Ark API Key)
+//
+// 调研校准 (2026-04):
+//   - 火山方舟 (Ark) 调 Doubao 模型走简单 Bearer + Ark API key
+//   - 真账单 / 时序 usage 走火山引擎账单 OpenAPI (需要 V4 SignerV4)
+//   - 简化: Ark 暴露 endpoint /endpoints 列表 + sidecar 自统计
+//   - Day 5+ 真账单走 volc-v4 signer (火山 V4 signer 已就位)
+import { BaseConnector } from './base.js';
+import { sanitizeError } from './types.js';
+const BASE_URL = 'https://ark.cn-beijing.volces.com';
+export class DoubaoConnector extends BaseConnector {
+    id = 'doubao';
+    name = '字节豆包';
+    is_real = true;
+    async fetchUsage(byok_key, opts) {
+        // Ark 没公开时序 usage. ping-style 拉 endpoint list + 计 endpoint 数
+        // 真用量由 sidecar 跟踪每次调用 + Day 5+ 接火山 V4 signer 拉账单
+        const r = await this.safeFetch(`${BASE_URL}/api/v3/endpoints?PageNumber=1&PageSize=10`, {
+            method: 'GET',
+            headers: {
+                authorization: `Bearer ${byok_key}`,
+                'content-type': 'application/json',
+            },
+        }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '');
+            throw new Error(sanitizeError(`Doubao Ark ${r.status}: ${text}`, byok_key));
+        }
+        const data = (await r.json());
+        return [
+            {
+                provider: 'doubao',
+                model: 'endpoint-snapshot',
+                timestamp: opts.end_date.toISOString(),
+                input_tokens: 0,
+                output_tokens: 0,
+                estimated_usd: 0,
+                calls: data.Items?.length ?? 0, // endpoint 数
+            },
+        ];
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const r = await this.safeFetch(`${BASE_URL}/api/v3/endpoints?PageNumber=1&PageSize=1`, { method: 'GET', headers: { authorization: `Bearer ${byok_key}` } }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return {
+                ok: false,
+                error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`,
+                key_fingerprint: fp,
+            };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=doubao.js.map

package/dist/connectors/doubao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubao.js","sourceRoot":"","sources":["../../src/connectors/doubao.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,4CAA4C;AAC5C,6CAA6C;AAC7C,6EAA6E;AAC7E,EAAE;AACF,kBAAkB;AAClB,qDAAqD;AACrD,sDAAsD;AACtD,sDAAsD;AACtD,oDAAoD;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAWrD,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,EAAE,GAAgB,QAAQ,CAAC;IAC3B,IAAI,GAAG,MAAM,CAAC;IACd,OAAO,GAAG,IAAI,CAAC;IAEf,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,IAAuB;QACxD,6DAA6D;QAC7D,iDAAiD;QACjD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAC5B,GAAG,QAAQ,4CAA4C,EACvD;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,QAAQ,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;SACF,EACD,QAAQ,CACT,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAyB,CAAC;QACtD,OAAO;YACL;gBACE,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,mBAAmB;gBAC1B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;gBACtC,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,CAAC;gBAChB,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,aAAa;aAC9C;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAC5B,GAAG,QAAQ,2CAA2C,EACtD,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,EAAE,EAAE,EAAE,EACnE,QAAQ,CACT,CAAC;YACF,IAAI,CAAC,CAAC,EAAE;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;gBAC3D,eAAe,EAAE,EAAE;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;CACF"}

package/dist/connectors/index.d.ts

@@ -0,0 +1,14 @@
+import type { Connector, ConnectorId } from './types.js';
+export type { Connector, ConnectorId, UsageRecord, FetchUsageOptions, PingResult } from './types.js';
+export { maskKey, sanitizeError } from './types.js';
+export { BaseConnector } from './base.js';
+export { AnthropicConnector } from './anthropic.js';
+export { OpenAIConnector } from './openai.js';
+export { DeepSeekConnector } from './deepseek.js';
+export { KimiConnector } from './kimi.js';
+export { QwenConnector } from './qwen.js';
+export { DoubaoConnector } from './doubao.js';
+export declare function getConnector(id: ConnectorId): Connector;
+export declare function listConnectors(): Connector[];
+export declare function listRealConnectors(): Connector[];
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAW9C,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,CAIvD;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAEhD"}

package/dist/connectors/index.js

@@ -0,0 +1,42 @@
+// sdk/skillfm-local/src/connectors/index.ts
+//
+// Connector registry — 6 LLM 统一入口
+// 通过 package.json exports 暴露为 ./connectors subpath; 用户代码侧用法:
+//   const c = getConnector('anthropic');
+//   const records = await c.fetchUsage(byok_key, { start_date, end_date });
+// (具体 import 语法见 README; 此文件不写示例避免 verify-no-bare-workspace-imports 误报)
+import { AnthropicConnector } from './anthropic.js';
+import { OpenAIConnector } from './openai.js';
+import { DeepSeekConnector } from './deepseek.js';
+import { KimiConnector } from './kimi.js';
+import { QwenConnector } from './qwen.js';
+import { DoubaoConnector } from './doubao.js';
+export { maskKey, sanitizeError } from './types.js';
+export { BaseConnector } from './base.js';
+export { AnthropicConnector } from './anthropic.js';
+export { OpenAIConnector } from './openai.js';
+export { DeepSeekConnector } from './deepseek.js';
+export { KimiConnector } from './kimi.js';
+export { QwenConnector } from './qwen.js';
+export { DoubaoConnector } from './doubao.js';
+const REGISTRY = {
+    anthropic: new AnthropicConnector(),
+    openai: new OpenAIConnector(),
+    deepseek: new DeepSeekConnector(),
+    qwen: new QwenConnector(),
+    doubao: new DoubaoConnector(),
+    kimi: new KimiConnector(),
+};
+export function getConnector(id) {
+    const c = REGISTRY[id];
+    if (!c)
+        throw new Error(`unknown connector: ${id}`);
+    return c;
+}
+export function listConnectors() {
+    return Object.values(REGISTRY);
+}
+export function listRealConnectors() {
+    return Object.values(REGISTRY).filter((c) => c.is_real);
+}
+//# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,kCAAkC;AAClC,6DAA6D;AAC7D,yCAAyC;AACzC,4EAA4E;AAC5E,wEAAwE;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,QAAQ,GAAmC;IAC/C,SAAS,EAAE,IAAI,kBAAkB,EAAE;IACnC,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,IAAI,EAAE,IAAI,aAAa,EAAE;IACzB,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,IAAI,EAAE,IAAI,aAAa,EAAE;CAC1B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAAe;IAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/connectors/kimi.d.ts

@@ -0,0 +1,10 @@
+import { BaseConnector } from './base.js';
+import type { ConnectorId, FetchUsageOptions, PingResult, UsageRecord } from './types.js';
+export declare class KimiConnector extends BaseConnector {
+    id: ConnectorId;
+    name: string;
+    is_real: boolean;
+    fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=kimi.d.ts.map

package/dist/connectors/kimi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../src/connectors/kimi.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAe1F,qBAAa,aAAc,SAAQ,aAAa;IAC9C,EAAE,EAAE,WAAW,CAAU;IACzB,IAAI,SAAe;IACnB,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmC7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAsBlD"}

package/dist/connectors/kimi.js

@@ -0,0 +1,67 @@
+// sdk/skillfm-local/src/connectors/kimi.ts
+//
+// Kimi (Moonshot) connector — 真实现 (Day 2 D2-1)
+// Doc: https://platform.moonshot.cn/docs/api/misc#查询账户余额
+// Endpoint: GET /v1/users/me/balance
+// Auth: Authorization: Bearer <api-key>
+//
+// 同 DeepSeek: Kimi 也没公开 admin usage 时序 API (2026-04 现状)。
+// 用 balance API + sidecar 端 cron poll + brain 端差量计算反推 usage。
+import { BaseConnector } from './base.js';
+import { sanitizeError } from './types.js';
+const BASE_URL = 'https://api.moonshot.cn';
+export class KimiConnector extends BaseConnector {
+    id = 'kimi';
+    name = '月之暗面 Kimi';
+    is_real = true;
+    async fetchUsage(byok_key, opts) {
+        const r = await this.safeFetch(`${BASE_URL}/v1/users/me/balance`, {
+            method: 'GET',
+            headers: {
+                authorization: `Bearer ${byok_key}`,
+                'content-type': 'application/json',
+            },
+        }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '<no body>');
+            throw new Error(sanitizeError(`Kimi ${r.status}: ${text}`, byok_key));
+        }
+        const data = (await r.json());
+        if (!data.status) {
+            throw new Error(`Kimi balance API status=false (code=${data.code})`);
+        }
+        const cny_balance = data.data?.available_balance ?? 0;
+        return [
+            {
+                provider: 'kimi',
+                model: 'balance-snapshot',
+                timestamp: opts.end_date.toISOString(),
+                input_tokens: 0,
+                output_tokens: 0,
+                estimated_usd: cny_balance / 7.3, // CNY → USD approx
+                calls: 0,
+            },
+        ];
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const r = await this.safeFetch(`${BASE_URL}/v1/users/me/balance`, {
+                method: 'GET',
+                headers: { authorization: `Bearer ${byok_key}` },
+            }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return {
+                ok: false,
+                error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`,
+                key_fingerprint: fp,
+            };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=kimi.js.map

package/dist/connectors/kimi.js.map

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

package/dist/connectors/openai.d.ts

@@ -0,0 +1,10 @@
+import { BaseConnector } from './base.js';
+import type { ConnectorId, FetchUsageOptions, PingResult, UsageRecord } from './types.js';
+export declare class OpenAIConnector extends BaseConnector {
+    id: ConnectorId;
+    name: string;
+    is_real: boolean;
+    fetchUsage(byok_key: string, opts: FetchUsageOptions): Promise<UsageRecord[]>;
+    ping(byok_key: string): Promise<PingResult>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/connectors/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/connectors/openai.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwC1F,qBAAa,eAAgB,SAAQ,aAAa;IAChD,EAAE,EAAE,WAAW,CAAY;IAC3B,IAAI,SAAgB;IACpB,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkD7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA2BlD"}