@skillfm/local 2.6.4 → 2.7.1

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

package/dist/memory/mem0-client.js

@@ -0,0 +1,161 @@
+// sdk/skillfm-local/src/memory/mem0-client.ts
+//
+// Mem0 self-host REST client (Day 5 B3)
+// 默认 endpoint: http://localhost:11000 (用户跑 `docker run -p 11000:8000 mem0ai/mem0` 启)
+// Doc: https://docs.mem0.ai/api-reference (自托管时 endpoint 跟 cloud 一致, 仅 baseUrl 不同)
+//
+// REST API:
+//   POST /v1/memories      — add memory
+//   GET  /v1/memories      — list memories
+//   POST /v1/search        — semantic search
+//   DELETE /v1/memories/<id>
+import { MemoryError, MEMORY_ERROR_CODES, } from './types.js';
+const DEFAULT_BASE = 'http://localhost:11000';
+const DEFAULT_TIMEOUT = 10_000;
+export class Mem0Client {
+    base_url;
+    default_user_id;
+    api_key;
+    timeout_ms;
+    constructor(cfg) {
+        this.base_url = (cfg?.base_url ?? DEFAULT_BASE).replace(/\/+$/, '');
+        this.default_user_id = cfg?.default_user_id;
+        this.api_key = cfg?.api_key;
+        this.timeout_ms = cfg?.timeout_ms ?? DEFAULT_TIMEOUT;
+    }
+    headers(extra) {
+        const h = {
+            'content-type': 'application/json',
+            ...extra,
+        };
+        if (this.api_key)
+            h['authorization'] = `Token ${this.api_key}`;
+        return h;
+    }
+    async fetchWithTimeout(url, init) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), this.timeout_ms);
+        try {
+            return await fetch(url, { ...init, signal: ctrl.signal });
+        }
+        catch (e) {
+            throw new MemoryError(MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, `Mem0 backend ${this.base_url}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        finally {
+            clearTimeout(t);
+        }
+    }
+    resolveUserId(opts) {
+        const uid = opts?.user_id ?? this.default_user_id;
+        if (!uid) {
+            throw new MemoryError(MEMORY_ERROR_CODES.INVALID_INPUT, 'user_id required (set default_user_id in config or pass per-call)');
+        }
+        return uid;
+    }
+    toItem(raw) {
+        return {
+            id: raw.id,
+            text: raw.memory ?? raw.text ?? '',
+            metadata: (raw.metadata ?? {}),
+            created_at: raw.created_at ?? new Date().toISOString(),
+            updated_at: raw.updated_at ?? raw.created_at ?? new Date().toISOString(),
+        };
+    }
+    async put(text, metadata) {
+        if (!text || text.length === 0) {
+            throw new MemoryError(MEMORY_ERROR_CODES.INVALID_INPUT, 'text required');
+        }
+        const user_id = this.resolveUserId();
+        const body = JSON.stringify({
+            messages: [{ role: 'user', content: text }],
+            user_id,
+            metadata: metadata ?? {},
+        });
+        const r = await this.fetchWithTimeout(`${this.base_url}/v1/memories/`, {
+            method: 'POST',
+            headers: this.headers(),
+            body,
+        });
+        if (!r.ok) {
+            throw new MemoryError(r.status === 401 || r.status === 403 ? MEMORY_ERROR_CODES.AUTH_FAILED : MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, `Mem0 put HTTP ${r.status}`);
+        }
+        const data = (await r.json());
+        const result = data.result ?? data.results?.[0];
+        if (!result?.id) {
+            throw new MemoryError(MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, 'Mem0 put: no id in response');
+        }
+        return result.id;
+    }
+    async search(query, opts) {
+        if (!query || query.length === 0) {
+            throw new MemoryError(MEMORY_ERROR_CODES.INVALID_INPUT, 'query required');
+        }
+        const user_id = this.resolveUserId(opts);
+        const body = JSON.stringify({
+            query,
+            user_id,
+            limit: opts?.k ?? 5,
+        });
+        const r = await this.fetchWithTimeout(`${this.base_url}/v1/memories/search/`, {
+            method: 'POST',
+            headers: this.headers(),
+            body,
+        });
+        if (!r.ok) {
+            throw new MemoryError(MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, `Mem0 search HTTP ${r.status}`);
+        }
+        const data = (await r.json());
+        const results = data.results ?? [];
+        return results
+            .map((raw) => ({
+            item: this.toItem(raw),
+            score: raw.score ?? 0,
+        }))
+            .filter((sr) => sr.score >= (opts?.min_score ?? 0));
+    }
+    async recent(limit, user_id) {
+        const uid = this.resolveUserId({ user_id });
+        const params = new URLSearchParams({ user_id: uid, limit: String(limit ?? 20) });
+        const r = await this.fetchWithTimeout(`${this.base_url}/v1/memories/?${params}`, {
+            method: 'GET',
+            headers: this.headers(),
+        });
+        if (!r.ok) {
+            throw new MemoryError(MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, `Mem0 list HTTP ${r.status}`);
+        }
+        const data = (await r.json());
+        return (data.results ?? []).map((raw) => this.toItem(raw));
+    }
+    async delete(id) {
+        const r = await this.fetchWithTimeout(`${this.base_url}/v1/memories/${encodeURIComponent(id)}/`, {
+            method: 'DELETE',
+            headers: this.headers(),
+        });
+        if (r.status === 404)
+            return false;
+        if (!r.ok)
+            throw new MemoryError(MEMORY_ERROR_CODES.BACKEND_UNREACHABLE, `Mem0 delete HTTP ${r.status}`);
+        return true;
+    }
+    async health() {
+        try {
+            // Mem0 没有专门 /health, 用 list 0 条做轻量 ping
+            const r = await this.fetchWithTimeout(`${this.base_url}/v1/memories/?user_id=__health__&limit=1`, {
+                method: 'GET',
+                headers: this.headers(),
+            });
+            if (r.ok || r.status === 404) {
+                return { ok: true, backend: `mem0:${this.base_url}` };
+            }
+            return { ok: false, error: `HTTP ${r.status}`, backend: `mem0:${this.base_url}` };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                error: e instanceof Error ? e.message : String(e),
+                backend: `mem0:${this.base_url}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=mem0-client.js.map

package/dist/memory/mem0-client.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,47 @@
+export type MemoryId = string;
+export interface MemoryMetadata {
+    source?: 'claude-code' | 'cursor' | 'openclaw' | 'manual';
+    session_id?: string;
+    user_tags?: string[];
+    privacy?: 'private' | 'shared';
+    [key: string]: unknown;
+}
+export interface MemoryItem {
+    id: MemoryId;
+    text: string;
+    metadata: MemoryMetadata;
+    created_at: string;
+    updated_at: string;
+}
+export interface MemorySearchResult {
+    item: MemoryItem;
+    score: number;
+}
+export interface SearchOptions {
+    k?: number;
+    min_score?: number;
+    privacy?: 'private' | 'shared' | 'all';
+    user_id?: string;
+}
+export interface MemoryStore {
+    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;
+    }>;
+}
+export declare class MemoryError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+export declare const MEMORY_ERROR_CODES: {
+    readonly BACKEND_UNREACHABLE: "MEMORY_BACKEND_UNREACHABLE";
+    readonly AUTH_FAILED: "MEMORY_AUTH_FAILED";
+    readonly NOT_FOUND: "MEMORY_NOT_FOUND";
+    readonly INVALID_INPUT: "MEMORY_INVALID_INPUT";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3E,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,qBAAa,WAAY,SAAQ,KAAK;IACjB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIjD;AAED,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC"}

package/dist/memory/types.js

@@ -0,0 +1,20 @@
+// sdk/skillfm-local/src/memory/types.ts
+//
+// Memory 模块类型 (Day 5 B3)
+// 路径 A — Mem0 self-host 薄封装 (Apache 2.0 直接用, 0 法律风险)
+// 替代 docs/prd/MEMORY-SPEC-FROM-CLAUDE-MEM.md 路径 B (clean room rewrite)
+export class MemoryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'MemoryError';
+    }
+}
+export const MEMORY_ERROR_CODES = {
+    BACKEND_UNREACHABLE: 'MEMORY_BACKEND_UNREACHABLE',
+    AUTH_FAILED: 'MEMORY_AUTH_FAILED',
+    NOT_FOUND: 'MEMORY_NOT_FOUND',
+    INVALID_INPUT: 'MEMORY_INVALID_INPUT',
+};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,yBAAyB;AACzB,qDAAqD;AACrD,uEAAuE;AAwCvE,MAAM,OAAO,WAAY,SAAQ,KAAK;IACjB;IAAnB,YAAmB,IAAY,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAAQ;QAE7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,mBAAmB,EAAE,4BAA4B;IACjD,WAAW,EAAE,oBAAoB;IACjC,SAAS,EAAE,kBAAkB;IAC7B,aAAa,EAAE,sBAAsB;CAC7B,CAAC"}

