@skillfm/local 2.6.3 → 2.7.0

package/dist/mcp/tools/_placeholder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * src/tools/_placeholder.ts — Stub handler for the 25+ Phase 0 placeholder tools.
+ *
+ * The beacon-mcp-tools-v1 contract reserves 30+ tool names but only writes
+ * full input/output schemas for 8 of them (5 key + 3 feedback/prefs). Until
+ * subagent-A finishes the schema sweep in Week 5, every reserved name still
+ * has to be a registered MCP tool — otherwise agents discover only 8 tools
+ * and can't reason about the full surface.
+ *
+ * This handler returns SkillFmToolError code = TOOL_NOT_IMPLEMENTED.
+ *
+ * TODO Week 5:
+ *   - Delete this file once every tool name has its own typed handler.
+ *   - Until then, keep the userHint copy short — agents may forward it
+ *     verbatim to end users.
+ */
+import { type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+/**
+ * Generic placeholder. The MCP server registers it for every reserved tool
+ * name, capturing `toolName` in a closure so the error message identifies
+ * which tool the agent tried to call.
+ */
+export declare function makePlaceholderHandler(toolName: string): (input: Record<string, unknown>) => Promise<SkillFmToolResult<Record<string, unknown>>>;
+//# sourceMappingURL=_placeholder.d.ts.map

package/dist/mcp/tools/_placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_placeholder.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/_placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAGvF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GACf,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAKzF"}

package/dist/mcp/tools/_placeholder.js

@@ -0,0 +1,29 @@
+/**
+ * src/tools/_placeholder.ts — Stub handler for the 25+ Phase 0 placeholder tools.
+ *
+ * The beacon-mcp-tools-v1 contract reserves 30+ tool names but only writes
+ * full input/output schemas for 8 of them (5 key + 3 feedback/prefs). Until
+ * subagent-A finishes the schema sweep in Week 5, every reserved name still
+ * has to be a registered MCP tool — otherwise agents discover only 8 tools
+ * and can't reason about the full surface.
+ *
+ * This handler returns SkillFmToolError code = TOOL_NOT_IMPLEMENTED.
+ *
+ * TODO Week 5:
+ *   - Delete this file once every tool name has its own typed handler.
+ *   - Until then, keep the userHint copy short — agents may forward it
+ *     verbatim to end users.
+ */
+import { notImplemented } from '../errors.js';
+/**
+ * Generic placeholder. The MCP server registers it for every reserved tool
+ * name, capturing `toolName` in a closure so the error message identifies
+ * which tool the agent tried to call.
+ */
+export function makePlaceholderHandler(toolName) {
+    return async (_input) => {
+        const err = notImplemented(toolName);
+        return { ok: false, error: err.toToolError() };
+    };
+}
+//# sourceMappingURL=_placeholder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_placeholder.js","sourceRoot":"","sources":["../../../src/mcp/tools/_placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB;IAEhB,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/avatar-market.d.ts

@@ -0,0 +1,22 @@
+/**
+ * src/tools/avatar-market.ts — handler for `skillfm_avatar_market`.
+ *
+ * Recommend SkillFM "avatars" (e.g. xianyu-avatar-adult) based on a detected
+ * user intent. Phase 0: passes through the empty mock fixture.
+ *
+ * TODO Week 5:
+ *   - Real intent classification on the brain (LLM call) → marketplace match.
+ *   - Plug `realCase` field with live "Eric ¥15 first sale" once xianyu Day 0
+ *     KPI lands.
+ *   - Add inline upsell: if user is Free, only return top-1 match + Pro hint
+ *     for unlocking the full 5.
+ *   - i18n market filter: cn agents see CNY pricing + zh strings primary.
+ *   - Cache hot intents (e.g. "make money on the side") for 1h to cut LLM cost.
+ */
+import { type SkillFmAvatarMarketInput, type SkillFmAvatarMarketOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface AvatarMarketDeps {
+    brain: BrainClient;
+}
+export declare function handleAvatarMarket(input: SkillFmAvatarMarketInput, deps: AvatarMarketDeps): Promise<SkillFmToolResult<SkillFmAvatarMarketOutput>>;
+//# sourceMappingURL=avatar-market.d.ts.map

package/dist/mcp/tools/avatar-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-market.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/avatar-market.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,wBAAwB,EAC/B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAAC,CAevD"}

package/dist/mcp/tools/avatar-market.js

@@ -0,0 +1,33 @@
+/**
+ * src/tools/avatar-market.ts — handler for `skillfm_avatar_market`.
+ *
+ * Recommend SkillFM "avatars" (e.g. xianyu-avatar-adult) based on a detected
+ * user intent. Phase 0: passes through the empty mock fixture.
+ *
+ * TODO Week 5:
+ *   - Real intent classification on the brain (LLM call) → marketplace match.
+ *   - Plug `realCase` field with live "Eric ¥15 first sale" once xianyu Day 0
+ *     KPI lands.
+ *   - Add inline upsell: if user is Free, only return top-1 match + Pro hint
+ *     for unlocking the full 5.
+ *   - i18n market filter: cn agents see CNY pricing + zh strings primary.
+ *   - Cache hot intents (e.g. "make money on the side") for 1h to cut LLM cost.
+ */
+import { invalidInput } from '../errors.js';
+export async function handleAvatarMarket(input, deps) {
+    if (typeof input.userIntent !== 'string' || input.userIntent.length === 0) {
+        return {
+            ok: false,
+            error: invalidInput('userIntent is required').toToolError(),
+        };
+    }
+    const result = await deps.brain.getAvatarMarket(input.userIntent);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.code, message: result.message, retryable: result.retryable },
+        };
+    }
+    return { ok: true, data: result.data, degraded: deps.brain.isDegraded() };
+}
+//# sourceMappingURL=avatar-market.js.map

