@skillfm/local 2.7.9 → 2.7.11

package/dist/_vendored-contracts/beacon-mcp-tools-v1.js

@@ -0,0 +1,131 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/beacon-mcp-tools-v1.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// @skillfm/contracts — Beacon MCP Skill Tools V1
+//
+// 本文件是 SkillFM Beacon Phase 1 MVP 的 MCP skill 工具集 CANONICAL 契约。
+// MCP skill (sdk/beacon-mcp) 和 Brain (platform/api/src/beacon/) 双方实现都从这里 import。
+//
+// 权威来源:
+//   docs/prd/PRD-SKILLFM-MCP-SKILL-V1.md §4
+//   docs/prd/PRD-SKILLFM-BEACON-CALL-SEQUENCE-V1.md §3
+//
+// 设计原则:
+//   - 30+ tools 完整名单见 §1 SKILLFM_TOOL_NAMES (常量,不能漂)
+//   - Phase 0 只详细定义"关键 5 个"代表 tool(§3-§7)
+//     其余 25+ tool 留 TODO,Week 5 实施时补完
+//   - Pro/Free 边界靠 Output 里的 isProLocked / proUpgradeHint 字段表达
+//     不是 input 直接拒(让 Free 用户能看到价值,而不是 403)
+//
+// BYOK 红线提醒:
+//   tool input/output 永远不出现 API key / cookie / session 等用户凭证
+//   涉及 LLM 路由时只交换 model 名 + cost 数字,实际 LLM 调用由 agent 用户机器自跑
+// ============================================================================
+// §1 工具命名清单(全 30+ tools 名字定下来,实现可分批)
+// ============================================================================
+/** 全部 beacon MCP tool 名(命名约定: skillfm_<verb>_<noun>) */
+export const SKILLFM_TOOL_NAMES = {
+    // 数据查询类(agent 主动查信息)
+    query: [
+        'skillfm_check_usage',
+        'skillfm_check_balance',
+        'skillfm_check_expiry',
+        'skillfm_list_assets',
+        'skillfm_get_savings_summary',
+    ],
+    // 路由建议类(任务前)
+    routing: [
+        'skillfm_suggest_route',
+        'skillfm_explain_routing',
+    ],
+    // 异常检测类(任务中)
+    anomaly: [
+        'skillfm_check_session_health',
+        'skillfm_check_burn_rate',
+    ],
+    // 优化建议类(任务后)
+    optimize: [
+        'skillfm_suggest_caching',
+        'skillfm_suggest_batching',
+        'skillfm_suggest_clear_context',
+    ],
+    // 时效预警类
+    expiry: [
+        'skillfm_check_domain_expiry',
+        'skillfm_check_ssl_expiry',
+        'skillfm_check_card_expiry',
+        'skillfm_check_balance_runway',
+    ],
+    // 跨工具发现类
+    discover: [
+        'skillfm_suggest_skill',
+        'skillfm_search_skill_market',
+    ],
+    // Avatar 推荐类
+    avatar: [
+        'skillfm_avatar_market',
+        'skillfm_explain_avatar',
+    ],
+    // Pro 升级类
+    upgrade: [
+        'skillfm_promote_pro',
+        'skillfm_show_savings_potential',
+    ],
+    // Memory / 凭证类
+    storage: [
+        'skillfm_save_credential',
+        'skillfm_get_credential',
+        'skillfm_list_credentials',
+        'skillfm_remove_credential',
+        'skillfm_explain_provider_key',
+        'skillfm_memory_sync',
+        'skillfm_memory_recall',
+    ],
+    // 月度推送类(Pro)
+    push: [
+        'skillfm_get_monthly_picks',
+        'skillfm_install_recommended_skill',
+    ],
+    // 反馈类
+    feedback: [
+        'skillfm_record_acceptance',
+        'skillfm_record_rejection',
+        'skillfm_user_preferences',
+    ],
+};
+/** 把分组扁平化的所有 tool 名,Phase 0 用于 sanity check */
+export const ALL_SKILLFM_TOOL_NAMES = Object.values(SKILLFM_TOOL_NAMES).flat();
+// ============================================================================
+// §3 关键 tool 1: skillfm_check_usage(数据查询)
+// ============================================================================
+export const SkillFmPlatform = {
+    ALL: 'all',
+    ANTHROPIC: 'anthropic',
+    OPENAI: 'openai',
+    DEEPSEEK: 'deepseek',
+    QWEN: 'qwen',
+    DOUBAO: 'doubao',
+    KIMI: 'kimi',
+    CURSOR: 'cursor',
+    CLAUDE_CODE: 'claude_code',
+    OPENCLAW: 'openclaw',
+    CLINE: 'cline',
+};
+/** 提取分类 letter,client 决策树用来查 user_prefs.disabledCategories */
+export function getCategoryFromTriggerType(triggerType) {
+    const m = /^([A-H])\d+_/.exec(triggerType);
+    return m ? m[1] : null;
+}
+// ============================================================================
+// §13 Phase 1 → Phase 2 演进的 stable surface
+// ============================================================================
+/**
+ * 本契约 v1 → v2 演进规则:
+ * - 字段只允许加,不能删
+ * - enum 只允许加新值,不能改/删现值
+ * - tool 名字本身永不改(改 = 出新 tool 名 + 老 tool 标 deprecated)
+ *
+ * 任何破坏性变更必须出 beacon-mcp-tools-v2.ts 新文件,v1 保留至少 6 个月。
+ */
+export const BEACON_MCP_TOOLS_CONTRACT_VERSION = 'v1';
+//# sourceMappingURL=beacon-mcp-tools-v1.js.map

