@skillfm/local 2.6.4 → 2.7.1

package/dist/router/index.d.ts

@@ -0,0 +1,7 @@
+export type { Complexity, ModelTier, ModelId, ModelSpec, RouteRequest, RouteDecision } from './types.js';
+export { MODEL_CATALOG, getModelSpec } from './catalog.js';
+export { classify, estimateTokens } from './classifier.js';
+export { route } from './route.js';
+export { generateLiteLLMConfig, configToYaml } from './litellm-config.js';
+export type { LiteLLMConfigOptions } from './litellm-config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,6 @@
+// sdk/skillfm-local/src/router/index.ts
+export { MODEL_CATALOG, getModelSpec } from './catalog.js';
+export { classify, estimateTokens } from './classifier.js';
+export { route } from './route.js';
+export { generateLiteLLMConfig, configToYaml } from './litellm-config.js';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAGxC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/router/litellm-config.d.ts

@@ -0,0 +1,34 @@
+import type { ModelSpec } from './types.js';
+export interface LiteLLMConfigOptions {
+    /** 用户配置的 BYOK key, 按 provider 分 */
+    byok_keys: Partial<{
+        anthropic: string;
+        openai: string;
+        deepseek: string;
+        kimi: string;
+        qwen: string;
+        doubao: string;
+    }>;
+    /** 排除哪些 provider (e.g. 中国用户排除 OpenAI) */
+    exclude_providers?: ReadonlyArray<ModelSpec['provider']>;
+}
+interface LiteLLMModelEntry {
+    model_name: string;
+    litellm_params: {
+        model: string;
+        api_key: string;
+        api_base?: string;
+    };
+}
+interface LiteLLMConfig {
+    model_list: LiteLLMModelEntry[];
+    router_settings: {
+        routing_strategy: string;
+        model_group_alias: Record<string, string[]>;
+    };
+}
+export declare function generateLiteLLMConfig(opts: LiteLLMConfigOptions): LiteLLMConfig;
+/** YAML 序列化 (简单版,避免引入 yaml 依赖) */
+export declare function configToYaml(cfg: LiteLLMConfig): string;
+export {};
+//# sourceMappingURL=litellm-config.d.ts.map

package/dist/router/litellm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-config.d.ts","sourceRoot":"","sources":["../../src/router/litellm-config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;CAC1D;AAED,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,eAAe,EAAE;QACf,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AAoBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAgC/E;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAmBvD"}

package/dist/router/litellm-config.js

