@cachly-dev/mcp-server 0.10.129 → 0.10.130

package/dist/src/handlers/share.js

@@ -1,530 +1,19 @@
-import { safeJsonParse } from '../utils.js';
-import { STARTER_CORPUS, STARTER_CORPUS_SIZE } from '../starter-corpus.js';
-import { cachlyUrl } from '../cachly-url.js';
-export const SHARE_TOOL_NAMES = new Set([
-    'brain_share', 'brain_import', 'brain_share_list', 'brain_unshare', 'brain_discover',
-    'brain_seed_starter',
-]);
-async function scanAllLessons(redis, topicFilter) {
-    const keys = [];
-    const stream = redis.scanStream({ match: 'cachly:lesson:best:*', count: 200 });
-    await new Promise((res, rej) => {
-        stream.on('data', (batch) => keys.push(...batch));
-        stream.on('end', res);
-        stream.on('error', rej);
-    });
-    const lessons = [];
-    for (const key of keys.slice(0, 500)) {
-        const raw = await redis.get(key);
-        if (!raw)
-            continue;
-        const lesson = safeJsonParse(raw, null);
-        if (!lesson || !lesson.topic)
-            continue;
-        if (topicFilter && topicFilter.length > 0) {
-            const matches = topicFilter.some(f => lesson.topic.includes(f));
-            if (!matches)
-                continue;
-        }
-        // Strip fields that should not be shared (internal audit trails, etc.)
-        lessons.push({
-            topic: lesson.topic,
-            outcome: lesson.outcome,
-            ...(lesson.what_worked ? { what_worked: lesson.what_worked } : {}),
-            ...(lesson.what_failed ? { what_failed: lesson.what_failed } : {}),
-            ...(lesson.ctx ? { ctx: lesson.ctx } : {}),
-            ...(lesson.tags?.length ? { tags: lesson.tags } : {}),
-            ...(lesson.author ? { author: lesson.author } : {}),
-            ...(lesson.service ? { service: lesson.service } : {}),
-            confidence: lesson.confidence ?? 1.0,
-            ts: lesson.ts,
-        });
-    }
-    return lessons;
-}
-export async function handleShareTool(name, args, getConnection, apiFetch) {
-    switch (name) {
-        // ── brain_share ────────────────────────────────────────────────────────────
-        case 'brain_share': {
-            const { instance_id, title = 'My Brain Snapshot', description = '', topic_filter, visibility = 'unlisted', max_lessons = 100, dry_run = false, } = args;
-            if (!instance_id)
-                return '⚠️ `brain_share` requires `instance_id`.';
-            const redis = await getConnection(instance_id);
-            const topicFilter = Array.isArray(topic_filter) && topic_filter.length > 0 ? topic_filter : undefined;
-            const allLessons = await scanAllLessons(redis, topicFilter);
-            const lessons = allLessons.slice(0, max_lessons);
-            if (lessons.length === 0) {
-                return [
-                    `📤 **brain_share** — nothing to share yet`,
-                    ``,
-                    `No lessons found in Brain \`${instance_id}\`${topicFilter ? ` matching topics: ${topicFilter.join(', ')}` : ''}.`,
-                    ``,
-                    `Store lessons first with \`learn_from_attempts(topic="...", what_worked="...")\`.`,
-                ].join('\n');
-            }
-            if (dry_run) {
-                const sample = lessons.slice(0, 5).map(l => {
-                    const icon = l.outcome === 'success' ? '✅' : l.outcome === 'failure' ? '❌' : '⚠️';
-                    return `  ${icon} \`${l.topic}\` — ${(l.what_worked ?? l.what_failed ?? '').slice(0, 80)}`;
-                });
-                return [
-                    `📤 **brain_share (DRY RUN)** — would share ${lessons.length} lesson${lessons.length !== 1 ? 's' : ''}`,
-                    ``,
-                    `**Title:** ${title}`,
-                    `**Visibility:** ${visibility}`,
-                    topicFilter ? `**Topic filter:** ${topicFilter.join(', ')}` : '',
-                    ``,
-                    `**Sample lessons (first 5):**`,
-                    ...sample,
-                    lessons.length > 5 ? `  _...and ${lessons.length - 5} more_` : '',
-                    ``,
-                    `_Remove \`dry_run=true\` to create the public share._`,
-                ].filter(l => l !== '').join('\n');
-            }
-            // POST to API
-            let shareId = null;
-            let shareUrl = null;
-            try {
-                const result = await apiFetch('/api/v1/brains/share', {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ title, description, visibility, lessons }),
-                });
-                shareId = result.share_id ?? null;
-                if (shareId)
-                    shareUrl = cachlyUrl(`/brain/share/${shareId}`, 'brain-share');
-            }
-            catch (e) {
-                // API endpoint may not be live yet — store locally and return JSON
-                const err = e.message ?? '';
-                if (err.includes('404') || err.includes('not found') || err.includes('ECONNREFUSED')) {
-                    const exportJson = JSON.stringify({ title, description, visibility, lessons, exported_at: new Date().toISOString() }, null, 2);
-                    return [
-                        `📤 **brain_share** — exported ${lessons.length} lesson${lessons.length !== 1 ? 's' : ''}`,
-                        ``,
-                        `⚠️ The public share API is not yet available. Here is your portable snapshot:`,
-                        ``,
-                        `\`\`\`json`,
-                        exportJson.slice(0, 3000) + (exportJson.length > 3000 ? '\n... (truncated)' : ''),
-                        `\`\`\``,
-                        ``,
-                        `_To import this on another Brain, use \`brain_import\` with the JSON payload._`,
-                    ].join('\n');
-                }
-                return `❌ brain_share failed: ${e.message}`;
-            }
-            const sample = lessons.slice(0, 5).map(l => {
-                const icon = l.outcome === 'success' ? '✅' : l.outcome === 'failure' ? '❌' : '⚠️';
-                return `  ${icon} \`${l.topic}\``;
-            });
-            // Record provenance
-            try {
-                const prov = JSON.stringify({ share_id: shareId, title, visibility, lesson_count: lessons.length, created_at: new Date().toISOString() });
-                await redis.rpush('cachly:brain:shares', prov);
-                await redis.ltrim('cachly:brain:shares', -20, -1);
-            }
-            catch { /* non-critical */ }
-            return [
-                `📤 **brain_share** — ${lessons.length} lesson${lessons.length !== 1 ? 's' : ''} shared`,
-                ``,
-                `**Share ID:** \`${shareId}\``,
-                `**URL:**      ${shareUrl}`,
-                `**Title:**    ${title}`,
-                `**Visible:**  ${visibility}`,
-                ``,
-                `**Sample lessons:**`,
-                ...sample,
-                lessons.length > 5 ? `  _...and ${lessons.length - 5} more_` : '',
-                ``,
-                `**Anyone can import this Brain with:**`,
-                `\`brain_import(instance_id="<their-id>", share_id="${shareId}")\``,
-                ``,
-                `_To list all your shares, run \`brain_share_list\`._`,
-            ].filter(l => l !== '').join('\n');
-        }
-        // ── brain_import ───────────────────────────────────────────────────────────
-        case 'brain_import': {
-            const { instance_id, share_id, topic_prefix = '', min_confidence = 0.0, dry_run = false, overwrite = false, } = args;
-            if (!instance_id)
-                return '⚠️ `brain_import` requires `instance_id`.';
-            if (!share_id)
-                return '⚠️ `brain_import` requires `share_id`. Get one from `brain_share`.';
-            // Extract share ID from URL if passed as URL
-            const cleanShareId = share_id.replace(/^.*\/brain\/share\//, '').trim();
-            // Fetch the public share
-            let payload;
-            try {
-                payload = await apiFetch(`/api/v1/brains/share/${cleanShareId}`);
-            }
-            catch (e) {
-                const err = e.message ?? '';
-                if (err.includes('404') || err.includes('not found')) {
-                    return [
-                        `❌ **brain_import** — share not found`,
-                        ``,
-                        `Share ID \`${cleanShareId}\` does not exist or has been removed.`,
-                        ``,
-                        `Ask the Brain owner to re-run \`brain_share\` and share the new ID with you.`,
-                    ].join('\n');
-                }
-                return `❌ brain_import failed: ${e.message}`;
-            }
-            const lessons = payload.lessons ?? [];
-            if (lessons.length === 0) {
-                return `⚠️ Share \`${cleanShareId}\` exists but contains no lessons.`;
-            }
-            const redis = await getConnection(instance_id);
-            let imported = 0;
-            let skipped = 0;
-            let conflicts = 0;
-            const importLog = [];
-            for (const lesson of lessons) {
-                if ((lesson.confidence ?? 1.0) < min_confidence) {
-                    skipped++;
-                    continue;
-                }
-                const topic = topic_prefix ? `${topic_prefix}:${lesson.topic}` : lesson.topic;
-                const bestKey = `cachly:lesson:best:${topic}`;
-                // Check for existing lesson
-                if (!overwrite) {
-                    const existing = await redis.get(bestKey);
-                    if (existing) {
-                        conflicts++;
-                        continue;
-                    }
-                }
-                const lessonToStore = JSON.stringify({
-                    ...lesson,
-                    topic,
-                    imported_from: cleanShareId,
-                    imported_at: new Date().toISOString(),
-                });
-                if (!dry_run) {
-                    await redis.set(bestKey, lessonToStore);
-                    const listKey = `cachly:lessons:${topic}`;
-                    await redis.rpush(listKey, lessonToStore);
-                    await redis.ltrim(listKey, -100, -1);
-                    await redis.expire(listKey, 90 * 86400);
-                }
-                imported++;
-                if (importLog.length < 6) {
-                    const icon = lesson.outcome === 'success' ? '✅' : lesson.outcome === 'failure' ? '❌' : '⚠️';
-                    importLog.push(`  ${icon} \`${topic}\` — ${(lesson.what_worked ?? lesson.what_failed ?? '').slice(0, 80)}`);
-                }
-            }
-            // Record import provenance
-            if (!dry_run && imported > 0) {
-                try {
-                    const prov = JSON.stringify({
-                        share_id: cleanShareId, title: payload.title,
-                        imported: imported, skipped, conflicts,
-                        topic_prefix, imported_at: new Date().toISOString(),
-                    });
-                    await redis.rpush('cachly:brain:imports', prov);
-                    await redis.ltrim('cachly:brain:imports', -20, -1);
-                }
-                catch { /* non-critical */ }
-            }
-            const dryTag = dry_run ? ' (DRY RUN — no writes)' : '';
-            const shareTitle = payload.title ?? cleanShareId;
-            const lines = [
-                `📥 **brain_import${dryTag}** — from "${shareTitle}"`,
-                ``,
-                `**Share ID:** \`${cleanShareId}\``,
-                `**Lessons imported:** ${imported}`,
-                ...(skipped > 0 ? [`**Skipped (low confidence):** ${skipped}`] : []),
-                ...(conflicts > 0 ? [`**Skipped (already exist):** ${conflicts}  _(pass \`overwrite=true\` to replace)_`] : []),
-                ``,
-            ];
-            if (importLog.length > 0) {
-                lines.push(`**Sample lessons imported:**`, ...importLog);
-                if (imported > 6)
-                    lines.push(`  _...and ${imported - 6} more_`);
-            }
-            if (imported > 0 && !dry_run) {
-                lines.push(``, `✅ Brain updated — use \`smart_recall(query="...")\` to query the new knowledge.`);
-            }
-            else if (dry_run) {
-                lines.push(``, `_Remove \`dry_run=true\` to actually import these lessons._`);
-            }
-            else if (imported === 0 && conflicts > 0) {
-                lines.push(``, `ℹ️ All lessons already exist in your Brain. Pass \`overwrite=true\` to update them.`);
-            }
-            return lines.join('\n');
-        }
-        // ── brain_share_list ───────────────────────────────────────────────────────
-        case 'brain_share_list': {
-            const { instance_id } = args;
-            if (!instance_id)
-                return '⚠️ `brain_share_list` requires `instance_id`.';
-            const redis = await getConnection(instance_id);
-            // Load from local provenance log
-            let localShares = [];
-            try {
-                const raw = await redis.lrange('cachly:brain:shares', 0, -1);
-                localShares = raw.map(r => {
-                    try {
-                        return JSON.parse(r);
-                    }
-                    catch {
-                        return null;
-                    }
-                }).filter(Boolean);
-            }
-            catch { /* non-critical */ }
-            // Also try API for authoritative list
-            let apiShares = [];
-            try {
-                const result = await apiFetch('/api/v1/brains/share');
-                apiShares = result.shares ?? [];
-            }
-            catch { /* API may not be live yet */ }
-            // Merge: API is authoritative; local fills gaps
-            const merged = apiShares.length > 0 ? apiShares : localShares;
-            if (merged.length === 0) {
-                return [
-                    `📤 **brain_share_list** — no shares yet`,
-                    ``,
-                    `You haven't shared any Brain snapshots from this instance.`,
-                    ``,
-                    `Create one with: \`brain_share(instance_id="${instance_id}", title="My Patterns")\``,
-                ].join('\n');
-            }
-            const lines = [
-                `📤 **Your Brain Shares** (${merged.length})`,
-                ``,
-                `| # | Title | Lessons | Visibility | Created |`,
-                `|---|-------|---------|------------|---------|`,
-            ];
-            for (const [i, s] of merged.entries()) {
-                const d = new Date(s.created_at);
-                const created = isNaN(d.getTime()) ? s.created_at : d.toISOString().slice(0, 10);
-                const vis = s.visibility === 'public' ? '🌐 public' : '🔗 unlisted';
-                lines.push(`| ${i + 1} | ${s.title ?? '—'} | ${s.lesson_count ?? '?'} | ${vis} | ${created} |`);
-            }
-            const newest = merged[merged.length - 1];
-            lines.push(``, `**Import command:** \`brain_import(instance_id="<their-id>", share_id="${newest?.share_id ?? '...'}")\``, `**Revoke:** \`brain_unshare(instance_id="${instance_id}", share_id="<id>")\``);
-            return lines.join('\n');
-        }
-        // ── brain_unshare ──────────────────────────────────────────────────────────
-        case 'brain_unshare': {
-            const { instance_id, share_id } = args;
-            if (!instance_id)
-                return '⚠️ `brain_unshare` requires `instance_id`.';
-            if (!share_id)
-                return '⚠️ `brain_unshare` requires `share_id`.';
-            // Call API to delete
-            try {
-                await apiFetch(`/api/v1/brains/share/${share_id}`, { method: 'DELETE' });
-            }
-            catch (e) {
-                const msg = e.message ?? '';
-                if (msg.includes('404') || msg.includes('not found')) {
-                    return `❌ Share \`${share_id}\` not found — it may have already been removed.`;
-                }
-                // If API is down, just remove from local log and warn
-                if (msg.includes('ECONNREFUSED') || msg.includes('fetch failed')) {
-                    const redis = await getConnection(instance_id);
-                    try {
-                        const raw = await redis.lrange('cachly:brain:shares', 0, -1);
-                        const kept = raw.filter(r => { try {
-                            return JSON.parse(r).share_id !== share_id;
-                        }
-                        catch {
-                            return true;
-                        } });
-                        await redis.del('cachly:brain:shares');
-                        for (const entry of kept)
-                            await redis.rpush('cachly:brain:shares', entry);
-                    }
-                    catch { /* non-critical */ }
-                    return [
-                        `⚠️ **brain_unshare** — removed from local log`,
-                        ``,
-                        `API unreachable — removed \`${share_id}\` from your local share registry.`,
-                        `The public link may still be accessible until the API confirms deletion.`,
-                    ].join('\n');
-                }
-                return `❌ brain_unshare failed: ${msg}`;
-            }
-            // Remove from local log
-            const redis = await getConnection(instance_id);
-            try {
-                const raw = await redis.lrange('cachly:brain:shares', 0, -1);
-                const kept = raw.filter(r => { try {
-                    return JSON.parse(r).share_id !== share_id;
-                }
-                catch {
-                    return true;
-                } });
-                await redis.del('cachly:brain:shares');
-                for (const entry of kept)
-                    await redis.rpush('cachly:brain:shares', entry);
-            }
-            catch { /* non-critical */ }
-            return [
-                `🗑️ **brain_unshare** — share revoked`,
-                ``,
-                `Share \`${share_id}\` has been deleted. The public link is no longer accessible.`,
-                ``,
-                `_Anyone who already imported this Brain keeps their local copy._`,
-            ].join('\n');
-        }
-        // ── brain_discover ─────────────────────────────────────────────────────────
-        case 'brain_discover': {
-            const { query = '', topic = '', limit = 10, } = args;
-            // Search public Brain marketplace
-            let results = [];
-            try {
-                const params = new URLSearchParams();
-                if (query)
-                    params.set('q', query);
-                if (topic)
-                    params.set('topic', topic);
-                params.set('limit', String(limit));
-                results = await apiFetch(`/api/v1/brains/discover?${params.toString()}`);
-            }
-            catch (e) {
-                const msg = e.message ?? '';
-                if (msg.includes('404') || msg.includes('ECONNREFUSED') || msg.includes('fetch failed')) {
-                    return [
-                        `🔍 **brain_discover** — marketplace not yet live`,
-                        ``,
-                        `The public Brain marketplace is coming soon.`,
-                        ``,
-                        `**In the meantime:**`,
-                        `  • Share your Brain: \`brain_share(instance_id="...", visibility="public")\``,
-                        `  • Import by ID:    \`brain_import(instance_id="...", share_id="<id>")\``,
-                        `  • Community index: ${cachlyUrl('/brains', 'brain-discover')}`,
-                    ].join('\n');
-                }
-                return `❌ brain_discover failed: ${msg}`;
-            }
-            if (results.length === 0) {
-                const hint = query ? `matching "${query}"` : topic ? `in topic "${topic}"` : '';
-                return [
-                    `🔍 **brain_discover** — no public Brains found ${hint}`.trim(),
-                    ``,
-                    `Be the first! \`brain_share(instance_id="...", visibility="public")\``,
-                ].join('\n');
-            }
-            const lines = [
-                `🔍 **brain_discover**${query ? ` — "${query}"` : ''}${topic ? ` · topic: ${topic}` : ''} (${results.length} result${results.length !== 1 ? 's' : ''})`,
-                ``,
-            ];
-            for (const [i, r] of results.entries()) {
-                const d = new Date(r.created_at);
-                const created = isNaN(d.getTime()) ? '' : ` · ${d.toISOString().slice(0, 10)}`;
-                const importCount = r.imports != null ? ` · ${r.imports} imports` : '';
-                const topicStr = r.topics?.length ? ` · topics: ${r.topics.slice(0, 4).join(', ')}` : '';
-                const by = r.author ? ` by **${r.author}**` : '';
-                lines.push(`**${i + 1}. ${r.title}**${by}`, `   📚 ${r.lesson_count} lessons${topicStr}${importCount}${created}`, r.description ? `   _${r.description.slice(0, 120)}_` : '', `   \`brain_import(instance_id="...", share_id="${r.share_id}")\``, ``);
-            }
-            lines.push(`_Browse more at ${cachlyUrl('/brains', 'brain-discover')}_`);
-            return lines.filter(l => l !== '   ').join('\n');
-        }
-        // ── brain_seed_starter ─────────────────────────────────────────────────────
-        // Seeds a fresh Brain with curated, universal engineering lessons so the very
-        // first query returns a hit — drives time-to-first-recall under 2 minutes.
-        case 'brain_seed_starter': {
-            const { instance_id, topic_filter, dry_run = false, force = false, } = args;
-            if (!instance_id)
-                return '⚠️ `brain_seed_starter` requires `instance_id`.';
-            const redis = await getConnection(instance_id);
-            // Idempotency guard: don't double-seed unless force=true.
-            const seededMarker = await redis.get(`cachly:brain:starter_seeded:${instance_id}`);
-            if (seededMarker && !force && !dry_run) {
-                return [
-                    `🌱 **brain_seed_starter** — already seeded`,
-                    ``,
-                    `This Brain was seeded with the starter corpus on ${seededMarker}.`,
-                    ``,
-                    `Pass \`force=true\` to re-seed (existing starter lessons will be refreshed).`,
-                ].join('\n');
-            }
-            const topicFilter = Array.isArray(topic_filter) && topic_filter.length > 0 ? topic_filter : undefined;
-            const selected = topicFilter
-                ? STARTER_CORPUS.filter(l => topicFilter.some(f => l.topic.includes(f) || l.tags.some(t => t.includes(f))))
-                : STARTER_CORPUS;
-            if (selected.length === 0) {
-                return [
-                    `🌱 **brain_seed_starter** — no matching starter lessons`,
-                    ``,
-                    `No starter lessons match filter: ${topicFilter?.join(', ')}.`,
-                    `Available topics: ${STARTER_CORPUS.map(l => `\`${l.topic}\``).join(', ')}`,
-                ].join('\n');
-            }
-            if (dry_run) {
-                const sample = selected.slice(0, 8).map(l => `  ✅ \`${l.topic}\` — ${l.what_worked.slice(0, 70)}…`);
-                return [
-                    `🌱 **brain_seed_starter (DRY RUN)** — would seed ${selected.length} lesson${selected.length !== 1 ? 's' : ''}`,
-                    ``,
-                    ...sample,
-                    selected.length > 8 ? `  _...and ${selected.length - 8} more_` : '',
-                    ``,
-                    `_Remove \`dry_run=true\` to seed these into the Brain._`,
-                ].filter(l => l !== '').join('\n');
-            }
-            const now = new Date().toISOString();
-            let seeded = 0;
-            let skipped = 0;
-            for (const lesson of selected) {
-                const bestKey = `cachly:lesson:best:${lesson.topic}`;
-                // Never clobber a user's own lesson on the same topic (unless force).
-                if (!force) {
-                    const existing = await redis.get(bestKey);
-                    if (existing) {
-                        const parsed = safeJsonParse(existing, null);
-                        // Only skip if it's a real user lesson (not a prior starter seed).
-                        if (parsed && parsed.source !== 'starter') {
-                            skipped++;
-                            continue;
-                        }
-                    }
-                }
-                const lessonToStore = JSON.stringify({
-                    topic: lesson.topic,
-                    outcome: lesson.outcome,
-                    what_worked: lesson.what_worked,
-                    what_failed: lesson.what_failed,
-                    ctx: lesson.ctx,
-                    tags: lesson.tags,
-                    confidence: lesson.confidence,
-                    recall_count: 0,
-                    source: 'starter',
-                    ts: now,
-                    verified_at: now,
-                    version: 3,
-                });
-                await redis.set(bestKey, lessonToStore);
-                const listKey = `cachly:lessons:${lesson.topic}`;
-                await redis.rpush(listKey, lessonToStore);
-                await redis.ltrim(listKey, -100, -1);
-                await redis.expire(listKey, 90 * 86400);
-                seeded++;
-            }
-            // Stamp born_at so time-to-first-recall starts counting from the seed moment.
-            await redis.set(`cachly:stats:born_at:${instance_id}`, now, 'EX', 365 * 86400, 'NX').catch(() => { });
-            // Mark seeded for idempotency.
-            await redis.set(`cachly:brain:starter_seeded:${instance_id}`, now, 'EX', 365 * 86400);
-            return [
-                `🌱 **brain_seed_starter** — Brain seeded`,
-                ``,
-                `**${seeded}** universal engineering lesson${seeded !== 1 ? 's' : ''} added${skipped > 0 ? ` (${skipped} skipped — your own lessons take priority)` : ''}.`,
-                ``,
-                `Your Brain now answers common questions out of the box:`,
-                `  • \`smart_recall(query="docker build slow")\``,
-                `  • \`smart_recall(query="pod OOMKilled")\``,
-                `  • \`smart_recall(query="jwt token rejected")\``,
-                ``,
-                `_Starter lessons are tagged \`source: "starter"\` and never override your own._`,
-                `_They're replaced as you learn project-specific lessons on the same topics._`,
-            ].join('\n');
-        }
-        default:
-            return null;
-    }
-}
-/** Exposed for the empty-brain welcome nudge in session_start. */
-export { STARTER_CORPUS_SIZE };
-//# sourceMappingURL=share.js.map
+import{safeJsonParse as T}from"../utils.js";import{STARTER_CORPUS as k,STARTER_CORPUS_SIZE as x}from"../starter-corpus.js";import{cachlyUrl as j}from"../cachly-url.js";const E=new Set(["brain_share","brain_import","brain_share_list","brain_unshare","brain_discover","brain_seed_starter"]);async function R(v,w){const y=[],$=v.scanStream({match:"cachly:lesson:best:*",count:200});await new Promise((s,h)=>{$.on("data",e=>y.push(...e)),$.on("end",s),$.on("error",h)});const o=[];for(const s of y.slice(0,500)){const h=await v.get(s);if(!h)continue;const e=T(h,null);!e||!e.topic||w&&w.length>0&&!w.some(n=>e.topic.includes(n))||o.push({topic:e.topic,outcome:e.outcome,...e.what_worked?{what_worked:e.what_worked}:{},...e.what_failed?{what_failed:e.what_failed}:{},...e.ctx?{ctx:e.ctx}:{},...e.tags?.length?{tags:e.tags}:{},...e.author?{author:e.author}:{},...e.service?{service:e.service}:{},confidence:e.confidence??1,ts:e.ts})}return o}async function A(v,w,y,$){switch(v){case"brain_share":{const{instance_id:o,title:s="My Brain Snapshot",description:h="",topic_filter:e,visibility:t="unlisted",max_lessons:n=100,dry_run:r=!1}=w;if(!o)return"\u26A0\uFE0F `brain_share` requires `instance_id`.";const l=await y(o),c=Array.isArray(e)&&e.length>0?e:void 0,i=(await R(l,c)).slice(0,n);if(i.length===0)return["\u{1F4E4} **brain_share** \u2014 nothing to share yet","",`No lessons found in Brain \`${o}\`${c?` matching topics: ${c.join(", ")}`:""}.`,"",'Store lessons first with `learn_from_attempts(topic="...", what_worked="...")`.'].join(`
+`);if(r){const u=i.slice(0,5).map(p=>`  ${p.outcome==="success"?"\u2705":p.outcome==="failure"?"\u274C":"\u26A0\uFE0F"} \`${p.topic}\` \u2014 ${(p.what_worked??p.what_failed??"").slice(0,80)}`);return[`\u{1F4E4} **brain_share (DRY RUN)** \u2014 would share ${i.length} lesson${i.length!==1?"s":""}`,"",`**Title:** ${s}`,`**Visibility:** ${t}`,c?`**Topic filter:** ${c.join(", ")}`:"","","**Sample lessons (first 5):**",...u,i.length>5?`  _...and ${i.length-5} more_`:"","","_Remove `dry_run=true` to create the public share._"].filter(p=>p!=="").join(`
+`)}let a=null,d=null;try{a=(await $("/api/v1/brains/share",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({title:s,description:h,visibility:t,lessons:i})})).share_id??null,a&&(d=j(`/brain/share/${a}`,"brain-share"))}catch(u){const p=u.message??"";if(p.includes("404")||p.includes("not found")||p.includes("ECONNREFUSED")){const f=JSON.stringify({title:s,description:h,visibility:t,lessons:i,exported_at:new Date().toISOString()},null,2);return[`\u{1F4E4} **brain_share** \u2014 exported ${i.length} lesson${i.length!==1?"s":""}`,"","\u26A0\uFE0F The public share API is not yet available. Here is your portable snapshot:","","```json",f.slice(0,3e3)+(f.length>3e3?`
+... (truncated)`:""),"```","","_To import this on another Brain, use `brain_import` with the JSON payload._"].join(`
+`)}return`\u274C brain_share failed: ${u.message}`}const b=i.slice(0,5).map(u=>`  ${u.outcome==="success"?"\u2705":u.outcome==="failure"?"\u274C":"\u26A0\uFE0F"} \`${u.topic}\``);try{const u=JSON.stringify({share_id:a,title:s,visibility:t,lesson_count:i.length,created_at:new Date().toISOString()});await l.rpush("cachly:brain:shares",u),await l.ltrim("cachly:brain:shares",-20,-1)}catch{}return[`\u{1F4E4} **brain_share** \u2014 ${i.length} lesson${i.length!==1?"s":""} shared`,"",`**Share ID:** \`${a}\``,`**URL:**      ${d}`,`**Title:**    ${s}`,`**Visible:**  ${t}`,"","**Sample lessons:**",...b,i.length>5?`  _...and ${i.length-5} more_`:"","","**Anyone can import this Brain with:**",`\`brain_import(instance_id="<their-id>", share_id="${a}")\``,"","_To list all your shares, run `brain_share_list`._"].filter(u=>u!=="").join(`
+`)}case"brain_import":{const{instance_id:o,share_id:s,topic_prefix:h="",min_confidence:e=0,dry_run:t=!1,overwrite:n=!1}=w;if(!o)return"\u26A0\uFE0F `brain_import` requires `instance_id`.";if(!s)return"\u26A0\uFE0F `brain_import` requires `share_id`. Get one from `brain_share`.";const r=s.replace(/^.*\/brain\/share\//,"").trim();let l;try{l=await $(`/api/v1/brains/share/${r}`)}catch(m){const g=m.message??"";return g.includes("404")||g.includes("not found")?["\u274C **brain_import** \u2014 share not found","",`Share ID \`${r}\` does not exist or has been removed.`,"","Ask the Brain owner to re-run `brain_share` and share the new ID with you."].join(`
+`):`\u274C brain_import failed: ${m.message}`}const c=l.lessons??[];if(c.length===0)return`\u26A0\uFE0F Share \`${r}\` exists but contains no lessons.`;const _=await y(o);let i=0,a=0,d=0;const b=[];for(const m of c){if((m.confidence??1)<e){a++;continue}const g=h?`${h}:${m.topic}`:m.topic,N=`cachly:lesson:best:${g}`;if(!n&&await _.get(N)){d++;continue}const O=JSON.stringify({...m,topic:g,imported_from:r,imported_at:new Date().toISOString()});if(!t){await _.set(N,O);const S=`cachly:lessons:${g}`;await _.rpush(S,O),await _.ltrim(S,-100,-1),await _.expire(S,90*86400)}if(i++,b.length<6){const S=m.outcome==="success"?"\u2705":m.outcome==="failure"?"\u274C":"\u26A0\uFE0F";b.push(`  ${S} \`${g}\` \u2014 ${(m.what_worked??m.what_failed??"").slice(0,80)}`)}}if(!t&&i>0)try{const m=JSON.stringify({share_id:r,title:l.title,imported:i,skipped:a,conflicts:d,topic_prefix:h,imported_at:new Date().toISOString()});await _.rpush("cachly:brain:imports",m),await _.ltrim("cachly:brain:imports",-20,-1)}catch{}const u=t?" (DRY RUN \u2014 no writes)":"",p=l.title??r,f=[`\u{1F4E5} **brain_import${u}** \u2014 from "${p}"`,"",`**Share ID:** \`${r}\``,`**Lessons imported:** ${i}`,...a>0?[`**Skipped (low confidence):** ${a}`]:[],...d>0?[`**Skipped (already exist):** ${d}  _(pass \`overwrite=true\` to replace)_`]:[],""];return b.length>0&&(f.push("**Sample lessons imported:**",...b),i>6&&f.push(`  _...and ${i-6} more_`)),i>0&&!t?f.push("",'\u2705 Brain updated \u2014 use `smart_recall(query="...")` to query the new knowledge.'):t?f.push("","_Remove `dry_run=true` to actually import these lessons._"):i===0&&d>0&&f.push("","\u2139\uFE0F All lessons already exist in your Brain. Pass `overwrite=true` to update them."),f.join(`
+`)}case"brain_share_list":{const{instance_id:o}=w;if(!o)return"\u26A0\uFE0F `brain_share_list` requires `instance_id`.";const s=await y(o);let h=[];try{h=(await s.lrange("cachly:brain:shares",0,-1)).map(c=>{try{return JSON.parse(c)}catch{return null}}).filter(Boolean)}catch{}let e=[];try{e=(await $("/api/v1/brains/share")).shares??[]}catch{}const t=e.length>0?e:h;if(t.length===0)return["\u{1F4E4} **brain_share_list** \u2014 no shares yet","","You haven't shared any Brain snapshots from this instance.","",`Create one with: \`brain_share(instance_id="${o}", title="My Patterns")\``].join(`
+`);const n=[`\u{1F4E4} **Your Brain Shares** (${t.length})`,"","| # | Title | Lessons | Visibility | Created |","|---|-------|---------|------------|---------|"];for(const[l,c]of t.entries()){const _=new Date(c.created_at),i=isNaN(_.getTime())?c.created_at:_.toISOString().slice(0,10),a=c.visibility==="public"?"\u{1F310} public":"\u{1F517} unlisted";n.push(`| ${l+1} | ${c.title??"\u2014"} | ${c.lesson_count??"?"} | ${a} | ${i} |`)}const r=t[t.length-1];return n.push("",`**Import command:** \`brain_import(instance_id="<their-id>", share_id="${r?.share_id??"..."}")\``,`**Revoke:** \`brain_unshare(instance_id="${o}", share_id="<id>")\``),n.join(`
+`)}case"brain_unshare":{const{instance_id:o,share_id:s}=w;if(!o)return"\u26A0\uFE0F `brain_unshare` requires `instance_id`.";if(!s)return"\u26A0\uFE0F `brain_unshare` requires `share_id`.";try{await $(`/api/v1/brains/share/${s}`,{method:"DELETE"})}catch(e){const t=e.message??"";if(t.includes("404")||t.includes("not found"))return`\u274C Share \`${s}\` not found \u2014 it may have already been removed.`;if(t.includes("ECONNREFUSED")||t.includes("fetch failed")){const n=await y(o);try{const l=(await n.lrange("cachly:brain:shares",0,-1)).filter(c=>{try{return JSON.parse(c).share_id!==s}catch{return!0}});await n.del("cachly:brain:shares");for(const c of l)await n.rpush("cachly:brain:shares",c)}catch{}return["\u26A0\uFE0F **brain_unshare** \u2014 removed from local log","",`API unreachable \u2014 removed \`${s}\` from your local share registry.`,"The public link may still be accessible until the API confirms deletion."].join(`
+`)}return`\u274C brain_unshare failed: ${t}`}const h=await y(o);try{const t=(await h.lrange("cachly:brain:shares",0,-1)).filter(n=>{try{return JSON.parse(n).share_id!==s}catch{return!0}});await h.del("cachly:brain:shares");for(const n of t)await h.rpush("cachly:brain:shares",n)}catch{}return["\u{1F5D1}\uFE0F **brain_unshare** \u2014 share revoked","",`Share \`${s}\` has been deleted. The public link is no longer accessible.`,"","_Anyone who already imported this Brain keeps their local copy._"].join(`
+`)}case"brain_discover":{const{query:o="",topic:s="",limit:h=10}=w;let e=[];try{const n=new URLSearchParams;o&&n.set("q",o),s&&n.set("topic",s),n.set("limit",String(h)),e=await $(`/api/v1/brains/discover?${n.toString()}`)}catch(n){const r=n.message??"";return r.includes("404")||r.includes("ECONNREFUSED")||r.includes("fetch failed")?["\u{1F50D} **brain_discover** \u2014 marketplace not yet live","","The public Brain marketplace is coming soon.","","**In the meantime:**",'  \u2022 Share your Brain: `brain_share(instance_id="...", visibility="public")`','  \u2022 Import by ID:    `brain_import(instance_id="...", share_id="<id>")`',`  \u2022 Community index: ${j("/brains","brain-discover")}`].join(`
+`):`\u274C brain_discover failed: ${r}`}if(e.length===0)return[`\u{1F50D} **brain_discover** \u2014 no public Brains found ${o?`matching "${o}"`:s?`in topic "${s}"`:""}`.trim(),"",'Be the first! `brain_share(instance_id="...", visibility="public")`'].join(`
+`);const t=[`\u{1F50D} **brain_discover**${o?` \u2014 "${o}"`:""}${s?` \xB7 topic: ${s}`:""} (${e.length} result${e.length!==1?"s":""})`,""];for(const[n,r]of e.entries()){const l=new Date(r.created_at),c=isNaN(l.getTime())?"":` \xB7 ${l.toISOString().slice(0,10)}`,_=r.imports!=null?` \xB7 ${r.imports} imports`:"",i=r.topics?.length?` \xB7 topics: ${r.topics.slice(0,4).join(", ")}`:"",a=r.author?` by **${r.author}**`:"";t.push(`**${n+1}. ${r.title}**${a}`,`   \u{1F4DA} ${r.lesson_count} lessons${i}${_}${c}`,r.description?`   _${r.description.slice(0,120)}_`:"",`   \`brain_import(instance_id="...", share_id="${r.share_id}")\``,"")}return t.push(`_Browse more at ${j("/brains","brain-discover")}_`),t.filter(n=>n!=="   ").join(`
+`)}case"brain_seed_starter":{const{instance_id:o,topic_filter:s,dry_run:h=!1,force:e=!1}=w;if(!o)return"\u26A0\uFE0F `brain_seed_starter` requires `instance_id`.";const t=await y(o),n=await t.get(`cachly:brain:starter_seeded:${o}`);if(n&&!e&&!h)return["\u{1F331} **brain_seed_starter** \u2014 already seeded","",`This Brain was seeded with the starter corpus on ${n}.`,"","Pass `force=true` to re-seed (existing starter lessons will be refreshed)."].join(`
+`);const r=Array.isArray(s)&&s.length>0?s:void 0,l=r?k.filter(a=>r.some(d=>a.topic.includes(d)||a.tags.some(b=>b.includes(d)))):k;if(l.length===0)return["\u{1F331} **brain_seed_starter** \u2014 no matching starter lessons","",`No starter lessons match filter: ${r?.join(", ")}.`,`Available topics: ${k.map(a=>`\`${a.topic}\``).join(", ")}`].join(`
+`);if(h){const a=l.slice(0,8).map(d=>`  \u2705 \`${d.topic}\` \u2014 ${d.what_worked.slice(0,70)}\u2026`);return[`\u{1F331} **brain_seed_starter (DRY RUN)** \u2014 would seed ${l.length} lesson${l.length!==1?"s":""}`,"",...a,l.length>8?`  _...and ${l.length-8} more_`:"","","_Remove `dry_run=true` to seed these into the Brain._"].filter(d=>d!=="").join(`
+`)}const c=new Date().toISOString();let _=0,i=0;for(const a of l){const d=`cachly:lesson:best:${a.topic}`;if(!e){const p=await t.get(d);if(p){const f=T(p,null);if(f&&f.source!=="starter"){i++;continue}}}const b=JSON.stringify({topic:a.topic,outcome:a.outcome,what_worked:a.what_worked,what_failed:a.what_failed,ctx:a.ctx,tags:a.tags,confidence:a.confidence,recall_count:0,source:"starter",ts:c,verified_at:c,version:3});await t.set(d,b);const u=`cachly:lessons:${a.topic}`;await t.rpush(u,b),await t.ltrim(u,-100,-1),await t.expire(u,90*86400),_++}return await t.set(`cachly:stats:born_at:${o}`,c,"EX",365*86400,"NX").catch(()=>{}),await t.set(`cachly:brain:starter_seeded:${o}`,c,"EX",365*86400),["\u{1F331} **brain_seed_starter** \u2014 Brain seeded","",`**${_}** universal engineering lesson${_!==1?"s":""} added${i>0?` (${i} skipped \u2014 your own lessons take priority)`:""}.`,"","Your Brain now answers common questions out of the box:",'  \u2022 `smart_recall(query="docker build slow")`','  \u2022 `smart_recall(query="pod OOMKilled")`','  \u2022 `smart_recall(query="jwt token rejected")`',"",'_Starter lessons are tagged `source: "starter"` and never override your own._',"_They're replaced as you learn project-specific lessons on the same topics._"].join(`
+`)}default:return null}}export{E as SHARE_TOOL_NAMES,x as STARTER_CORPUS_SIZE,A as handleShareTool};