@skillfm/local 2.6.4 → 2.7.0

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"}

package/dist/mcp/tools/suggest-route.js

@@ -0,0 +1,56 @@
+/**
+ * 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 { invalidInput } from '../errors.js';
+const PHASE_0_DEFAULT_RECOMMENDATION = {
+    model: 'deepseek-chat-v4',
+    provider: 'deepseek',
+    estCost: 0.018,
+    estLatencyMs: 1_400,
+    qualityVsCurrent: 'slight_drop',
+};
+export async function handleSuggestRoute(input, _deps) {
+    if (typeof input.task !== 'string' || input.task.length === 0) {
+        return {
+            ok: false,
+            error: invalidInput('task is required and must be a non-empty string').toToolError(),
+        };
+    }
+    // Phase 0 hardcoded — Week 5 calls brain.fetchRule + provider catalog
+    const output = {
+        recommended: PHASE_0_DEFAULT_RECOMMENDATION,
+        alternatives: [
+            {
+                model: 'qwen3-coder',
+                provider: 'qwen',
+                estCost: 0.012,
+                pros: ['cheapest', 'fast'],
+                cons: ['lower quality on long context'],
+            },
+        ],
+        estSavings: { perCall: 0.064, monthlyIfAlwaysSwitched: 41 },
+        reasoning: {
+            en: 'For code_completion tasks, DeepSeek-Chat-V4 delivers ~95% Claude Opus quality at 8% the cost.',
+            zh: '对于代码补全类任务,DeepSeek-Chat-V4 能以 8% 的成本达到 Claude Opus ~95% 的质量。',
+        },
+        shouldSuggestToUser: true,
+    };
+    return { ok: true, data: output };
+}
+//# sourceMappingURL=suggest-route.js.map

package/dist/mcp/tools/suggest-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-route.js","sourceRoot":"","sources":["../../../src/mcp/tools/suggest-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,8BAA8B,GAAqB;IACvD,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,KAAK;IACd,YAAY,EAAE,KAAK;IACnB,gBAAgB,EAAE,aAAa;CAChC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA+B,EAC/B,KAAuB;IAEvB,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,YAAY,CAAC,iDAAiD,CAAC,CAAC,WAAW,EAAE;SACrF,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,MAAM,MAAM,GAA8B;QACxC,WAAW,EAAE,8BAA8B;QAC3C,YAAY,EAAE;YACZ;gBACE,KAAK,EAAE,aAAa;gBACpB,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;gBAC1B,IAAI,EAAE,CAAC,+BAA+B,CAAC;aACxC;SACF;QACD,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,EAAE;QAC3D,SAAS,EAAE;YACT,EAAE,EAAE,+FAA+F;YACnG,EAAE,EAAE,8DAA8D;SACnE;QACD,mBAAmB,EAAE,IAAI;KAC1B,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/dist/mcp/tools/user-preferences.d.ts

@@ -0,0 +1,22 @@
+/**
+ * src/tools/user-preferences.ts — handler for `skillfm_user_preferences`.
+ *
+ * Get / set client-side UserPreferences (frequency limits, quiet hours,
+ * disabled categories). Persisted to ~/.skillfm/beacon-mcp/user-prefs.json.
+ *
+ * Phase 0: fully working (no brain dependency for read; brain push is
+ * best-effort fire-and-forget).
+ *
+ * TODO Week 5:
+ *   - Validation: maxPerSession 1-20, maxPerDay 1-100, timezone is IANA.
+ *   - When prefs change, also push to brain so other devices (mobile app
+ *     in Phase 2) sync.
+ *   - Atomic write via .tmp + rename to survive MCP server kill.
+ */
+import { type SkillFmUserPreferencesInput, type SkillFmUserPreferencesOutput, type SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
+import type { BrainClient } from '../brain-client.js';
+export interface UserPreferencesDeps {
+    brain: BrainClient;
+}
+export declare function handleUserPreferences(input: SkillFmUserPreferencesInput, deps: UserPreferencesDeps): Promise<SkillFmToolResult<SkillFmUserPreferencesOutput>>;
+//# sourceMappingURL=user-preferences.d.ts.map

package/dist/mcp/tools/user-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-preferences.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/user-preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EAEvB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;CACpB;AAkBD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,2BAA2B,EAClC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAC,CA8B1D"}

package/dist/mcp/tools/user-preferences.js

@@ -0,0 +1,63 @@
+/**
+ * src/tools/user-preferences.ts — handler for `skillfm_user_preferences`.
+ *
+ * Get / set client-side UserPreferences (frequency limits, quiet hours,
+ * disabled categories). Persisted to ~/.skillfm/beacon-mcp/user-prefs.json.
+ *
+ * Phase 0: fully working (no brain dependency for read; brain push is
+ * best-effort fire-and-forget).
+ *
+ * TODO Week 5:
+ *   - Validation: maxPerSession 1-20, maxPerDay 1-100, timezone is IANA.
+ *   - When prefs change, also push to brain so other devices (mobile app
+ *     in Phase 2) sync.
+ *   - Atomic write via .tmp + rename to survive MCP server kill.
+ */
+import { loadPrefs, savePrefs, DEFAULT_USER_PREFERENCES } from '../cache.js';
+import { invalidInput } from '../errors.js';
+function mergePrefs(current, patch) {
+    return {
+        disabledCategories: patch.disabledCategories ?? current.disabledCategories,
+        maxPerSession: patch.maxPerSession ?? current.maxPerSession,
+        maxPerDay: patch.maxPerDay ?? current.maxPerDay,
+        quietHours: patch.quietHours
+            ? {
+                enabled: patch.quietHours.enabled ?? current.quietHours.enabled,
+                start: patch.quietHours.start ?? current.quietHours.start,
+                end: patch.quietHours.end ?? current.quietHours.end,
+                timezone: patch.quietHours.timezone ?? current.quietHours.timezone,
+            }
+            : current.quietHours,
+    };
+}
+export async function handleUserPreferences(input, deps) {
+    if (input.action === 'get') {
+        const prefs = loadPrefs();
+        return { ok: true, data: prefs };
+    }
+    if (input.action === 'set') {
+        const current = loadPrefs() ?? DEFAULT_USER_PREFERENCES;
+        const next = mergePrefs(current, input.preferences);
+        try {
+            savePrefs(next);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: {
+                    code: 'SKILLFM.CACHE.WRITE_FAILED',
+                    message: `failed to persist prefs: ${err.message}`,
+                    retryable: false,
+                },
+            };
+        }
+        // Best-effort cloud sync (don't block on failure)
+        void deps.brain.putPreferences(next);
+        return { ok: true, data: next };
+    }
+    return {
+        ok: false,
+        error: invalidInput('action must be "get" or "set"').toToolError(),
+    };
+}
+//# sourceMappingURL=user-preferences.js.map

