Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import type { SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { hashFromDocName, hashFromSkillPreview } from '@/lib/doc-hash';
import { subscribeToSkillsChanged } from '@/lib/documents-events';
import { skillEntryLiveDocName } from '@/lib/managed-artifact-doc-name';
import { listSkills } from '@/lib/skills-api';
interface SkillNameInfo {
scope: SkillScope;
path: string;
description?: string;
managed?: boolean;
absolutePath?: string;
}
let merged: Map<string, SkillNameInfo> | null = null;
let byScope: Record<SkillScope, Map<string, SkillNameInfo>> | null = null;
let fetching = false;
let subscribed = false;
async function refresh(): Promise<void> {
if (fetching) return;
fetching = true;
try {
const scoped: Record<SkillScope, Map<string, SkillNameInfo>> = {
project: new Map(),
global: new Map(),
};
const out = new Map<string, SkillNameInfo>();
for (const scope of ['project', 'global'] as const) {
const res = await listSkills(scope);
if (!res.ok) continue;
for (const sk of res.skills) {
const info: SkillNameInfo = {
scope: sk.scope,
path: sk.path,
...(sk.description !== undefined && sk.description.trim() !== ''
? { description: sk.description }
: {}),
...(sk.managed === true ? { managed: true } : {}),
...(sk.absolutePath !== undefined ? { absolutePath: sk.absolutePath } : {}),
};
scoped[scope].set(sk.name, info);
if (!out.has(sk.name)) out.set(sk.name, info);
}
}
merged = out;
byScope = scoped;
} catch {
} finally {
fetching = false;
}
}
function ensureSubscribed(): void {
if (!subscribed) {
subscribed = true;
subscribeToSkillsChanged(() => void refresh());
}
}
export function skillRefNavHashForHit(name: string, hit: SkillNameInfo): string {
if (hit.managed === true && hit.absolutePath !== undefined) {
const cut = Math.max(hit.absolutePath.lastIndexOf('/'), hit.absolutePath.lastIndexOf('\\'));
return hashFromSkillPreview({
flavor: 'builtin',
source: cut > 0 ? hit.absolutePath.slice(0, cut) : hit.absolutePath,
name,
subtitle: '',
level: hit.scope,
});
}
return hashFromDocName(skillEntryLiveDocName({ scope: hit.scope, name, path: hit.path }));
}
export function getSkillNameSnapshot(): Map<string, SkillNameInfo> | null {
ensureSubscribed();
if (merged === null) void refresh();
return merged;
}
export function getSkillNamesForScope(scope: SkillScope): Map<string, SkillNameInfo> | null {
ensureSubscribed();
if (byScope === null) {
void refresh();
return null;
}
return byScope[scope];
}