package/dist/router/catalog.d.ts

@@ -0,0 +1,4 @@
+import type { ModelSpec } from './types.js';
+export declare const MODEL_CATALOG: ModelSpec[];
+export declare function getModelSpec(id: string): ModelSpec | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/router/catalog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,aAAa,EAAE,SAAS,EA8FpC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE9D"}

package/dist/router/catalog.js

@@ -0,0 +1,103 @@
+// sdk/skillfm-local/src/router/catalog.ts
+//
+// Model 目录 (2026-04 公开价目, 仅近似)
+// Day 2 用作 router 决策的成本表
+export const MODEL_CATALOG = [
+    // Anthropic
+    {
+        id: 'claude-haiku-4-5',
+        provider: 'anthropic',
+        tier: 'cheap',
+        price_per_1m_input: 0.8,
+        price_per_1m_output: 4,
+        multimodal: true,
+        context_window: 200000,
+    },
+    {
+        id: 'claude-sonnet-4-6',
+        provider: 'anthropic',
+        tier: 'standard',
+        price_per_1m_input: 3,
+        price_per_1m_output: 15,
+        multimodal: true,
+        context_window: 200000,
+    },
+    {
+        id: 'claude-opus-4-7',
+        provider: 'anthropic',
+        tier: 'smart',
+        price_per_1m_input: 15,
+        price_per_1m_output: 75,
+        multimodal: true,
+        context_window: 200000,
+    },
+    // OpenAI
+    {
+        id: 'gpt-4o-mini',
+        provider: 'openai',
+        tier: 'cheap',
+        price_per_1m_input: 0.15,
+        price_per_1m_output: 0.6,
+        multimodal: true,
+        context_window: 128000,
+    },
+    {
+        id: 'gpt-4o',
+        provider: 'openai',
+        tier: 'standard',
+        price_per_1m_input: 2.5,
+        price_per_1m_output: 10,
+        multimodal: true,
+        context_window: 128000,
+    },
+    {
+        id: 'o1',
+        provider: 'openai',
+        tier: 'smart',
+        price_per_1m_input: 15,
+        price_per_1m_output: 60,
+        multimodal: false,
+        context_window: 200000,
+    },
+    // 国产 (cheaper baseline, 国内 BYOK)
+    {
+        id: 'deepseek-chat',
+        provider: 'deepseek',
+        tier: 'cheap',
+        price_per_1m_input: 0.14,
+        price_per_1m_output: 0.28,
+        multimodal: false,
+        context_window: 64000,
+    },
+    {
+        id: 'kimi-k2',
+        provider: 'kimi',
+        tier: 'standard',
+        price_per_1m_input: 1.2,
+        price_per_1m_output: 12,
+        multimodal: false,
+        context_window: 128000,
+    },
+    {
+        id: 'qwen-max',
+        provider: 'qwen',
+        tier: 'standard',
+        price_per_1m_input: 1.4,
+        price_per_1m_output: 5.6,
+        multimodal: true,
+        context_window: 32000,
+    },
+    {
+        id: 'doubao-pro-256k',
+        provider: 'doubao',
+        tier: 'standard',
+        price_per_1m_input: 0.7,
+        price_per_1m_output: 1.4,
+        multimodal: false,
+        context_window: 256000,
+    },
+];
+export function getModelSpec(id) {
+    return MODEL_CATALOG.find((m) => m.id === id);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/router/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/router/catalog.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,+BAA+B;AAC/B,yBAAyB;AAIzB,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,YAAY;IACZ;QACE,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,GAAG;QACvB,mBAAmB,EAAE,CAAC;QACtB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC;QACrB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM;KACvB;IACD,SAAS;IACT;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,IAAI;QACxB,mBAAmB,EAAE,GAAG;QACxB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,GAAG;QACvB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,MAAM;KACvB;IACD,iCAAiC;IACjC;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,IAAI;QACxB,mBAAmB,EAAE,IAAI;QACzB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,KAAK;KACtB;IACD;QACE,EAAE,EAAE,SAAS;QACb,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,GAAG;QACvB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,GAAG;QACvB,mBAAmB,EAAE,GAAG;QACxB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,KAAK;KACtB;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,GAAG;QACvB,mBAAmB,EAAE,GAAG;QACxB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,MAAM;KACvB;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/router/classifier.d.ts

@@ -0,0 +1,5 @@
+import type { Complexity, RouteRequest } from './types.js';
+export declare function classify(req: RouteRequest): Complexity;
+/** 从原始 message[] 估算 token 数 (粗估: 1 token ≈ 4 字符) */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=classifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/router/classifier.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY3D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAiBtD;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/router/classifier.js

@@ -0,0 +1,43 @@
+// sdk/skillfm-local/src/router/classifier.ts
+//
+// Heuristic complexity classifier (Day 2)
+// Day 3+ 接 Phi-4 onnx 本地跑 / 或 brain 端 small classifier
+//
+// 当前 heuristic 规则:
+//   - 含图片 → multimodal
+//   - 关键词 "debug" / "analyze" / "design" / "architect" / "reason" → high
+//   - 关键词 "summarize" / "translate" / "rephrase" / "extract" → low
+//   - input_tokens < 500 → low
+//   - input_tokens > 4000 → high
+//   - 其他 → medium
+const HIGH_KEYWORDS = [
+    'debug', 'analyze', 'design', 'architect', 'reason', 'plan', 'compare',
+    '推理', '设计', '架构', '调试', '分析', '规划', '比较', '复杂',
+];
+const LOW_KEYWORDS = [
+    'summarize', 'translate', 'rephrase', 'extract', 'classify',
+    '总结', '翻译', '改写', '抽取', '分类',
+];
+export function classify(req) {
+    if (req.has_image)
+        return 'multimodal';
+    const hint = (req.hint ?? '').toLowerCase();
+    for (const kw of HIGH_KEYWORDS) {
+        if (hint.includes(kw))
+            return 'high';
+    }
+    for (const kw of LOW_KEYWORDS) {
+        if (hint.includes(kw))
+            return 'low';
+    }
+    if (req.estimated_input_tokens < 500)
+        return 'low';
+    if (req.estimated_input_tokens > 4000)
+        return 'high';
+    return 'medium';
+}
+/** 从原始 message[] 估算 token 数 (粗估: 1 token ≈ 4 字符) */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=classifier.js.map

package/dist/router/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/router/classifier.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,0CAA0C;AAC1C,uDAAuD;AACvD,EAAE;AACF,mBAAmB;AACnB,uBAAuB;AACvB,yEAAyE;AACzE,mEAAmE;AACnE,+BAA+B;AAC/B,iCAAiC;AACjC,kBAAkB;AAIlB,MAAM,aAAa,GAAG;IACpB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS;IACtE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU;IAC3D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC7B,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,GAAiB;IACxC,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,YAAY,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE5C,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,CAAC,sBAAsB,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,GAAG,CAAC,sBAAsB,GAAG,IAAI;QAAE,OAAO,MAAM,CAAC;IAErD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}