package/dist/mcp/tools/avatar-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-market.js","sourceRoot":"","sources":["../../../src/mcp/tools/avatar-market.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA+B,EAC/B,IAAsB;IAEtB,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,YAAY,CAAC,wBAAwB,CAAC,CAAC,WAAW,EAAE;SAC5D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,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,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;AAC5E,CAAC"}

package/dist/mcp/tools/check-expiry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * src/tools/check-expiry.ts — handler for `skillfm_check_expiry`.
+ *
+ * Returns domain / SSL / card / API-balance expiry items within `withinDays`.
+ *
+ * Phase 0: passes through brain.getAssets mock (currently empty fixture).
+ *
+ * TODO Week 5:
+ *   - Real backend `/v1/beacon/assets` join across user-registered domains
+ *     (WHOIS), SSL (CT logs), payment cards (Stripe vault meta), API balances
+ *     (provider-specific endpoints scraped via BYOK reverse dispatch).
+ *   - Severity calculation moves to brain (consistency across users).
+ *   - Free tier filter: only return `severity >= 'critical'` (≤ 7 days).
+ *     Apply `proLockedDetails=true` to other items so agent shows a teaser.
+ *   - `actionUrl` deep-link generation (Stripe portal, registrar console).
+ */
+import { type SkillFmCheckExpiryInput, type SkillFmCheckExpiryOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface CheckExpiryDeps {
+    brain: BrainClient;
+}
+export declare function handleCheckExpiry(input: SkillFmCheckExpiryInput, deps: CheckExpiryDeps): Promise<SkillFmToolResult<SkillFmCheckExpiryOutput>>;
+//# sourceMappingURL=check-expiry.d.ts.map

package/dist/mcp/tools/check-expiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-expiry.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/check-expiry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,uBAAuB,EAC9B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,CAAC,CAWtD"}

package/dist/mcp/tools/check-expiry.js

@@ -0,0 +1,29 @@
+/**
+ * src/tools/check-expiry.ts — handler for `skillfm_check_expiry`.
+ *
+ * Returns domain / SSL / card / API-balance expiry items within `withinDays`.
+ *
+ * Phase 0: passes through brain.getAssets mock (currently empty fixture).
+ *
+ * TODO Week 5:
+ *   - Real backend `/v1/beacon/assets` join across user-registered domains
+ *     (WHOIS), SSL (CT logs), payment cards (Stripe vault meta), API balances
+ *     (provider-specific endpoints scraped via BYOK reverse dispatch).
+ *   - Severity calculation moves to brain (consistency across users).
+ *   - Free tier filter: only return `severity >= 'critical'` (≤ 7 days).
+ *     Apply `proLockedDetails=true` to other items so agent shows a teaser.
+ *   - `actionUrl` deep-link generation (Stripe portal, registrar console).
+ */
+export async function handleCheckExpiry(input, deps) {
+    const within = input.withinDays ?? 30;
+    const cat = input.category ?? 'all';
+    const result = await deps.brain.getAssets(within, cat === 'all' ? undefined : cat);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.code, message: result.message, retryable: result.retryable },
+        };
+    }
+    return { ok: true, data: result.data, degraded: deps.brain.isDegraded() };
+}
+//# sourceMappingURL=check-expiry.js.map