@@ -0,0 +1,78 @@
+// sdk/skillfm-local/src/router/litellm-config.ts
+//
+// 生成 LiteLLM proxy YAML 配置 (Day 2)
+// 从 sidecar 的 BYOK key 集合 + 用户偏好生成
+// LiteLLM doc: https://docs.litellm.ai/docs/proxy/configs
+import { MODEL_CATALOG } from './catalog.js';
+const PROVIDER_API_BASE = {
+    anthropic: undefined, // 走默认
+    openai: undefined,
+    deepseek: 'https://api.deepseek.com',
+    kimi: 'https://api.moonshot.cn/v1',
+    qwen: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    doubao: 'https://ark.cn-beijing.volces.com/api/v3',
+};
+const PROVIDER_LITELLM_PREFIX = {
+    anthropic: 'anthropic/',
+    openai: 'openai/',
+    deepseek: 'openai/', // DeepSeek 兼容 OpenAI schema
+    kimi: 'openai/',
+    qwen: 'openai/',
+    doubao: 'openai/',
+};
+export function generateLiteLLMConfig(opts) {
+    const exclude = new Set(opts.exclude_providers ?? []);
+    const model_list = [];
+    const tier_groups = { cheap: [], standard: [], smart: [], multimodal: [] };
+    for (const m of MODEL_CATALOG) {
+        if (exclude.has(m.provider))
+            continue;
+        const key = opts.byok_keys[m.provider];
+        if (!key)
+            continue;
+        const litellm_model = `${PROVIDER_LITELLM_PREFIX[m.provider]}${m.id}`;
+        const entry = {
+            model_name: m.id,
+            litellm_params: {
+                model: litellm_model,
+                api_key: key,
+            },
+        };
+        const base = PROVIDER_API_BASE[m.provider];
+        if (base)
+            entry.litellm_params.api_base = base;
+        model_list.push(entry);
+        tier_groups[m.tier].push(m.id);
+        if (m.multimodal)
+            tier_groups.multimodal.push(m.id);
+    }
+    return {
+        model_list,
+        router_settings: {
+            routing_strategy: 'simple-shuffle', // Day 3+ 升级为 cost-aware-routing
+            model_group_alias: tier_groups,
+        },
+    };
+}
+/** YAML 序列化 (简单版,避免引入 yaml 依赖) */
+export function configToYaml(cfg) {
+    const lines = ['model_list:'];
+    for (const m of cfg.model_list) {
+        lines.push(`  - model_name: ${m.model_name}`);
+        lines.push(`    litellm_params:`);
+        lines.push(`      model: ${m.litellm_params.model}`);
+        lines.push(`      api_key: ${m.litellm_params.api_key}`);
+        if (m.litellm_params.api_base) {
+            lines.push(`      api_base: ${m.litellm_params.api_base}`);
+        }
+    }
+    lines.push('');
+    lines.push('router_settings:');
+    lines.push(`  routing_strategy: ${cfg.router_settings.routing_strategy}`);
+    lines.push('  model_group_alias:');
+    for (const [group, ids] of Object.entries(cfg.router_settings.model_group_alias)) {
+        lines.push(`    ${group}: [${ids.map((i) => `"${i}"`).join(', ')}]`);
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=litellm-config.js.map

package/dist/router/litellm-config.js.map

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

package/dist/router/route.d.ts

@@ -0,0 +1,3 @@
+import type { RouteDecision, RouteRequest } from './types.js';
+export declare function route(req: RouteRequest): RouteDecision;
+//# sourceMappingURL=route.d.ts.map

package/dist/router/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA6C,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAuBzG,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,CAyCtD"}

package/dist/router/route.js

@@ -0,0 +1,63 @@
+// sdk/skillfm-local/src/router/route.ts
+//
+// 路由决策器 (Day 2)
+// 接收 RouteRequest → 用 classifier 判 complexity → 选最低成本满足条件的 model
+import { MODEL_CATALOG } from './catalog.js';
+import { classify } from './classifier.js';
+const COMPLEXITY_TO_TIER = {
+    low: 'cheap',
+    medium: 'standard',
+    high: 'smart',
+    multimodal: 'multimodal',
+};
+function tierMatches(spec, target) {
+    if (target === 'multimodal')
+        return spec.multimodal;
+    // smart 用户也能用 standard 兜底, 但 standard 用户不能用 cheap (成本可控)
+    if (target === 'smart')
+        return spec.tier === 'smart' || spec.tier === 'standard';
+    if (target === 'standard')
+        return spec.tier === 'standard' || spec.tier === 'cheap';
+    return spec.tier === 'cheap';
+}
+function estimateCost(spec, input_tokens) {
+    // 假设 output ≈ input * 0.5
+    const out = input_tokens * 0.5;
+    return (input_tokens / 1_000_000) * spec.price_per_1m_input + (out / 1_000_000) * spec.price_per_1m_output;
+}
+export function route(req) {
+    const complexity = classify(req);
+    const tier_target = req.prefer_tier ?? COMPLEXITY_TO_TIER[complexity];
+    // 候选集
+    let candidates = MODEL_CATALOG.filter((m) => tierMatches(m, tier_target));
+    // context window 必须 ≥ input
+    candidates = candidates.filter((m) => m.context_window >= req.estimated_input_tokens);
+    // multimodal 必须支持
+    if (req.has_image) {
+        candidates = candidates.filter((m) => m.multimodal);
+    }
+    // 排除 provider
+    if (req.exclude_providers?.length) {
+        candidates = candidates.filter((m) => !req.exclude_providers.includes(m.provider));
+    }
+    if (candidates.length === 0) {
+        // 兜底: 所有 model 中支持 context + multimodal 的, 选最便宜
+        candidates = MODEL_CATALOG.filter((m) => m.context_window >= req.estimated_input_tokens && (!req.has_image || m.multimodal));
+    }
+    if (candidates.length === 0) {
+        // 极端兜底: 最大 context model
+        candidates = [...MODEL_CATALOG].sort((a, b) => b.context_window - a.context_window).slice(0, 1);
+    }
+    // 选成本最低
+    candidates.sort((a, b) => estimateCost(a, req.estimated_input_tokens) - estimateCost(b, req.estimated_input_tokens));
+    const winner = candidates[0];
+    const winnerCost = estimateCost(winner, req.estimated_input_tokens);
+    return {
+        model_id: winner.id,
+        reason: `complexity=${complexity}, tier=${tier_target}, cheapest match`,
+        complexity,
+        estimated_cost_usd: winnerCost,
+        alternatives: candidates.slice(1, 4).map((c) => c.id),
+    };
+}
+//# sourceMappingURL=route.js.map

package/dist/router/route.js.map

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

package/dist/router/types.d.ts

@@ -0,0 +1,36 @@
+export type Complexity = 'low' | 'medium' | 'high' | 'multimodal';
+export type ModelTier = 'cheap' | 'standard' | 'smart' | 'multimodal';
+export type ModelId = 'claude-haiku-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-7' | 'gpt-4o-mini' | 'gpt-4o' | 'o1' | 'deepseek-chat' | 'kimi-k2' | 'qwen-max' | 'doubao-pro-256k';
+export interface ModelSpec {
+    id: ModelId;
+    provider: 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'qwen' | 'doubao';
+    tier: ModelTier;
+    /** 估算价格 USD per 1M token (input avg) */
+    price_per_1m_input: number;
+    /** 估算价格 USD per 1M token (output avg) */
+    price_per_1m_output: number;
+    /** 是否支持多模态 (image input) */
+    multimodal: boolean;
+    /** 上下文窗口 (tokens) */
+    context_window: number;
+}
+export interface RouteRequest {
+    /** 用户原 prompt 或 messages 拼接后的总 token 估算 */
+    estimated_input_tokens: number;
+    /** Hint: 用户对场景的标签 (e.g. "coding", "writing", "search") */
+    hint?: string;
+    /** 是否含图片 */
+    has_image?: boolean;
+    /** 用户偏好 — 强制 cheap / smart 等 */
+    prefer_tier?: ModelTier;
+    /** 排除的 provider (e.g. 国内用户排除 anthropic) */
+    exclude_providers?: Array<ModelSpec['provider']>;
+}
+export interface RouteDecision {
+    model_id: ModelId;
+    reason: string;
+    complexity: Complexity;
+    estimated_cost_usd: number;
+    alternatives: ModelId[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/router/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAElE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;AAEtE,MAAM,MAAM,OAAO,GAEf,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GAEjB,aAAa,GACb,QAAQ,GACR,IAAI,GAEJ,eAAe,GACf,SAAS,GACT,UAAU,GACV,iBAAiB,CAAC;AAEtB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3E,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,OAAO,EAAE,CAAC;CACzB"}

package/dist/router/types.js

@@ -0,0 +1,7 @@
+// sdk/skillfm-local/src/router/types.ts
+//
+// Beacon LLM 自动路由层 (Day 2 D2-5)
+// 目标: 把"agent 想发的请求"路由到"成本最低 + 能力够用"的 model
+// 核心机制: heuristic complexity classifier + 优先级决策
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,gCAAgC;AAChC,4CAA4C;AAC5C,gDAAgD"}

package/dist/saas-connectors/base.d.ts

@@ -0,0 +1,16 @@
+import type { SaasConnector, SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions } from './types.js';
+export declare abstract class SaasBaseConnector implements SaasConnector {
+    abstract id: SaasProviderId;
+    abstract name: string;
+    abstract service_type: SaasServiceType;
+    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?: FetchSaasUsageOptions): Promise<SaasUsageRecord>;
+    abstract ping(byok_key: string): Promise<{
+        ok: boolean;
+        error?: string;
+        key_fingerprint?: string;
+    }>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGzH,8BAAsB,iBAAkB,YAAW,aAAa;IAC9D,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;cAEV,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ9F,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC7F,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpG"}

package/dist/saas-connectors/base.js

@@ -0,0 +1,16 @@
+// sdk/skillfm-local/src/saas-connectors/base.ts
+import { maskKey, sanitizeError } from '../connectors/types.js';
+export class SaasBaseConnector {
+    async safeFetch(url, init, byok_key) {
+        try {
+            return await fetch(url, init);
+        }
+        catch (e) {
+            throw new Error(sanitizeError(e, byok_key));
+        }
+    }
+    fingerprint(key) {
+        return maskKey(key);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/saas-connectors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/saas-connectors/base.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAGhD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,OAAgB,iBAAiB;IAM3B,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,IAAiB,EAAE,QAAgB;QACxE,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAChC,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/saas-connectors/brave.d.ts

@@ -0,0 +1,19 @@
+import { SaasBaseConnector } from './base.js';
+import type { SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions } from './types.js';
+export declare class BraveSearchConnector extends SaasBaseConnector {
+    id: SaasProviderId;
+    name: string;
+    service_type: SaasServiceType;
+    is_real: boolean;
+    fetchUsage(byok_key: string, _opts?: FetchSaasUsageOptions): Promise<SaasUsageRecord>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=brave.d.ts.map

package/dist/saas-connectors/brave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/brave.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAK1G,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,EAAE,EAAE,cAAc,CAAkB;IACpC,IAAI,SAAkB;IACtB,YAAY,EAAE,eAAe,CAAY;IACzC,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAcrF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;CAsB5B"}

package/dist/saas-connectors/brave.js

@@ -0,0 +1,50 @@
+// sdk/skillfm-local/src/saas-connectors/brave.ts
+//
+// Brave Search connector — 搜索 SaaS (Day 2 真实现, 部分)
+// Doc: https://api.search.brave.com/app/documentation/web-search/get-started
+// Auth: X-Subscription-Token: <key>
+// 注意: Brave 没有公开 admin usage 时序 API. 我们在 ping 时同步从 plan 端点读 quota,
+//       fetchUsage 仅返当前 plan info (per-period quota), 无历史。
+import { SaasBaseConnector } from './base.js';
+import { sanitizeError } from '../connectors/types.js';
+const SEARCH_URL = 'https://api.search.brave.com/res/v1/web/search';
+export class BraveSearchConnector extends SaasBaseConnector {
+    id = 'brave_search';
+    name = 'Brave Search';
+    service_type = 'search';
+    is_real = true;
+    async fetchUsage(byok_key, _opts) {
+        // Brave 没有 admin usage API, 用 ping 验 key + 返 plan 占位
+        const ok = await this.ping(byok_key);
+        return {
+            provider: this.id,
+            service_type: this.service_type,
+            requests: 0, // 真值需 sidecar 自统计
+            balance_usd: null,
+            spent_usd: null,
+            timestamp: new Date().toISOString(),
+            ...(ok.ok ? {} : {}),
+        };
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            // 1 次轻量 search 验 key (Brave 免费 plan 也 OK)
+            const r = await this.safeFetch(`${SEARCH_URL}?q=ping&count=1`, {
+                method: 'GET',
+                headers: {
+                    'x-subscription-token': byok_key,
+                    accept: 'application/json',
+                },
+            }, 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=brave.js.map

package/dist/saas-connectors/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../src/saas-connectors/brave.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,mDAAmD;AACnD,6EAA6E;AAC7E,oCAAoC;AACpC,mEAAmE;AACnE,2DAA2D;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,UAAU,GAAG,gDAAgD,CAAC;AAEpE,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,EAAE,GAAmB,cAAc,CAAC;IACpC,IAAI,GAAG,cAAc,CAAC;IACtB,YAAY,GAAoB,QAAQ,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC;IAEf,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAA6B;QAC9D,qDAAqD;QACrD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,CAAC,EAAE,kBAAkB;YAC/B,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAY;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,0CAA0C;YAC1C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAC5B,GAAG,UAAU,iBAAiB,EAC9B;gBACE,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,sBAAsB,EAAE,QAAQ;oBAChC,MAAM,EAAE,kBAAkB;iBAC3B;aACF,EACD,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,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;QACzG,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/saas-connectors/fal.d.ts

@@ -0,0 +1,15 @@
+import { SaasBaseConnector } from './base.js';
+import type { SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions } from './types.js';
+export declare class FalConnector extends SaasBaseConnector {
+    id: SaasProviderId;
+    name: string;
+    service_type: SaasServiceType;
+    is_real: boolean;
+    fetchUsage(_byok_key: string, _opts?: FetchSaasUsageOptions): Promise<SaasUsageRecord>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=fal.d.ts.map

package/dist/saas-connectors/fal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/fal.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE1G,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,EAAE,EAAE,cAAc,CAAS;IAC3B,IAAI,SAAY;IAChB,YAAY,EAAE,eAAe,CAAe;IAC5C,OAAO,UAAS;IAEV,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAWtF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;CAO5B"}

package/dist/saas-connectors/fal.js

@@ -0,0 +1,35 @@
+// sdk/skillfm-local/src/saas-connectors/fal.ts
+//
+// Fal AI connector — Day 2 stub (Day 3 真实现)
+//
+// 调研 (2026-04):
+//   - Fal API: https://docs.fal.ai/
+//   - Auth: Authorization: Key <api-key>
+//   - **没有**公开 billing / usage API
+//   - 替代方案: sidecar 跟踪每次 fal.run() 调用 cost (response 含 timing / output)
+//   - Day 3 真实现优先级 P1
+import { SaasBaseConnector } from './base.js';
+export class FalConnector extends SaasBaseConnector {
+    id = 'fal';
+    name = 'Fal AI';
+    service_type = 'image_gen';
+    is_real = false;
+    async fetchUsage(_byok_key, _opts) {
+        return {
+            provider: this.id,
+            service_type: this.service_type,
+            requests: 0,
+            balance_usd: null,
+            spent_usd: null,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async ping(byok_key) {
+        return {
+            ok: false,
+            error: 'Fal AI Day 2 stub — 无公开 billing API, Day 3 走 sidecar 调用追踪',
+            key_fingerprint: this.fingerprint(byok_key),
+        };
+    }
+}
+//# sourceMappingURL=fal.js.map

package/dist/saas-connectors/fal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal.js","sourceRoot":"","sources":["../../src/saas-connectors/fal.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,4CAA4C;AAC5C,EAAE;AACF,gBAAgB;AAChB,oCAAoC;AACpC,yCAAyC;AACzC,mCAAmC;AACnC,wEAAwE;AACxE,sBAAsB;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,MAAM,OAAO,YAAa,SAAQ,iBAAiB;IACjD,EAAE,GAAmB,KAAK,CAAC;IAC3B,IAAI,GAAG,QAAQ,CAAC;IAChB,YAAY,GAAoB,WAAW,CAAC;IAC5C,OAAO,GAAG,KAAK,CAAC;IAEhB,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,KAA6B;QAC/D,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,2DAA2D;YAClE,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;SAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/saas-connectors/index.d.ts

@@ -0,0 +1,11 @@
+import type { SaasConnector, SaasProviderId } from './types.js';
+export type { SaasConnector, SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions, } from './types.js';
+export { SaasBaseConnector } from './base.js';
+export { BraveSearchConnector } from './brave.js';
+export { SerperConnector } from './serper.js';
+export { ReplicateConnector } from './replicate.js';
+export { FalConnector } from './fal.js';
+export declare function getSaasConnector(id: SaasProviderId): SaasConnector;
+export declare function listSaasConnectors(): SaasConnector[];
+export declare function listRealSaasConnectors(): SaasConnector[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AASxC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,GAAG,aAAa,CAIlE;AAED,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CAEpD;AAED,wBAAgB,sBAAsB,IAAI,aAAa,EAAE,CAExD"}

package/dist/saas-connectors/index.js

@@ -0,0 +1,32 @@
+// sdk/skillfm-local/src/saas-connectors/index.ts
+//
+// SaaS connector registry — Day 2 P0 4 家 (Brave / Serper 真 + Replicate / Fal stub)
+// Day 3+ P1: Tavily / Firecrawl / ElevenLabs / Modal / Pinecone
+import { BraveSearchConnector } from './brave.js';
+import { SerperConnector } from './serper.js';
+import { ReplicateConnector } from './replicate.js';
+import { FalConnector } from './fal.js';
+export { SaasBaseConnector } from './base.js';
+export { BraveSearchConnector } from './brave.js';
+export { SerperConnector } from './serper.js';
+export { ReplicateConnector } from './replicate.js';
+export { FalConnector } from './fal.js';
+const REGISTRY = {
+    brave_search: new BraveSearchConnector(),
+    serper: new SerperConnector(),
+    replicate: new ReplicateConnector(),
+    fal: new FalConnector(),
+};
+export function getSaasConnector(id) {
+    const c = REGISTRY[id];
+    if (!c)
+        throw new Error(`unknown saas connector: ${id}`);
+    return c;
+}
+export function listSaasConnectors() {
+    return Object.values(REGISTRY).filter((c) => Boolean(c));
+}
+export function listRealSaasConnectors() {
+    return listSaasConnectors().filter((c) => c.is_real);
+}
+//# sourceMappingURL=index.js.map

package/dist/saas-connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/saas-connectors/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,mFAAmF;AACnF,gEAAgE;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAUxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,QAAQ,GAAmD;IAC/D,YAAY,EAAE,IAAI,oBAAoB,EAAE;IACxC,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,SAAS,EAAE,IAAI,kBAAkB,EAAE;IACnC,GAAG,EAAE,IAAI,YAAY,EAAE;CACxB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,EAAkB;IACjD,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/saas-connectors/replicate.d.ts

@@ -0,0 +1,19 @@
+import { SaasBaseConnector } from './base.js';
+import type { SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions } from './types.js';
+export declare class ReplicateConnector extends SaasBaseConnector {
+    id: SaasProviderId;
+    name: string;
+    service_type: SaasServiceType;
+    is_real: boolean;
+    fetchUsage(_byok_key: string, _opts?: FetchSaasUsageOptions): Promise<SaasUsageRecord>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=replicate.d.ts.map

package/dist/saas-connectors/replicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicate.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/replicate.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG1G,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,EAAE,EAAE,cAAc,CAAe;IACjC,IAAI,SAAe;IACnB,YAAY,EAAE,eAAe,CAAe;IAC5C,OAAO,UAAS;IAEV,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAWtF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;CAgB5B"}

package/dist/saas-connectors/replicate.js

@@ -0,0 +1,43 @@
+// sdk/skillfm-local/src/saas-connectors/replicate.ts
+//
+// Replicate connector — Day 2 stub (Day 3 真实现)
+//
+// 调研 (2026-04):
+//   - Replicate API: https://replicate.com/docs/reference/http
+//   - GET /v1/account (返 username/email, **没有** balance 或 usage)
+//   - **真**用量数据走 Dashboard https://replicate.com/account/billing, 没有公开 API
+//   - 替代方案: sidecar 自己跟踪每次调用 + cost 估算 (run-level metadata)
+//   - Day 3 真实现 = ping 验 key + sidecar 内 cron 拉 /v1/predictions 列表统计
+import { SaasBaseConnector } from './base.js';
+import { sanitizeError } from '../connectors/types.js';
+export class ReplicateConnector extends SaasBaseConnector {
+    id = 'replicate';
+    name = 'Replicate';
+    service_type = 'image_gen';
+    is_real = false;
+    async fetchUsage(_byok_key, _opts) {
+        return {
+            provider: this.id,
+            service_type: this.service_type,
+            requests: 0,
+            balance_usd: null,
+            spent_usd: null,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async ping(byok_key) {
+        // Day 2 ping 是真的 (验 key)
+        const fp = this.fingerprint(byok_key);
+        try {
+            const r = await this.safeFetch('https://api.replicate.com/v1/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=replicate.js.map

package/dist/saas-connectors/replicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicate.js","sourceRoot":"","sources":["../../src/saas-connectors/replicate.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,+CAA+C;AAC/C,EAAE;AACF,gBAAgB;AAChB,+DAA+D;AAC/D,iEAAiE;AACjE,2EAA2E;AAC3E,4DAA4D;AAC5D,qEAAqE;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,EAAE,GAAmB,WAAW,CAAC;IACjC,IAAI,GAAG,WAAW,CAAC;IACnB,YAAY,GAAoB,WAAW,CAAC;IAC5C,OAAO,GAAG,KAAK,CAAC;IAEhB,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,KAA6B;QAC/D,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,yBAAyB;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAC5B,sCAAsC,EACtC,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,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;QACzG,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/saas-connectors/serper.d.ts

@@ -0,0 +1,19 @@
+import { SaasBaseConnector } from './base.js';
+import type { SaasProviderId, SaasServiceType, SaasUsageRecord, FetchSaasUsageOptions } from './types.js';
+export declare class SerperConnector extends SaasBaseConnector {
+    id: SaasProviderId;
+    name: string;
+    service_type: SaasServiceType;
+    is_real: boolean;
+    fetchUsage(byok_key: string, _opts?: FetchSaasUsageOptions): Promise<SaasUsageRecord>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=serper.d.ts.map

package/dist/saas-connectors/serper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serper.d.ts","sourceRoot":"","sources":["../../src/saas-connectors/serper.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAY1G,qBAAa,eAAgB,SAAQ,iBAAiB;IACpD,EAAE,EAAE,cAAc,CAAY;IAC9B,IAAI,SAAY;IAChB,YAAY,EAAE,eAAe,CAAY;IACzC,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuBrF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;CAe5B"}