package/dist/mcp/tools/user-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-preferences.js","sourceRoot":"","sources":["../../../src/mcp/tools/user-preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,SAAS,UAAU,CAAC,OAAwB,EAAE,KAA+B;IAC3E,OAAO;QACL,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,OAAO,CAAC,kBAAkB;QAC1E,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa;QAC3D,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS;QAC/C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC1B,CAAC,CAAC;gBACE,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO;gBAC/D,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK;gBACzD,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG;gBACnD,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ;aACnE;YACH,CAAC,CAAC,OAAO,CAAC,UAAU;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkC,EAClC,IAAyB;IAEzB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,SAAS,EAAE,IAAI,wBAAwB,CAAC;QACxD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,4BAA4B;oBAClC,OAAO,EAAE,4BAA6B,GAAa,CAAC,OAAO,EAAE;oBAC7D,SAAS,EAAE,KAAK;iBACjB;aACF,CAAC;QACJ,CAAC;QACD,kDAAkD;QAClD,KAAK,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,YAAY,CAAC,+BAA+B,CAAC,CAAC,WAAW,EAAE;KACnE,CAAC;AACJ,CAAC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export type { MemoryId, MemoryItem, MemoryMetadata, MemorySearchResult, MemoryStore, SearchOptions, } from './types.js';
+export { MemoryError, MEMORY_ERROR_CODES } from './types.js';
+export { Mem0Client } from './mem0-client.js';
+export type { Mem0ClientConfig } from './mem0-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,4 @@
+// sdk/skillfm-local/src/memory/index.ts
+export { MemoryError, MEMORY_ERROR_CODES } from './types.js';
+export { Mem0Client } from './mem0-client.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAUxC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory/mem0-client.d.ts

@@ -0,0 +1,32 @@
+import { type MemoryStore, type MemoryId, type MemoryItem, type MemoryMetadata, type MemorySearchResult, type SearchOptions } from './types.js';
+export interface Mem0ClientConfig {
+    /** Mem0 server base URL (default: http://localhost:11000) */
+    base_url?: string;
+    /** 默认 user_id, 不传则需在每次调用 opts 里指定 */
+    default_user_id?: string;
+    /** Mem0 server API key (self-host 默认无 auth, cloud 需要) */
+    api_key?: string;
+    /** fetch 超时 ms (default 10s) */
+    timeout_ms?: number;
+}
+export declare class Mem0Client implements MemoryStore {
+    private base_url;
+    private default_user_id?;
+    private api_key?;
+    private timeout_ms;
+    constructor(cfg?: Mem0ClientConfig);
+    private headers;
+    private fetchWithTimeout;
+    private resolveUserId;
+    private toItem;
+    put(text: string, metadata?: MemoryMetadata): Promise<MemoryId>;
+    search(query: string, opts?: SearchOptions): Promise<MemorySearchResult[]>;
+    recent(limit?: number, user_id?: string): Promise<MemoryItem[]>;
+    delete(id: MemoryId): Promise<boolean>;
+    health(): Promise<{
+        ok: boolean;
+        error?: string;
+        backend: string;
+    }>;
+}
+//# sourceMappingURL=mem0-client.d.ts.map

package/dist/memory/mem0-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-client.d.ts","sourceRoot":"","sources":["../../src/memory/mem0-client.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAGnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqBD,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,GAAG,CAAC,EAAE,gBAAgB;IAOlC,OAAO,CAAC,OAAO;YASD,gBAAgB;IAe9B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,MAAM;IAUR,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6B/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA4B1E,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAc/D,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtC,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAmB1E"}