package/dist/mcp/tools/check-expiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-expiry.js","sourceRoot":"","sources":["../../../src/mcp/tools/check-expiry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAA8B,EAC9B,IAAqB;IAErB,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,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,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;AAC5E,CAAC"}

package/dist/mcp/tools/check-usage.d.ts

@@ -0,0 +1,25 @@
+/**
+ * src/tools/check-usage.ts — handler for `skillfm_check_usage`.
+ *
+ * Phase 0: returns the mock fixture from BrainClient.getUsage() (matches
+ * ACCEPTANCE-SCENARIO §1.1 A2 — $487 / month, $312 already saved).
+ *
+ * TODO Week 5:
+ *   - Pull real usage from each provider via BYOK proxy (LlmTask reverse
+ *     dispatch — agent runs the SDK calls on user machine, MCP only
+ *     aggregates). Never read API keys here.
+ *   - Honor `period` input ('24h' / '7d' / '30d') — Phase 0 always returns
+ *     monthly.
+ *   - Apply Pro gating: Free users get totalSpent + savings only;
+ *     `byPlatform` breakdown locked behind ProLockedFeature.
+ *   - Per-platform `tokens` and `calls` should come from ccusage / Mem0
+ *     integrations, not from brain.
+ *   - Add cache: if last fetch < 30s ago, return cached blob.
+ */
+import { type SkillFmCheckUsageInput, type SkillFmCheckUsageOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface CheckUsageDeps {
+    brain: BrainClient;
+}
+export declare function handleCheckUsage(_input: SkillFmCheckUsageInput, deps: CheckUsageDeps): Promise<SkillFmToolResult<SkillFmCheckUsageOutput>>;
+//# sourceMappingURL=check-usage.d.ts.map

package/dist/mcp/tools/check-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-usage.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/check-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAarD"}

package/dist/mcp/tools/check-usage.js

@@ -0,0 +1,33 @@
+/**
+ * src/tools/check-usage.ts — handler for `skillfm_check_usage`.
+ *
+ * Phase 0: returns the mock fixture from BrainClient.getUsage() (matches
+ * ACCEPTANCE-SCENARIO §1.1 A2 — $487 / month, $312 already saved).
+ *
+ * TODO Week 5:
+ *   - Pull real usage from each provider via BYOK proxy (LlmTask reverse
+ *     dispatch — agent runs the SDK calls on user machine, MCP only
+ *     aggregates). Never read API keys here.
+ *   - Honor `period` input ('24h' / '7d' / '30d') — Phase 0 always returns
+ *     monthly.
+ *   - Apply Pro gating: Free users get totalSpent + savings only;
+ *     `byPlatform` breakdown locked behind ProLockedFeature.
+ *   - Per-platform `tokens` and `calls` should come from ccusage / Mem0
+ *     integrations, not from brain.
+ *   - Add cache: if last fetch < 30s ago, return cached blob.
+ */
+export async function handleCheckUsage(_input, deps) {
+    const result = await deps.brain.getUsage();
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: {
+                code: result.code,
+                message: result.message,
+                retryable: result.retryable,
+            },
+        };
+    }
+    return { ok: true, data: result.data, degraded: deps.brain.isDegraded() };
+}
+//# sourceMappingURL=check-usage.js.map

package/dist/mcp/tools/check-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-usage.js","sourceRoot":"","sources":["../../../src/mcp/tools/check-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B,EAC9B,IAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;AAC5E,CAAC"}

package/dist/mcp/tools/get-monthly-picks.d.ts