package/dist/_vendored-contracts/beacon-mcp-tools-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-mcp-tools-v1.js","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-mcp-tools-v1.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,4EAA4E;AAC5E,qEAAqE;AAErE,iDAAiD;AACjD,EAAE;AACF,gEAAgE;AAChE,iFAAiF;AACjF,EAAE;AACF,QAAQ;AACR,4CAA4C;AAC5C,uDAAuD;AACvD,EAAE;AACF,QAAQ;AACR,qDAAqD;AACrD,0CAA0C;AAC1C,sCAAsC;AACtC,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,aAAa;AACb,6DAA6D;AAC7D,4DAA4D;AAE5D,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qBAAqB;IACrB,KAAK,EAAE;QACL,qBAAqB;QACrB,uBAAuB;QACvB,sBAAsB;QACtB,qBAAqB;QACrB,6BAA6B;KAC9B;IACD,aAAa;IACb,OAAO,EAAE;QACP,uBAAuB;QACvB,yBAAyB;KAC1B;IACD,aAAa;IACb,OAAO,EAAE;QACP,8BAA8B;QAC9B,yBAAyB;KAC1B;IACD,aAAa;IACb,QAAQ,EAAE;QACR,yBAAyB;QACzB,0BAA0B;QAC1B,+BAA+B;KAChC;IACD,QAAQ;IACR,MAAM,EAAE;QACN,6BAA6B;QAC7B,0BAA0B;QAC1B,2BAA2B;QAC3B,8BAA8B;KAC/B;IACD,SAAS;IACT,QAAQ,EAAE;QACR,uBAAuB;QACvB,6BAA6B;KAC9B;IACD,aAAa;IACb,MAAM,EAAE;QACN,uBAAuB;QACvB,wBAAwB;KACzB;IACD,UAAU;IACV,OAAO,EAAE;QACP,qBAAqB;QACrB,gCAAgC;KACjC;IACD,eAAe;IACf,OAAO,EAAE;QACP,yBAAyB;QACzB,wBAAwB;QACxB,0BAA0B;QAC1B,2BAA2B;QAC3B,8BAA8B;QAC9B,qBAAqB;QACrB,uBAAuB;KACxB;IACD,aAAa;IACb,IAAI,EAAE;QACJ,2BAA2B;QAC3B,mCAAmC;KACpC;IACD,MAAM;IACN,QAAQ,EAAE;QACR,2BAA2B;QAC3B,0BAA0B;QAC1B,0BAA0B;KAC3B;CACO,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAsB,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;AA+ClG,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;CACN,CAAC;AAsVX,8DAA8D;AAC9D,MAAM,UAAU,0BAA0B,CAAC,WAAwB;IACjE,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAa,CAAC"}

package/dist/_vendored-contracts/beacon-preferences-v1.d.ts

