@skillfm/local 2.6.4 → 2.7.1

package/dist/mcp/tools/index.js

@@ -0,0 +1,188 @@
+/**
+ * src/tools/index.ts — MCP tool registry.
+ *
+ * Pulls the canonical tool-name list from `SKILLFM_TOOL_NAMES` (vendored
+ * contract beacon-mcp-tools-v1) and registers a handler for each:
+ *   - 8 "key" tools have real handlers (Phase 0 mock-backed)
+ *   - 25+ remaining names → `_placeholder` returning TOOL_NOT_IMPLEMENTED
+ *
+ * `registerAllTools(server, deps)` is the single entry point the MCP server
+ * calls in src/index.ts. We use minimal zod schemas for each tool's input —
+ * just enough to satisfy the MCP SDK's `inputSchema` requirement; deeper
+ * validation lives inside each handler (so violations come back as
+ * SkillFmToolError envelopes, not MCP protocol errors).
+ *
+ * TODO Week 5:
+ *   - Replace `z.object({}).passthrough()` placeholder schemas with real zod
+ *     schemas derived from the vendored contract types.
+ *   - Add per-tool `description` strings (English; agents read these to
+ *     match Tool Search) — keep them keyword-rich per PRD-MCP-SKILL §4.
+ *   - Track tool-call telemetry: invocation count + latency histogram.
+ *   - Add `outputSchema` (MCP SDK supports it as of 1.1) for each Phase-0
+ *     handler with a real Output type.
+ */
+import { z } from 'zod';
+import { SKILLFM_TOOL_NAMES, } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import { handleCheckUsage } from './check-usage.js';
+import { handleSuggestRoute } from './suggest-route.js';
+import { handleCheckExpiry } from './check-expiry.js';
+import { handleAvatarMarket } from './avatar-market.js';
+import { handleGetMonthlyPicks } from './get-monthly-picks.js';
+import { handleRecordAcceptance } from './record-acceptance.js';
+import { handleRecordRejection } from './record-rejection.js';
+import { handleUserPreferences } from './user-preferences.js';
+import { makePlaceholderHandler } from './_placeholder.js';
+import { handleMemorySearch } from './memory-search.js';
+import { handleMemorySave } from './memory-save.js';
+import { handleMemoryRecent } from './memory-recent.js';
+import { handleSaveCredential, handleGetCredential, handleListCredentials, handleRemoveCredential, } from './credential-tools.js';
+// ============================================================================
+// Minimal input shape — every Phase 0 tool accepts a free-form object.
+// Validation is done inside handlers (so failures come back as
+// SkillFmToolError, not MCP-protocol level rejections).
+// ============================================================================
+const PASSTHROUGH_SCHEMA = z.object({}).passthrough();
+/** MCP SDK requires content blocks. We always wrap our envelope as JSON text. */
+function wrapEnvelope(envelope) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(envelope) }],
+        isError: !envelope.ok,
+    };
+}
+// ============================================================================
+// Key tool registration
+// ============================================================================
+function registerKeyTools(server, deps) {
+    server.tool('skillfm_check_usage', 'Get the agent\'s LLM/API spending for the current period across all platforms (Anthropic / OpenAI / DeepSeek / Qwen / Doubao / etc). Returns total spent, per-platform breakdown, savings already realized, and warnings. Call this before suggesting a budget action to the user.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleCheckUsage(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_suggest_route', 'Recommend a cheaper / faster LLM model for a specific task before the agent runs it. Returns recommended model + alternatives + estimated savings + human-readable reasoning. Use this BEFORE executing an LLM call when cost is a concern.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleSuggestRoute(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_check_expiry', 'List the user\'s expiring assets (domains, SSL certs, payment cards, API balances) within a window. Returns severity-ranked items with renewal action URLs. Use this when the user asks "what\'s expiring" or proactively in monthly reviews.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleCheckExpiry(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_avatar_market', 'Recommend SkillFM avatars (autonomous money-making skills) matching a detected user intent. Returns avatar matches + pricing + real success cases + setup requirements. Use this when the user mentions making money, side income, or specific platforms (xianyu, fiverr, etc).', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleAvatarMarket(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_get_monthly_picks', 'Fetch this month\'s curated SkillFM skill picks (Pro feature). Returns a personalized list of skills with install commands for each agent harness. Free users receive AUTH.PRO_REQUIRED — surface the upgrade prompt to the user.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleGetMonthlyPicks(input, { brain: deps.brain, isProTier: deps.isProTier });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_record_acceptance', 'Record that the user accepted a SkillFM suggestion. Pass the ruleId returned by the originating tool. Drives the brain feedback loop that personalizes future suggestions.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleRecordAcceptance(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_record_rejection', 'Record that the user dismissed a SkillFM suggestion. Optionally include a reason (not_relevant / too_pushy / wrong_timing / other). Critical for keeping suggestion quality high — call this whenever the user says no.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleRecordRejection(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_user_preferences', 'Read or update SkillFM suggestion preferences (per-session/day frequency limits, quiet hours, disabled categories A-H). Use action=get to read, action=set with a partial preferences patch to update.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleUserPreferences(input, { brain: deps.brain });
+        return wrapEnvelope(env);
+    });
+    // ─── Day 6 B1: Memory tools (Pro-only, Mem0 self-host backend) ───
+    const memoryDeps = { memory: deps.memory ?? null, isProTier: deps.isProTier };
+    server.tool('skillfm_memory_search', 'Search the user\'s cross-device / cross-session memory (Pro feature, Mem0-backed). Returns relevant past conversation snippets ranked by semantic similarity. Use this when the agent needs to recall what the user discussed in previous sessions or what they learned.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleMemorySearch(input, memoryDeps);
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_memory_save', 'Explicitly save a conversation snippet or learning to the user\'s cross-device memory (Pro feature, Mem0-backed). Use this when the user asks to "remember this" or when the agent identifies a fact worth persisting across sessions.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleMemorySave(input, memoryDeps);
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_memory_recent', 'List the user\'s most recent memory items (Pro feature, Mem0-backed). Returns up to N items in reverse chronological order. Use this for "what did we work on yesterday" type queries.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        const env = await handleMemoryRecent(input, memoryDeps);
+        return wrapEnvelope(env);
+    });
+    // ─── Phase 2: Credential vault tools (BYOK: keys 加密存本地, 不出节点) ───
+    // Agent 装 SkillFM 后引导用户加 LLM provider 的 billing API key, 启用 Beacon 监控。
+    const vaultDeps = deps.vault ? { vault: deps.vault } : null;
+    server.tool('skillfm_save_credential', 'Save a BYOK provider API key to the local encrypted vault (AES-256-GCM, never leaves the user node). Use this when onboarding a user — ask them which LLM provider (openai/anthropic/deepseek/doubao/qwen/kimi) or asset registrar (cloudflare/namecheap/godaddy/...) they want monitored, then save the billing-only API key here. Beacon scheduler reads this vault to poll provider billing APIs every 30 minutes.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        if (!vaultDeps) {
+            return wrapEnvelope({
+                ok: false,
+                error: { code: 'VAULT.NOT_CONFIGURED', message: 'Local vault not available in this MCP transport.', retryable: false },
+            });
+        }
+        const env = await handleSaveCredential(input, vaultDeps);
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_get_credential', 'Check whether a credential exists in the vault for a given provider. Returns { has_key: bool } — does NOT return the key value (security). Use this to decide if the user needs to add a key for a particular provider.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        if (!vaultDeps) {
+            return wrapEnvelope({
+                ok: false,
+                error: { code: 'VAULT.NOT_CONFIGURED', message: 'Local vault not available in this MCP transport.', retryable: false },
+            });
+        }
+        const env = await handleGetCredential(input, vaultDeps);
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_list_credentials', 'List the provider names currently in the local vault. Does NOT return key values. Use this at session start to know which providers Beacon is already monitoring vs which ones to ask the user to add.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        if (!vaultDeps) {
+            return wrapEnvelope({
+                ok: false,
+                error: { code: 'VAULT.NOT_CONFIGURED', message: 'Local vault not available in this MCP transport.', retryable: false },
+            });
+        }
+        const env = await handleListCredentials(input, vaultDeps);
+        return wrapEnvelope(env);
+    });
+    server.tool('skillfm_remove_credential', 'Remove a provider credential from the vault (e.g. user revoked the key, no longer wants Beacon to monitor that provider). Returns { removed: bool, provider }.', PASSTHROUGH_SCHEMA.shape, async (input) => {
+        if (!vaultDeps) {
+            return wrapEnvelope({
+                ok: false,
+                error: { code: 'VAULT.NOT_CONFIGURED', message: 'Local vault not available in this MCP transport.', retryable: false },
+            });
+        }
+        const env = await handleRemoveCredential(input, vaultDeps);
+        return wrapEnvelope(env);
+    });
+}
+// ============================================================================
+// Placeholder tools — names reserved by contract but Phase 0 = NOT_IMPLEMENTED
+// ============================================================================
+const KEY_TOOL_NAMES = new Set([
+    'skillfm_check_usage',
+    'skillfm_suggest_route',
+    'skillfm_check_expiry',
+    'skillfm_avatar_market',
+    'skillfm_get_monthly_picks',
+    'skillfm_record_acceptance',
+    'skillfm_record_rejection',
+    'skillfm_user_preferences',
+    // Phase 2: vault credential tools (real handlers, not placeholders)
+    'skillfm_save_credential',
+    'skillfm_get_credential',
+    'skillfm_list_credentials',
+    'skillfm_remove_credential',
+]);
+function registerPlaceholderTools(server) {
+    const allNames = Object.values(SKILLFM_TOOL_NAMES).flat();
+    for (const name of allNames) {
+        if (KEY_TOOL_NAMES.has(name))
+            continue;
+        const handler = makePlaceholderHandler(name);
+        server.tool(name, `[Phase 0 placeholder] ${name} ships in Week 5. Calling this returns SKILLFM.TOOL.NOT_IMPLEMENTED.`, PASSTHROUGH_SCHEMA.shape, async (input) => {
+            const env = await handler(input);
+            return wrapEnvelope(env);
+        });
+    }
+}
+/**
+ * Register every Phase 0 beacon MCP tool. Called once by src/index.ts on
+ * server bootstrap.
+ */
+export function registerAllTools(server, deps) {
+    registerKeyTools(server, deps);
+    registerPlaceholderTools(server);
+}
+/** For tests / sanity checks. Not part of the public package surface. */
+export function _listAllRegisteredToolNames() {
+    return Object.values(SKILLFM_TOOL_NAMES).flat();
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/index.js.map

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

package/dist/mcp/tools/memory-recent.d.ts

@@ -0,0 +1,17 @@
+import type { SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { MemoryToolsDeps } from './memory-search.js';
+interface MemoryRecentInput {
+    limit?: number;
+}
+interface MemoryRecentOutput {
+    items: Array<{
+        id: string;
+        text: string;
+        created_at: string;
+        metadata: Record<string, unknown>;
+    }>;
+    count: number;
+}
+export declare function handleMemoryRecent(input: MemoryRecentInput, deps: MemoryToolsDeps): Promise<SkillFmToolResult<MemoryRecentOutput>>;
+export {};
+//# sourceMappingURL=memory-recent.d.ts.map

package/dist/mcp/tools/memory-recent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recent.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/memory-recent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,iBAAiB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAsChD"}

package/dist/mcp/tools/memory-recent.js

@@ -0,0 +1,46 @@
+// sdk/skillfm-local/src/mcp/tools/memory-recent.ts
+//
+// MCP tool: skillfm_memory_recent (Day 6 B1, Pro-only)
+// 列最近 N 条记忆 (无相关性, 仅时序)
+import { MemoryError } from '../../memory/index.js';
+export async function handleMemoryRecent(input, deps) {
+    if (!deps.isProTier) {
+        return {
+            ok: false,
+            error: { code: 'AUTH.PRO_REQUIRED', message: 'Memory is a Pro feature.', retryable: false },
+        };
+    }
+    if (!deps.memory) {
+        return {
+            ok: false,
+            error: { code: 'MEMORY.NOT_CONFIGURED', message: 'Mem0 backend not configured.', retryable: false },
+        };
+    }
+    try {
+        const items = await deps.memory.recent(Math.min(input.limit ?? 20, 100));
+        return {
+            ok: true,
+            data: {
+                items: items.map((i) => ({
+                    id: i.id,
+                    text: i.text,
+                    created_at: i.created_at,
+                    metadata: i.metadata,
+                })),
+                count: items.length,
+            },
+        };
+    }
+    catch (e) {
+        const code = e instanceof MemoryError ? e.code : 'MEMORY.UNKNOWN';
+        return {
+            ok: false,
+            error: {
+                code,
+                message: e instanceof Error ? e.message : String(e),
+                retryable: code === 'MEMORY_BACKEND_UNREACHABLE',
+            },
+        };
+    }
+}
+//# sourceMappingURL=memory-recent.js.map

package/dist/mcp/tools/memory-recent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recent.js","sourceRoot":"","sources":["../../../src/mcp/tools/memory-recent.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,uDAAuD;AACvD,wBAAwB;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAiBpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,IAAqB;IAErB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,KAAK,EAAE;SAC5F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,8BAA8B,EAAE,SAAS,EAAE,KAAK,EAAE;SACpG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QACzE,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,QAAQ,EAAE,CAAC,CAAC,QAAmC;iBAChD,CAAC,CAAC;gBACH,KAAK,EAAE,KAAK,CAAC,MAAM;aACpB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI;gBACJ,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnD,SAAS,EAAE,IAAI,KAAK,4BAA4B;aACjD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/tools/memory-save.d.ts

@@ -0,0 +1,15 @@
+import type { SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { MemoryToolsDeps } from './memory-search.js';
+interface MemorySaveInput {
+    text: string;
+    source?: 'claude-code' | 'cursor' | 'openclaw' | 'manual';
+    user_tags?: string[];
+    privacy?: 'private' | 'shared';
+}
+interface MemorySaveOutput {
+    id: string;
+    saved_at: string;
+}
+export declare function handleMemorySave(input: MemorySaveInput, deps: MemoryToolsDeps): Promise<SkillFmToolResult<MemorySaveOutput>>;
+export {};
+//# sourceMappingURL=memory-save.d.ts.map

package/dist/mcp/tools/memory-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-save.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/memory-save.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CA6C9C"}

package/dist/mcp/tools/memory-save.js

@@ -0,0 +1,53 @@
+// sdk/skillfm-local/src/mcp/tools/memory-save.ts
+//
+// MCP tool: skillfm_memory_save (Day 6 B1, Pro-only)
+// 让 agent 显式保存当前对话片段到用户跨设备记忆
+import { MemoryError } from '../../memory/index.js';
+export async function handleMemorySave(input, deps) {
+    if (!deps.isProTier) {
+        return {
+            ok: false,
+            error: {
+                code: 'AUTH.PRO_REQUIRED',
+                message: 'Memory save is a Pro feature.',
+                retryable: false,
+            },
+        };
+    }
+    if (!deps.memory) {
+        return {
+            ok: false,
+            error: {
+                code: 'MEMORY.NOT_CONFIGURED',
+                message: 'Mem0 backend not configured.',
+                retryable: false,
+            },
+        };
+    }
+    if (!input.text || input.text.length === 0) {
+        return {
+            ok: false,
+            error: { code: 'INPUT.INVALID', message: 'text required', retryable: false },
+        };
+    }
+    try {
+        const id = await deps.memory.put(input.text, {
+            source: input.source ?? 'manual',
+            user_tags: input.user_tags,
+            privacy: input.privacy ?? 'private',
+        });
+        return { ok: true, data: { id, saved_at: new Date().toISOString() } };
+    }
+    catch (e) {
+        const code = e instanceof MemoryError ? e.code : 'MEMORY.UNKNOWN';
+        return {
+            ok: false,
+            error: {
+                code,
+                message: e instanceof Error ? e.message : String(e),
+                retryable: code === 'MEMORY_BACKEND_UNREACHABLE',
+            },
+        };
+    }
+}
+//# sourceMappingURL=memory-save.js.map

package/dist/mcp/tools/memory-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-save.js","sourceRoot":"","sources":["../../../src/mcp/tools/memory-save.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,qDAAqD;AACrD,6BAA6B;AAG7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAepD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,IAAqB;IAErB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,+BAA+B;gBACxC,SAAS,EAAE,KAAK;aACjB;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,8BAA8B;gBACvC,SAAS,EAAE,KAAK;aACjB;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE;SAC7E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAC3C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;SACpC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI;gBACJ,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnD,SAAS,EAAE,IAAI,KAAK,4BAA4B;aACjD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/tools/memory-search.d.ts

@@ -0,0 +1,24 @@
+import type { SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { MemoryStore } from '../../memory/index.js';
+interface MemorySearchInput {
+    query: string;
+    k?: number;
+    min_score?: number;
+}
+interface MemorySearchOutput {
+    query: string;
+    results: Array<{
+        id: string;
+        text: string;
+        score: number;
+        created_at: string;
+        metadata: Record<string, unknown>;
+    }>;
+}
+export interface MemoryToolsDeps {
+    memory: MemoryStore | null;
+    isProTier: boolean;
+}
+export declare function handleMemorySearch(input: MemorySearchInput, deps: MemoryToolsDeps): Promise<SkillFmToolResult<MemorySearchOutput>>;
+export {};
+//# sourceMappingURL=memory-search.d.ts.map

package/dist/mcp/tools/memory-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/memory-search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAG7E,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAwDhD"}

package/dist/mcp/tools/memory-search.js

@@ -0,0 +1,64 @@
+// sdk/skillfm-local/src/mcp/tools/memory-search.ts
+//
+// MCP tool: skillfm_memory_search (Day 6 B1, Pro-only)
+// 调 Mem0Client 检索用户跨 session/设备的记忆 — 让 agent "记住"前几次对话学到什么
+import { MemoryError } from '../../memory/index.js';
+export async function handleMemorySearch(input, deps) {
+    if (!deps.isProTier) {
+        return {
+            ok: false,
+            error: {
+                code: 'AUTH.PRO_REQUIRED',
+                message: 'Memory search is a Pro feature. Upgrade at https://skillfm.ai/beacon/upgrade',
+                retryable: false,
+            },
+        };
+    }
+    if (!deps.memory) {
+        return {
+            ok: false,
+            error: {
+                code: 'MEMORY.NOT_CONFIGURED',
+                message: 'Mem0 backend not configured. Run: skillfm-local memory setup',
+                retryable: false,
+            },
+        };
+    }
+    if (!input.query || input.query.length === 0) {
+        return {
+            ok: false,
+            error: { code: 'INPUT.INVALID', message: 'query required', retryable: false },
+        };
+    }
+    try {
+        const r = await deps.memory.search(input.query, {
+            k: input.k ?? 5,
+            min_score: input.min_score,
+        });
+        return {
+            ok: true,
+            data: {
+                query: input.query,
+                results: r.map((sr) => ({
+                    id: sr.item.id,
+                    text: sr.item.text,
+                    score: sr.score,
+                    created_at: sr.item.created_at,
+                    metadata: sr.item.metadata,
+                })),
+            },
+        };
+    }
+    catch (e) {
+        const code = e instanceof MemoryError ? e.code : 'MEMORY.UNKNOWN';
+        return {
+            ok: false,
+            error: {
+                code,
+                message: e instanceof Error ? e.message : String(e),
+                retryable: code === 'MEMORY_BACKEND_UNREACHABLE',
+            },
+        };
+    }
+}
+//# sourceMappingURL=memory-search.js.map

package/dist/mcp/tools/memory-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-search.js","sourceRoot":"","sources":["../../../src/mcp/tools/memory-search.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,uDAAuD;AACvD,2DAA2D;AAI3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAwBpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,IAAqB;IAErB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,8EAA8E;gBACvF,SAAS,EAAE,KAAK;aACjB;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,8DAA8D;gBACvE,SAAS,EAAE,KAAK;aACjB;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE;SAC9E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,GAAyB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;YACpE,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;YACf,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACtB,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;oBACd,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;oBAClB,KAAK,EAAE,EAAE,CAAC,KAAK;oBACf,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU;oBAC9B,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAmC;iBACtD,CAAC,CAAC;aACJ;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI;gBACJ,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnD,SAAS,EAAE,IAAI,KAAK,4BAA4B;aACjD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/tools/record-acceptance.d.ts

@@ -0,0 +1,22 @@
+/**
+ * src/tools/record-acceptance.ts — handler for `skillfm_record_acceptance`.
+ *
+ * Agent calls this AFTER the user accepted a SkillFM suggestion (e.g. "yes,
+ * switch to DeepSeek for this task"). Drives the brain feedback loop that
+ * raises future acceptance probability for that user × category.
+ *
+ * Phase 0: forwards to BrainClient.postFeedback (mock returns 0.42 rate).
+ *
+ * TODO Week 5:
+ *   - Add idempotency-key (suggestionId + 'acc') — retries from MCP server
+ *     restart shouldn't double-count.
+ *   - If `realizedValue` provided, push into savings ledger.
+ *   - Emit telemetry event 'acceptance' for product analytics.
+ */
+import { type SkillFmRecordAcceptanceInput, type SkillFmRecordFeedbackOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface RecordAcceptanceDeps {
+    brain: BrainClient;
+}
+export declare function handleRecordAcceptance(input: SkillFmRecordAcceptanceInput, deps: RecordAcceptanceDeps): Promise<SkillFmToolResult<SkillFmRecordFeedbackOutput>>;
+//# sourceMappingURL=record-acceptance.d.ts.map

package/dist/mcp/tools/record-acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-acceptance.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/record-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,4BAA4B,EACnC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,iBAAiB,CAAC,2BAA2B,CAAC,CAAC,CAezD"}

package/dist/mcp/tools/record-acceptance.js

@@ -0,0 +1,33 @@
+/**
+ * src/tools/record-acceptance.ts — handler for `skillfm_record_acceptance`.
+ *
+ * Agent calls this AFTER the user accepted a SkillFM suggestion (e.g. "yes,
+ * switch to DeepSeek for this task"). Drives the brain feedback loop that
+ * raises future acceptance probability for that user × category.
+ *
+ * Phase 0: forwards to BrainClient.postFeedback (mock returns 0.42 rate).
+ *
+ * TODO Week 5:
+ *   - Add idempotency-key (suggestionId + 'acc') — retries from MCP server
+ *     restart shouldn't double-count.
+ *   - If `realizedValue` provided, push into savings ledger.
+ *   - Emit telemetry event 'acceptance' for product analytics.
+ */
+import { invalidInput } from '../errors.js';
+export async function handleRecordAcceptance(input, deps) {
+    if (typeof input.ruleId !== 'string' || input.ruleId.length === 0) {
+        return {
+            ok: false,
+            error: invalidInput('ruleId is required').toToolError(),
+        };
+    }
+    const result = await deps.brain.postFeedback('acceptance', input);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.code, message: result.message, retryable: result.retryable },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=record-acceptance.js.map

package/dist/mcp/tools/record-acceptance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-acceptance.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAmC,EACnC,IAA0B;IAE1B,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE;SACxD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;SACnF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/mcp/tools/record-rejection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * src/tools/record-rejection.ts — handler for `skillfm_record_rejection`.
+ *
+ * Agent calls this when the user dismisses a suggestion. Critical for
+ * keeping us out of "Clippy spam" territory: rejection signal feeds back
+ * into the decision engine via `acceptanceRateForCategory`.
+ *
+ * Phase 0: forwards to BrainClient.postFeedback (mock returns 0.31 rate).
+ *
+ * TODO Week 5:
+ *   - When `reason='too_pushy'` arrives 3+ times for a category, brain
+ *     should auto-disable that category in the user's prefs.
+ *   - Surface rejection trends back to brain so curators can deprecate
+ *     low-value rules.
+ *   - Emit telemetry event 'rejection' with reason for product analytics.
+ */
+import { type SkillFmRecordRejectionInput, type SkillFmRecordFeedbackOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface RecordRejectionDeps {
+    brain: BrainClient;
+}
+export declare function handleRecordRejection(input: SkillFmRecordRejectionInput, deps: RecordRejectionDeps): Promise<SkillFmToolResult<SkillFmRecordFeedbackOutput>>;
+//# sourceMappingURL=record-rejection.d.ts.map

package/dist/mcp/tools/record-rejection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-rejection.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/record-rejection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,2BAA2B,EAClC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,iBAAiB,CAAC,2BAA2B,CAAC,CAAC,CAezD"}

package/dist/mcp/tools/record-rejection.js

@@ -0,0 +1,34 @@
+/**
+ * src/tools/record-rejection.ts — handler for `skillfm_record_rejection`.
+ *
+ * Agent calls this when the user dismisses a suggestion. Critical for
+ * keeping us out of "Clippy spam" territory: rejection signal feeds back
+ * into the decision engine via `acceptanceRateForCategory`.
+ *
+ * Phase 0: forwards to BrainClient.postFeedback (mock returns 0.31 rate).
+ *
+ * TODO Week 5:
+ *   - When `reason='too_pushy'` arrives 3+ times for a category, brain
+ *     should auto-disable that category in the user's prefs.
+ *   - Surface rejection trends back to brain so curators can deprecate
+ *     low-value rules.
+ *   - Emit telemetry event 'rejection' with reason for product analytics.
+ */
+import { invalidInput } from '../errors.js';
+export async function handleRecordRejection(input, deps) {
+    if (typeof input.ruleId !== 'string' || input.ruleId.length === 0) {
+        return {
+            ok: false,
+            error: invalidInput('ruleId is required').toToolError(),
+        };
+    }
+    const result = await deps.brain.postFeedback('rejection', input);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.code, message: result.message, retryable: result.retryable },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=record-rejection.js.map

package/dist/mcp/tools/record-rejection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-rejection.js","sourceRoot":"","sources":["../../../src/mcp/tools/record-rejection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkC,EAClC,IAAyB;IAEzB,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE;SACxD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;SACnF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/mcp/tools/suggest-route.d.ts

@@ -0,0 +1,26 @@
+/**
+ * src/tools/suggest-route.ts — handler for `skillfm_suggest_route`.
+ *
+ * Returns a model-routing recommendation BEFORE the agent runs the task.
+ * Phase 0: hardcoded recommendation (DeepSeek-Chat for code_completion,
+ * Claude Opus for reasoning) — matches PRD-MCP-SKILL §6.1 demo numbers.
+ *
+ * TODO Week 5:
+ *   - Real call to brain `/v1/beacon/suggest-route` (LLM-as-router
+ *     evaluates task vs. provider catalog).
+ *   - Plug provider-side cost tables (refresh nightly via brain).
+ *   - `qualityVsCurrent` should come from a real benchmark suite, not a
+ *     hardcoded enum.
+ *   - Frequency-limit + decision-engine wiring — currently bypass-call.
+ *   - Honor `currentModel` input (skip suggestion if user is already on the
+ *     cheapest viable option).
+ *   - Quality-gate: `qualityRequirement='high'` should never recommend
+ *     `significant_drop`.
+ */
+import { type SkillFmSuggestRouteInput, type SkillFmSuggestRouteOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface SuggestRouteDeps {
+    brain: BrainClient;
+}
+export declare function handleSuggestRoute(input: SkillFmSuggestRouteInput, _deps: SuggestRouteDeps): Promise<SkillFmToolResult<SkillFmSuggestRouteOutput>>;
+//# sourceMappingURL=suggest-route.d.ts.map

package/dist/mcp/tools/suggest-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-route.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/suggest-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EAEvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAC;CACpB;AAUD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAAC,CA6BvD"}