@@ -0,0 +1,25 @@
+/**
+ * src/tools/get-monthly-picks.ts — handler for `skillfm_get_monthly_picks` (Pro).
+ *
+ * Phase 0:
+ *   - Free users → ok=false + AUTH.PRO_REQUIRED (per contract §7 comment).
+ *   - Pro users → returns the empty mock fixture.
+ *
+ * TODO Week 5:
+ *   - Real Pro-tier check from agent_token claims (currently we treat
+ *     "no token" → degraded, "with token" → assume Pro; need real tier).
+ *   - Personalized picks: pass user usage profile into brain rule eval.
+ *   - Localize curationTheme strings per agent locale.
+ *   - Cache picks for 24h — same pick set across MCP server restarts.
+ *   - Pre-render install commands per agent (claude_code / cursor / openclaw)
+ *     using detected agent harness (skillfm-local already does harness probe).
+ */
+import { type SkillFmGetMonthlyPicksInput, type SkillFmGetMonthlyPicksOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface GetMonthlyPicksDeps {
+    brain: BrainClient;
+    /** Phase 0 stub — Week 5 will read from agent_token claims */
+    isProTier: boolean;
+}
+export declare function handleGetMonthlyPicks(input: SkillFmGetMonthlyPicksInput, deps: GetMonthlyPicksDeps): Promise<SkillFmToolResult<SkillFmGetMonthlyPicksOutput>>;
+//# sourceMappingURL=get-monthly-picks.d.ts.map

package/dist/mcp/tools/get-monthly-picks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-monthly-picks.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-monthly-picks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,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;IACnB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,2BAA2B,EAClC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAC,CAiB1D"}

package/dist/mcp/tools/get-monthly-picks.js

@@ -0,0 +1,35 @@
+/**
+ * src/tools/get-monthly-picks.ts — handler for `skillfm_get_monthly_picks` (Pro).
+ *
+ * Phase 0:
+ *   - Free users → ok=false + AUTH.PRO_REQUIRED (per contract §7 comment).
+ *   - Pro users → returns the empty mock fixture.
+ *
+ * TODO Week 5:
+ *   - Real Pro-tier check from agent_token claims (currently we treat
+ *     "no token" → degraded, "with token" → assume Pro; need real tier).
+ *   - Personalized picks: pass user usage profile into brain rule eval.
+ *   - Localize curationTheme strings per agent locale.
+ *   - Cache picks for 24h — same pick set across MCP server restarts.
+ *   - Pre-render install commands per agent (claude_code / cursor / openclaw)
+ *     using detected agent harness (skillfm-local already does harness probe).
+ */
+import { proRequired } from '../errors.js';
+export async function handleGetMonthlyPicks(input, deps) {
+    if (!deps.isProTier) {
+        return {
+            ok: false,
+            error: proRequired('skillfm_get_monthly_picks').toToolError(),
+        };
+    }
+    const personalized = input.forUserContext ?? false;
+    const result = await deps.brain.getMonthlyPicks(personalized);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.code, message: result.message, retryable: result.retryable },
+        };
+    }
+    return { ok: true, data: result.data };
+}
+//# sourceMappingURL=get-monthly-picks.js.map

package/dist/mcp/tools/get-monthly-picks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-monthly-picks.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-monthly-picks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ3C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkC,EAClC,IAAyB;IAEzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,WAAW,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAC9D,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/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BrainClient } from '../brain-client.js';
+import type { MemoryStore } from '../../memory/index.js';
+export interface ToolRegistryDeps {
+    brain: BrainClient;
+    /** Phase 0: derived from `agentToken !== null`; Week 5: real claim. */
+    isProTier: boolean;
+    /** Mem0 self-host client (Day 6 B1, Pro-only); null = 未配置, MCP tools 返 NOT_CONFIGURED */
+    memory?: MemoryStore | null;
+}
+/**
+ * Register every Phase 0 beacon MCP tool. Called once by src/index.ts on
+ * server bootstrap.
+ */
+export declare function registerAllTools(server: McpServer, deps: ToolRegistryDeps): void;
+/** For tests / sanity checks. Not part of the public package surface. */
+export declare function _listAllRegisteredToolNames(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AActD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AA+KD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAGhF;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD"}

package/dist/mcp/tools/index.js

@@ -0,0 +1,139 @@
+/**
+ * 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';
+// ============================================================================
+// 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);
+    });
+}
+// ============================================================================
+// 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',
+]);
+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"}