@@ -0,0 +1,68 @@
+import type { UserPreferences } from './beacon-mcp-tools-v1.js';
+export type { UserPreferences };
+export declare const BEACON_PREFERENCES_PATH: "/v1/beacon/preferences";
+/** 跨工作空间的契约版本标记 */
+export declare const BEACON_PREFERENCES_PROTOCOL_VERSION: "v1";
+/** client 兜底轮询间隔(分钟);Phase 2 引入 push 后可调长 */
+export declare const BEACON_PREFERENCES_POLL_INTERVAL_MIN: 30;
+/** 请求 headers */
+export interface BeaconPreferencesRequestHeaders {
+    /** v0.2 一致:长效 agent_token */
+    'X-Agent-Token': string;
+    'X-Skillfm-Local-Version'?: string;
+    Accept?: 'application/json';
+}
+/**
+ * 200 OK 响应 — 直接是完整 UserPreferences shape。
+ * 用户首次调用且未设过偏好时,Brain 应返回服务端默认值(详见 beacon-mcp-tools-v1.ts
+ * UserPreferences 字段注释中的默认值约定:maxPerSession=3 / maxPerDay=10 / 全分类启用 /
+ * quietHours.enabled=false)。
+ */
+export type BeaconPreferencesGetResponse = UserPreferences;
+/**
+ * 请求 body — Partial<UserPreferences>;只更新提供的字段。
+ *
+ * 例:用户只改 quietHours
+ *   { "quietHours": { "enabled": true, "start": "23:00", "end": "07:00", "timezone": "Asia/Shanghai" } }
+ *
+ * 例:用户禁某分类
+ *   { "disabledCategories": ["B", "G"] }
+ *
+ * 例:client 调整频率限流
+ *   { "maxPerSession": 1, "maxPerDay": 3 }
+ */
+export type BeaconPreferencesPutRequest = Partial<UserPreferences>;
+/**
+ * 200 OK 响应 — 更新后的 full UserPreferences。
+ * client 直接覆盖本地缓存,**不**做 merge(避免双方 race / merge 冲突)。
+ */
+export type BeaconPreferencesPutResponse = UserPreferences;
+export declare const BEACON_PREFERENCES_ERROR_CODES: {
+    readonly AUTH_MISSING_TOKEN: "BEACON.PREFS.AUTH.MISSING_TOKEN";
+    readonly AUTH_BAD_TOKEN: "BEACON.PREFS.AUTH.BAD_TOKEN";
+    readonly BAD_REQUEST: "BEACON.PREFS.BAD_REQUEST";
+    /** quietHours.start / end 格式错(必须 'HH:MM');或 timezone 不在 IANA 列表 */
+    readonly INVALID_QUIET_HOURS: "BEACON.PREFS.INVALID_QUIET_HOURS";
+    /** maxPerSession / maxPerDay 超合理范围(0-100) */
+    readonly INVALID_QUOTA: "BEACON.PREFS.INVALID_QUOTA";
+    readonly RATE_LIMITED: "BEACON.PREFS.RATE_LIMITED";
+    readonly INTERNAL: "BEACON.PREFS.INTERNAL";
+};
+export type BeaconPreferencesErrorCode = (typeof BEACON_PREFERENCES_ERROR_CODES)[keyof typeof BEACON_PREFERENCES_ERROR_CODES];
+export interface BeaconPreferencesErrorResponse {
+    ok: false;
+    error: {
+        code: BeaconPreferencesErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export type BeaconPreferencesGetEnvelope = {
+    ok: true;
+    data: BeaconPreferencesGetResponse;
+} | BeaconPreferencesErrorResponse;
+export type BeaconPreferencesPutEnvelope = {
+    ok: true;
+    data: BeaconPreferencesPutResponse;
+} | BeaconPreferencesErrorResponse;
+//# sourceMappingURL=beacon-preferences-v1.d.ts.map

package/dist/_vendored-contracts/beacon-preferences-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-preferences-v1.d.ts","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-preferences-v1.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,YAAY,EAAE,eAAe,EAAE,CAAC;AAMhC,eAAO,MAAM,uBAAuB,EAAG,wBAAiC,CAAC;AAEzE,mBAAmB;AACnB,eAAO,MAAM,mCAAmC,EAAG,IAAa,CAAC;AAEjE,6CAA6C;AAC7C,eAAO,MAAM,oCAAoC,EAAG,EAAW,CAAC;AAMhE,iBAAiB;AACjB,MAAM,WAAW,+BAA+B;IAC9C,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAM3D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAM3D,eAAO,MAAM,8BAA8B;;;;IAIzC,mEAAmE;;IAEnE,6CAA6C;;;;CAIrC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAEvF,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,0BAA0B,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAMD,MAAM,MAAM,4BAA4B,GACpC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,4BAA4B,CAAA;CAAE,GAChD,8BAA8B,CAAC;AAEnC,MAAM,MAAM,4BAA4B,GACpC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,4BAA4B,CAAA;CAAE,GAChD,8BAA8B,CAAC"}

package/dist/_vendored-contracts/beacon-preferences-v1.js

@@ -0,0 +1,26 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/beacon-preferences-v1.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// ============================================================================
+// §1 路径常量
+// ============================================================================
+export const BEACON_PREFERENCES_PATH = '/v1/beacon/preferences';
+/** 跨工作空间的契约版本标记 */
+export const BEACON_PREFERENCES_PROTOCOL_VERSION = 'v1';
+/** client 兜底轮询间隔(分钟);Phase 2 引入 push 后可调长 */
+export const BEACON_PREFERENCES_POLL_INTERVAL_MIN = 30;
+// ============================================================================
+// §4 错误码(统一前缀 BEACON.PREFS.*)
+// ============================================================================
+export const BEACON_PREFERENCES_ERROR_CODES = {
+    AUTH_MISSING_TOKEN: 'BEACON.PREFS.AUTH.MISSING_TOKEN',
+    AUTH_BAD_TOKEN: 'BEACON.PREFS.AUTH.BAD_TOKEN',
+    BAD_REQUEST: 'BEACON.PREFS.BAD_REQUEST',
+    /** quietHours.start / end 格式错(必须 'HH:MM');或 timezone 不在 IANA 列表 */
+    INVALID_QUIET_HOURS: 'BEACON.PREFS.INVALID_QUIET_HOURS',
+    /** maxPerSession / maxPerDay 超合理范围(0-100) */
+    INVALID_QUOTA: 'BEACON.PREFS.INVALID_QUOTA',
+    RATE_LIMITED: 'BEACON.PREFS.RATE_LIMITED',
+    INTERNAL: 'BEACON.PREFS.INTERNAL',
+};
+//# sourceMappingURL=beacon-preferences-v1.js.map

package/dist/_vendored-contracts/beacon-preferences-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-preferences-v1.js","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-preferences-v1.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,4EAA4E;AAC5E,qEAAqE;AAgCrE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAiC,CAAC;AAEzE,mBAAmB;AACnB,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAa,CAAC;AAEjE,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAW,CAAC;AA8ChE,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,kBAAkB,EAAE,iCAAiC;IACrD,cAAc,EAAE,6BAA6B;IAC7C,WAAW,EAAE,0BAA0B;IACvC,mEAAmE;IACnE,mBAAmB,EAAE,kCAAkC;IACvD,6CAA6C;IAC7C,aAAa,EAAE,4BAA4B;IAC3C,YAAY,EAAE,2BAA2B;IACzC,QAAQ,EAAE,uBAAuB;CACzB,CAAC"}

package/dist/_vendored-contracts/beacon-rule-protocol-v1.d.ts

@@ -0,0 +1,208 @@
+import type { Market, Money, SubscriptionTier, SuggestionCategory, TriggerType } from './beacon-mcp-tools-v1.js';
+export type { Market, Money, SubscriptionTier, SuggestionCategory, TriggerType };
+/** 批量拉规则(client 24h 全量同步) */
+export declare const BEACON_RULES_PATH: "/v1/beacon/rules";
+/** 单条决策(client 实时调,Brain 返回个性化建议) */
+export declare const BEACON_RULES_DECIDE_PATH: "/v1/beacon/rules/decide";
+/** 跨工作空间的契约版本标记 */
+export declare const BEACON_RULE_PROTOCOL_VERSION: "v1";
+/**
+ * trigger_pattern JSONB 形状(Phase 1 MVP):
+ * 用 key/value 描述"什么状况触发这条规则"。
+ * Brain 决策端用模式匹配 + 阈值比较;client 24h 同步后本地决策树也按此 evaluate。
+ *
+ * 例(D 时效预警):
+ *   { kind: 'asset_expiry', asset_type: 'domain', within_days_lte: 7 }
+ * 例(B 异常):
+ *   { kind: 'session_burn_anomaly', burn_usd_per_hour_gte: 5 }
+ */
+export interface RuleTriggerPattern {
+    kind: string;
+    /** 任意机读字段;client / Brain 共用 evaluator */
+    [key: string]: unknown;
+}
+/**
+ * decision_logic 描述"匹配后给什么样的 suggestion"。
+ * Phase 1 MVP 走简单 template 路线;Phase 2 引入 ml_model_version。
+ */
+export interface RuleDecisionLogic {
+    /** 'template' | 'ml_v1' | 'experiment'(Phase 1 主用 'template') */
+    strategy: 'template' | 'ml_v1' | 'experiment';
+    /** strategy=template 时,该字段必填:对应 suggestion_template 的 key */
+    template_key?: string;
+    /** strategy=experiment 时,变体配比 */
+    experiment_variants?: Record<string, number>;
+    /** 评分函数所需参数(Phase 1 选填) */
+    scoring?: Record<string, unknown>;
+}
+/**
+ * suggestion_template 中英分语,client 按 user_profile.market 选语言。
+ * placeholder 用 {{name}} 风格,client / Brain evaluator 都按此 fill。
+ */
+export interface RuleSuggestionTemplate {
+    /** 给 agent 解释给用户的英文提示 */
+    reasoning_en: string;
+    /** 中文版 */
+    reasoning_zh: string;
+    /** 命中后的预估价值 — 如 "省 $30/月" / "续费防止域名过期" */
+    estimated_value?: Money;
+    /** 用户点击后跳转 — 续费 / 升级 / 安装 skill */
+    action_url?: string;
+}
+/**
+ * beacon_rules 表 row 在网络层的标准映射。
+ * 顺序、字段名都跟 PRD-SKILLFM-BRAIN-RULE-CENTER-V1.md §3 schema 完全对齐。
+ */
+export interface BeaconRule {
+    /** UUID 或语义化 id;Phase 1 用 'D3_domain_7d_warning' 形式 */
+    rule_id: string;
+    /** 触发场景大类 A-H,见 beacon-mcp-tools-v1.ts SuggestionCategory */
+    category: SuggestionCategory;
+    /** 关联的 trigger_type(beacon-mcp-tools-v1.ts) — 形如 'D3_domain_7d_warning' */
+    trigger_type: TriggerType;
+    /** JSONB 模式 */
+    trigger_pattern: RuleTriggerPattern;
+    /** 决策逻辑(template / ml / experiment) */
+    decision_logic: RuleDecisionLogic;
+    /** 建议模板(中英) */
+    suggestion_template: RuleSuggestionTemplate;
+    /** Pro-only 规则:Free 命中时 should_suggest=true 但 is_pro_locked=true */
+    is_pro_only: boolean;
+    /** 单调递增,client since_version=N 拉增量用 */
+    version: number;
+    /** 0-100;Phase 1 灰度发布用 */
+    rollout_percent: number;
+    /** false → client 即使 cache 也不应再触发 */
+    is_active: boolean;
+    /** 实验 id(可选);决策结果须把 experiment_variant 透传给 client + feedback 上报 */
+    experiment_id?: string;
+    /** 适用市场过滤,可选;不写则全市场命中 */
+    applicable_markets?: Market[];
+    /** 适用订阅 tier 过滤,可选;不写则全 tier 命中 */
+    applicable_tiers?: SubscriptionTier[];
+    /** ISO 8601 UTC,Brain 写入,client 用作展示 */
+    created_at?: string;
+    updated_at?: string;
+}
+/** 请求 query params */
+export interface BeaconRulesRequestQuery {
+    /** A-H 单选;省略则返回全分类 */
+    category?: SuggestionCategory;
+    /** 增量同步 — 只回 version > since_version 的规则 */
+    since_version?: number;
+    /** 默认仅 is_active=true;internal 工具可置 false */
+    include_inactive?: boolean;
+}
+/** 请求 headers */
+export interface BeaconRulesRequestHeaders {
+    /** v0.2 一致:长效 agent_token */
+    'X-Agent-Token': string;
+    /** client 版本(observability) */
+    'X-Skillfm-Local-Version'?: string;
+    Accept?: 'application/json';
+}
+/** 200 OK 成功响应 */
+export interface BeaconRulesResponse {
+    /** 服务端最新 rule version(client 下次 since_version 用此) */
+    version: number;
+    /** 命中规则;空数组也是合法 */
+    rules: BeaconRule[];
+    /** ISO 8601 UTC */
+    generated_at: string;
+}
+/**
+ * 调用方传入"现在发生了什么"+ "用户是谁",Brain 决策返回是否应给建议。
+ *
+ * trigger_context 例(F 用户口头提到副业):
+ *   { mention_keywords: ['side income', 'monetize'], chat_window_size: 5 }
+ *
+ * ⚠️ BYOK 红线: trigger_context **禁止**包含 api_key / cookie / token / bearer / session_id
+ */
+export interface BeaconDecideUserProfile {
+    /** 必传 */
+    market: Market;
+    /** 必传 */
+    is_pro: boolean;
+    /** 订阅 tier 细分(免费 / 月付 / 年付 / team / trial) */
+    tier?: SubscriptionTier;
+    /** 用户偏好 hash(client 同步给 Brain,让决策端考虑 quietHours / disabledCategories) */
+    preferences_hash?: string;
+    /** 当前会话已经触发过的 rule_id(去重) */
+    session_already_suggested?: string[];
+    /** 当前 IANA 时区,Brain 决策端判断 quietHours */
+    timezone?: string;
+    /** 可选用户标识(脱敏 hash,Brain 用作个性化 cache key);**不要** 传明文 user_id */
+    user_hash?: string;
+}
+export interface BeaconDecideRequest {
+    /** 形如 'D3_domain_7d_warning';客户端必传 */
+    trigger_type: TriggerType;
+    /** 触发上下文,见上方 BYOK 红线注释 */
+    trigger_context: Record<string, unknown>;
+    /** 用户画像 */
+    user_profile: BeaconDecideUserProfile;
+    /** 决策时戳(client 端时间,ISO 8601);Brain 用作幂等 + 限流 */
+    client_timestamp?: string;
+}
+/** 200 OK 决策结果(无论是否建议都是 200) */
+export interface BeaconDecideResponse {
+    /** false → client 静默,不弹建议 */
+    should_suggest: boolean;
+    /** 命中规则 id;should_suggest=false 时仍可填(便于 client 调试) */
+    rule_id?: string;
+    /** should_suggest=true 时必填 */
+    suggestion?: BeaconSuggestion;
+    /** 命中实验时透传变体名,client feedback 必带回 */
+    experiment_variant?: string;
+    /** should_suggest=false 时给 client 的人话理由,便于本地决策树调优 */
+    reason?: 'no_match' | 'in_quiet_hours' | 'category_disabled' | 'session_quota_exceeded' | 'daily_quota_exceeded' | 'duplicate_in_session' | 'rolled_out_off' | 'other';
+}
+/**
+ * suggestion 跟 beacon-mcp-tools-v1.ts 中各 tool output 的 reasoning / estimated_value
+ * 字段语义对齐;Pro-locked 规则在此显式标记,client 决定是否弹"升 Pro 解锁"卡片。
+ */
+export interface BeaconSuggestion {
+    /** 给 agent 解释给用户的英文提示 */
+    reasoning_en: string;
+    /** 中文 */
+    reasoning_zh: string;
+    /** 决策端置信度(0-1);可选 */
+    confidence?: number;
+    /** 预估对用户的价值,如 { amount: 30, currency: 'USD' } */
+    estimated_value?: Money;
+    /** Free 用户命中 Pro-only 规则时 = true;client 应渲染升级卡 */
+    is_pro_locked: boolean;
+    /** 续费 / 升级 / 安装 skill 的跳转 */
+    action_url?: string;
+    /** session 内本次建议唯一 id,feedback 上报必带回 */
+    suggestion_id?: string;
+}
+export declare const BEACON_RULE_ERROR_CODES: {
+    readonly AUTH_MISSING_TOKEN: "BEACON.RULES.AUTH.MISSING_TOKEN";
+    readonly AUTH_BAD_TOKEN: "BEACON.RULES.AUTH.BAD_TOKEN";
+    readonly BAD_REQUEST: "BEACON.RULES.BAD_REQUEST";
+    /** trigger_context 含敏感字段 */
+    readonly BYOK_VIOLATION: "BEACON.RULES.BYOK_VIOLATION";
+    readonly RATE_LIMITED: "BEACON.RULES.RATE_LIMITED";
+    readonly INTERNAL: "BEACON.RULES.INTERNAL";
+};
+export type BeaconRuleErrorCode = (typeof BEACON_RULE_ERROR_CODES)[keyof typeof BEACON_RULE_ERROR_CODES];
+export interface BeaconRuleErrorResponse {
+    ok: false;
+    error: {
+        code: BeaconRuleErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+/** GET /v1/beacon/rules 的统一 envelope */
+export type BeaconRulesEnvelope = {
+    ok: true;
+    data: BeaconRulesResponse;
+} | BeaconRuleErrorResponse;
+/** POST /v1/beacon/rules/decide 的统一 envelope */
+export type BeaconDecideEnvelope = {
+    ok: true;
+    data: BeaconDecideResponse;
+} | BeaconRuleErrorResponse;
+//# sourceMappingURL=beacon-rule-protocol-v1.d.ts.map

package/dist/_vendored-contracts/beacon-rule-protocol-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-rule-protocol-v1.d.ts","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-rule-protocol-v1.ts"],"names":[],"mappings":"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"}

package/dist/_vendored-contracts/beacon-rule-protocol-v1.js

@@ -0,0 +1,25 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/beacon-rule-protocol-v1.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// ============================================================================
+// §1 路径常量
+// ============================================================================
+/** 批量拉规则(client 24h 全量同步) */
+export const BEACON_RULES_PATH = '/v1/beacon/rules';
+/** 单条决策(client 实时调,Brain 返回个性化建议) */
+export const BEACON_RULES_DECIDE_PATH = '/v1/beacon/rules/decide';
+/** 跨工作空间的契约版本标记 */
+export const BEACON_RULE_PROTOCOL_VERSION = 'v1';
+// ============================================================================
+// §5 错误码(统一前缀 BEACON.RULES.*)
+// ============================================================================
+export const BEACON_RULE_ERROR_CODES = {
+    AUTH_MISSING_TOKEN: 'BEACON.RULES.AUTH.MISSING_TOKEN',
+    AUTH_BAD_TOKEN: 'BEACON.RULES.AUTH.BAD_TOKEN',
+    BAD_REQUEST: 'BEACON.RULES.BAD_REQUEST',
+    /** trigger_context 含敏感字段 */
+    BYOK_VIOLATION: 'BEACON.RULES.BYOK_VIOLATION',
+    RATE_LIMITED: 'BEACON.RULES.RATE_LIMITED',
+    INTERNAL: 'BEACON.RULES.INTERNAL',
+};
+//# sourceMappingURL=beacon-rule-protocol-v1.js.map

package/dist/_vendored-contracts/beacon-rule-protocol-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-rule-protocol-v1.js","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-rule-protocol-v1.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,4EAA4E;AAC5E,qEAAqE;AAoCrE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAA2B,CAAC;AAE7D,qCAAqC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAkC,CAAC;AAE3E,mBAAmB;AACnB,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAa,CAAC;AA4M1D,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,kBAAkB,EAAE,iCAAiC;IACrD,cAAc,EAAE,6BAA6B;IAC7C,WAAW,EAAE,0BAA0B;IACvC,4BAA4B;IAC5B,cAAc,EAAE,6BAA6B;IAC7C,YAAY,EAAE,2BAA2B;IACzC,QAAQ,EAAE,uBAAuB;CACzB,CAAC"}

package/dist/_vendored-contracts/beacon-usage-v1.d.ts

@@ -0,0 +1,88 @@
+import type { Currency, Money, SkillFmPlatformKey } from './beacon-mcp-tools-v1.js';
+export type { Currency, Money, SkillFmPlatformKey };
+/** sidecar 批量上报用量 */
+export declare const BEACON_USAGE_SNAPSHOT_PATH: "/v1/beacon/usage/snapshot";
+/** 跨工作空间的契约版本标记 */
+export declare const BEACON_USAGE_PROTOCOL_VERSION: "v1";
+/** 单次请求的 snapshot 数量上限(Brain 实施侧 hard cap) */
+export declare const BEACON_USAGE_MAX_SNAPSHOTS_PER_REQUEST: 200;
+/**
+ * 用量快照 — sidecar 每 30 分钟扫描本地 agent 日志后产出。
+ * 每个 (platform, period) 一条;一次 POST 可批量传多条。
+ */
+export interface UsageSnapshot {
+    /** 与 SkillFmPlatformKey 对齐(anthropic / openai / deepseek / cursor / claude_code / ...) */
+    platform: SkillFmPlatformKey;
+    /** 统计窗口起,ISO 8601 UTC */
+    period_start: string;
+    /** 统计窗口止,ISO 8601 UTC */
+    period_end: string;
+    /** 该窗口内累计花费(数值;currency 与字段同条 currency 字段一致) */
+    total_spent: number;
+    /** 'USD' | 'CNY' */
+    currency: Currency;
+    /** 该窗口内累计 token 数(可选) */
+    total_tokens?: number;
+    /** 该窗口内累计 API 调用次数(可选) */
+    total_calls?: number;
+    /** 模型粒度细分(可选,Pro 用户更详细) */
+    by_model?: Record<string, {
+        tokens: number;
+        calls: number;
+        spent: number;
+    }>;
+    /**
+     * 任意去敏机读字段。⚠️ **绝对禁止**包含 BEACON_USAGE_BYOK_BANNED_FIELDS 中任一 key。
+     * 允许的例子: { router_version: 'v1.2', cache_hit_rate: 0.42 }
+     */
+    metadata?: Record<string, unknown>;
+}
+/** 请求 headers */
+export interface BeaconUsageRequestHeaders {
+    /** v0.2 一致:长效 agent_token */
+    'X-Agent-Token': string;
+    /** sidecar 版本(observability) */
+    'X-Skillfm-Local-Version'?: string;
+    'Content-Type': 'application/json';
+}
+/** 请求 body — 批量上报 */
+export interface BeaconUsageSnapshotRequest {
+    /** 1-200 条;超过 200 → 400 BAD_REQUEST */
+    snapshots: UsageSnapshot[];
+    /** 上报时戳(ISO 8601);可选 */
+    client_timestamp?: string;
+}
+/** 200 OK 响应 */
+export interface BeaconUsageSnapshotResponse {
+    ok: true;
+    /** 实际入库的快照条数(去重后) */
+    accepted: number;
+    /** 因重复被忽略的条数(可选) */
+    skipped?: number;
+}
+export declare const BEACON_USAGE_ERROR_CODES: {
+    readonly AUTH_MISSING_TOKEN: "BEACON.USAGE.AUTH.MISSING_TOKEN";
+    readonly AUTH_BAD_TOKEN: "BEACON.USAGE.AUTH.BAD_TOKEN";
+    readonly BAD_REQUEST: "BEACON.USAGE.BAD_REQUEST";
+    /** snapshots 长度超出 BEACON_USAGE_MAX_SNAPSHOTS_PER_REQUEST */
+    readonly PAYLOAD_TOO_LARGE: "BEACON.USAGE.PAYLOAD_TOO_LARGE";
+    /** metadata 含 BYOK 黑名单字段 */
+    readonly BYOK_VIOLATION: "BEACON.USAGE.BYOK_VIOLATION";
+    readonly RATE_LIMITED: "BEACON.USAGE.RATE_LIMITED";
+    readonly INTERNAL: "BEACON.USAGE.INTERNAL";
+};
+export type BeaconUsageErrorCode = (typeof BEACON_USAGE_ERROR_CODES)[keyof typeof BEACON_USAGE_ERROR_CODES];
+export interface BeaconUsageErrorResponse {
+    ok: false;
+    error: {
+        code: BeaconUsageErrorCode;
+        message: string;
+        /** 可选诊断字段(如 banned_field='api_key' / snapshot_index=3) */
+        details?: Record<string, unknown>;
+    };
+}
+export type BeaconUsageEnvelope = {
+    ok: true;
+    data: BeaconUsageSnapshotResponse;
+} | BeaconUsageErrorResponse;
+//# sourceMappingURL=beacon-usage-v1.d.ts.map

package/dist/_vendored-contracts/beacon-usage-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-usage-v1.d.ts","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-usage-v1.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;AAMpD,qBAAqB;AACrB,eAAO,MAAM,0BAA0B,EAAG,2BAAoC,CAAC;AAE/E,mBAAmB;AACnB,eAAO,MAAM,6BAA6B,EAAG,IAAa,CAAC;AAE3D,8CAA8C;AAC9C,eAAO,MAAM,sCAAsC,EAAG,GAAY,CAAC;AASnE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CACF,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,iBAAiB;AACjB,MAAM,WAAW,yBAAyB;IACxC,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,qBAAqB;AACrB,MAAM,WAAW,0BAA0B;IACzC,uCAAuC;IACvC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,wBAAwB;;;;IAInC,4DAA4D;;IAE5D,4BAA4B;;;;CAIpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,oBAAoB,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,0DAA0D;QAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAMD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,2BAA2B,CAAA;CAAE,GAC/C,wBAAwB,CAAC"}

package/dist/_vendored-contracts/beacon-usage-v1.js

@@ -0,0 +1,27 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/beacon-usage-v1.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// ============================================================================
+// §1 路径常量
+// ============================================================================
+/** sidecar 批量上报用量 */
+export const BEACON_USAGE_SNAPSHOT_PATH = '/v1/beacon/usage/snapshot';
+/** 跨工作空间的契约版本标记 */
+export const BEACON_USAGE_PROTOCOL_VERSION = 'v1';
+/** 单次请求的 snapshot 数量上限(Brain 实施侧 hard cap) */
+export const BEACON_USAGE_MAX_SNAPSHOTS_PER_REQUEST = 200;
+// ============================================================================
+// §5 错误码(统一前缀 BEACON.USAGE.*)
+// ============================================================================
+export const BEACON_USAGE_ERROR_CODES = {
+    AUTH_MISSING_TOKEN: 'BEACON.USAGE.AUTH.MISSING_TOKEN',
+    AUTH_BAD_TOKEN: 'BEACON.USAGE.AUTH.BAD_TOKEN',
+    BAD_REQUEST: 'BEACON.USAGE.BAD_REQUEST',
+    /** snapshots 长度超出 BEACON_USAGE_MAX_SNAPSHOTS_PER_REQUEST */
+    PAYLOAD_TOO_LARGE: 'BEACON.USAGE.PAYLOAD_TOO_LARGE',
+    /** metadata 含 BYOK 黑名单字段 */
+    BYOK_VIOLATION: 'BEACON.USAGE.BYOK_VIOLATION',
+    RATE_LIMITED: 'BEACON.USAGE.RATE_LIMITED',
+    INTERNAL: 'BEACON.USAGE.INTERNAL',
+};
+//# sourceMappingURL=beacon-usage-v1.js.map

package/dist/_vendored-contracts/beacon-usage-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-usage-v1.js","sourceRoot":"","sources":["../../src/_vendored-contracts/beacon-usage-v1.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4EAA4E;AAC5E,qEAAqE;AAgCrE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,qBAAqB;AACrB,MAAM,CAAC,MAAM,0BAA0B,GAAG,2BAAoC,CAAC;AAE/E,mBAAmB;AACnB,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAa,CAAC;AAE3D,8CAA8C;AAC9C,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAY,CAAC;AA0EnE,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,iCAAiC;IACrD,cAAc,EAAE,6BAA6B;IAC7C,WAAW,EAAE,0BAA0B;IACvC,4DAA4D;IAC5D,iBAAiB,EAAE,gCAAgC;IACnD,4BAA4B;IAC5B,cAAc,EAAE,6BAA6B;IAC7C,YAAY,EAAE,2BAA2B;IACzC,QAAQ,EAAE,uBAAuB;CACzB,CAAC"}