@runcore-sh/runcore 0.1.2

package/dist/settings.js

@@ -0,0 +1,256 @@
+/**
+ * Core settings — airplane mode + model selection.
+ * Backed by brain/settings.json. Cached in memory after first load.
+ */
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { checkOllama } from "./llm/ollama.js";
+import { createLogger } from "./utils/logger.js";
+import { setWriteEncryptionEnabled } from "./lib/key-store.js";
+const log = createLogger("settings");
+const SETTINGS_PATH = join(process.cwd(), "brain", "settings.json");
+const DEFAULTS = {
+    instanceName: "Core",
+    airplaneMode: false,
+    models: { chat: "auto", utility: "auto" },
+    encryptBrainFiles: true,
+    safeWordMode: "always",
+    tts: { enabled: true, port: 3579, voice: "en_US-lessac-medium", autoPlay: true },
+    stt: { enabled: true, port: 3580, model: "ggml-base.en.bin" },
+    avatar: { enabled: false, port: 3581, musetalkPath: "", photoPath: "public/avatar/photo.png" },
+    backup: { enabled: false, schedule: "daily", providers: ["local"], localBackupDir: ".core-backups", maxBackups: 7, backupHour: 3 },
+    pulse: { threshold: 60, mode: "hybrid" },
+    mesh: { lanAnnounce: false, allowIncoming: false },
+};
+// --- Cache ---
+let cached = { ...DEFAULTS, models: { ...DEFAULTS.models }, tts: { ...DEFAULTS.tts }, stt: { ...DEFAULTS.stt }, avatar: { ...DEFAULTS.avatar }, backup: { ...DEFAULTS.backup, providers: [...DEFAULTS.backup.providers] }, pulse: { ...DEFAULTS.pulse }, mesh: { ...DEFAULTS.mesh } };
+// --- Load / Save ---
+/**
+ * Read brain/settings.json, returning defaults if missing or malformed.
+ * On first run (no settings file), probes Ollama to pick the right default:
+ * Ollama available → airplaneMode: true, otherwise false.
+ */
+export async function loadSettings() {
+    let fileExists = false;
+    try {
+        await access(SETTINGS_PATH);
+        fileExists = true;
+    }
+    catch { }
+    if (fileExists) {
+        try {
+            const raw = await readFile(SETTINGS_PATH, "utf-8");
+            const parsed = JSON.parse(raw);
+            const validProviders = ["openrouter", "anthropic", "openai", "ollama"];
+            cached = {
+                airplaneMode: typeof parsed.airplaneMode === "boolean" ? parsed.airplaneMode : DEFAULTS.airplaneMode,
+                provider: validProviders.includes(parsed.provider) ? parsed.provider : undefined,
+                models: {
+                    chat: typeof parsed.models?.chat === "string" ? parsed.models.chat : DEFAULTS.models.chat,
+                    utility: typeof parsed.models?.utility === "string" ? parsed.models.utility : DEFAULTS.models.utility,
+                },
+                encryptBrainFiles: typeof parsed.encryptBrainFiles === "boolean" ? parsed.encryptBrainFiles
+                    : typeof parsed.encryptEpisodicFiles === "boolean" ? parsed.encryptEpisodicFiles
+                        : DEFAULTS.encryptBrainFiles,
+                safeWordMode: ["always", "restart"].includes(parsed.safeWordMode) ? parsed.safeWordMode : DEFAULTS.safeWordMode,
+                tts: {
+                    enabled: typeof parsed.tts?.enabled === "boolean" ? parsed.tts.enabled : DEFAULTS.tts.enabled,
+                    port: typeof parsed.tts?.port === "number" ? parsed.tts.port : DEFAULTS.tts.port,
+                    voice: typeof parsed.tts?.voice === "string" ? parsed.tts.voice : DEFAULTS.tts.voice,
+                    autoPlay: typeof parsed.tts?.autoPlay === "boolean" ? parsed.tts.autoPlay : DEFAULTS.tts.autoPlay,
+                },
+                stt: {
+                    enabled: typeof parsed.stt?.enabled === "boolean" ? parsed.stt.enabled : DEFAULTS.stt.enabled,
+                    port: typeof parsed.stt?.port === "number" ? parsed.stt.port : DEFAULTS.stt.port,
+                    model: typeof parsed.stt?.model === "string" ? parsed.stt.model : DEFAULTS.stt.model,
+                },
+                avatar: {
+                    enabled: typeof parsed.avatar?.enabled === "boolean" ? parsed.avatar.enabled : DEFAULTS.avatar.enabled,
+                    port: typeof parsed.avatar?.port === "number" ? parsed.avatar.port : DEFAULTS.avatar.port,
+                    musetalkPath: typeof parsed.avatar?.musetalkPath === "string" ? parsed.avatar.musetalkPath : DEFAULTS.avatar.musetalkPath,
+                    photoPath: typeof parsed.avatar?.photoPath === "string" ? parsed.avatar.photoPath : DEFAULTS.avatar.photoPath,
+                },
+                backup: {
+                    enabled: typeof parsed.backup?.enabled === "boolean" ? parsed.backup.enabled : DEFAULTS.backup.enabled,
+                    schedule: ["daily", "weekly", "manual"].includes(parsed.backup?.schedule) ? parsed.backup.schedule : DEFAULTS.backup.schedule,
+                    providers: Array.isArray(parsed.backup?.providers) ? parsed.backup.providers.filter((p) => ["local", "gdrive"].includes(p)) : DEFAULTS.backup.providers,
+                    localBackupDir: typeof parsed.backup?.localBackupDir === "string" ? parsed.backup.localBackupDir : DEFAULTS.backup.localBackupDir,
+                    maxBackups: typeof parsed.backup?.maxBackups === "number" ? parsed.backup.maxBackups : DEFAULTS.backup.maxBackups,
+                    backupHour: typeof parsed.backup?.backupHour === "number" ? parsed.backup.backupHour : DEFAULTS.backup.backupHour,
+                },
+                pulse: {
+                    threshold: typeof parsed.pulse?.threshold === "number" ? parsed.pulse.threshold : DEFAULTS.pulse.threshold,
+                    mode: ["pressure", "timer", "hybrid"].includes(parsed.pulse?.mode) ? parsed.pulse.mode : DEFAULTS.pulse.mode,
+                },
+                mesh: {
+                    lanAnnounce: typeof parsed.mesh?.lanAnnounce === "boolean" ? parsed.mesh.lanAnnounce : DEFAULTS.mesh.lanAnnounce,
+                    allowIncoming: typeof parsed.mesh?.allowIncoming === "boolean" ? parsed.mesh.allowIncoming : DEFAULTS.mesh.allowIncoming,
+                },
+            };
+        }
+        catch {
+            cached = { ...DEFAULTS, models: { ...DEFAULTS.models }, pulse: { ...DEFAULTS.pulse } };
+        }
+    }
+    else {
+        // First run — probe Ollama to pick a sensible default
+        const ollama = await checkOllama();
+        const useLocal = ollama.available;
+        cached = {
+            airplaneMode: useLocal,
+            models: { ...DEFAULTS.models },
+            encryptBrainFiles: DEFAULTS.encryptBrainFiles,
+            safeWordMode: DEFAULTS.safeWordMode,
+            tts: { ...DEFAULTS.tts },
+            stt: { ...DEFAULTS.stt },
+            avatar: { ...DEFAULTS.avatar },
+            backup: { ...DEFAULTS.backup, providers: [...DEFAULTS.backup.providers] },
+            pulse: { ...DEFAULTS.pulse },
+            mesh: { ...DEFAULTS.mesh },
+        };
+        // Persist so subsequent starts don't re-probe
+        await saveSettings(cached).catch(() => { });
+        if (useLocal) {
+            log.info("First run: Ollama detected, defaulting to airplane mode");
+        }
+        else {
+            log.info("First run: Ollama not available, defaulting to OpenRouter");
+        }
+    }
+    setWriteEncryptionEnabled(cached.encryptBrainFiles);
+    return cached;
+}
+/** Write current settings to brain/settings.json. */
+export async function saveSettings(s) {
+    await writeFile(SETTINGS_PATH, JSON.stringify(s, null, 2) + "\n", "utf-8");
+}
+/** Sync getter for the in-memory cached settings. Call loadSettings() at startup first. */
+export function getSettings() {
+    return cached;
+}
+/** Merge partial updates, save to disk, update cache. Returns the new settings. */
+export async function updateSettings(partial) {
+    if (typeof partial.airplaneMode === "boolean") {
+        cached.airplaneMode = partial.airplaneMode;
+    }
+    if (partial.provider !== undefined) {
+        cached.provider = partial.provider;
+    }
+    if (partial.models) {
+        if (typeof partial.models.chat === "string")
+            cached.models.chat = partial.models.chat;
+        if (typeof partial.models.utility === "string")
+            cached.models.utility = partial.models.utility;
+    }
+    if (typeof partial.encryptBrainFiles === "boolean") {
+        cached.encryptBrainFiles = partial.encryptBrainFiles;
+        setWriteEncryptionEnabled(partial.encryptBrainFiles);
+    }
+    if (partial.safeWordMode && ["always", "restart"].includes(partial.safeWordMode)) {
+        cached.safeWordMode = partial.safeWordMode;
+    }
+    if (partial.tts) {
+        if (typeof partial.tts.enabled === "boolean")
+            cached.tts.enabled = partial.tts.enabled;
+        if (typeof partial.tts.port === "number")
+            cached.tts.port = partial.tts.port;
+        if (typeof partial.tts.voice === "string")
+            cached.tts.voice = partial.tts.voice;
+        if (typeof partial.tts.autoPlay === "boolean")
+            cached.tts.autoPlay = partial.tts.autoPlay;
+    }
+    if (partial.stt) {
+        if (typeof partial.stt.enabled === "boolean")
+            cached.stt.enabled = partial.stt.enabled;
+        if (typeof partial.stt.port === "number")
+            cached.stt.port = partial.stt.port;
+        if (typeof partial.stt.model === "string")
+            cached.stt.model = partial.stt.model;
+    }
+    if (partial.avatar) {
+        if (typeof partial.avatar.enabled === "boolean")
+            cached.avatar.enabled = partial.avatar.enabled;
+        if (typeof partial.avatar.port === "number")
+            cached.avatar.port = partial.avatar.port;
+        if (typeof partial.avatar.musetalkPath === "string")
+            cached.avatar.musetalkPath = partial.avatar.musetalkPath;
+        if (typeof partial.avatar.photoPath === "string")
+            cached.avatar.photoPath = partial.avatar.photoPath;
+    }
+    if (partial.backup) {
+        if (typeof partial.backup.enabled === "boolean")
+            cached.backup.enabled = partial.backup.enabled;
+        if (partial.backup.schedule)
+            cached.backup.schedule = partial.backup.schedule;
+        if (Array.isArray(partial.backup.providers))
+            cached.backup.providers = partial.backup.providers;
+        if (typeof partial.backup.localBackupDir === "string")
+            cached.backup.localBackupDir = partial.backup.localBackupDir;
+        if (typeof partial.backup.maxBackups === "number")
+            cached.backup.maxBackups = partial.backup.maxBackups;
+        if (typeof partial.backup.backupHour === "number")
+            cached.backup.backupHour = partial.backup.backupHour;
+    }
+    if (partial.pulse) {
+        if (typeof partial.pulse.threshold === "number")
+            cached.pulse.threshold = partial.pulse.threshold;
+        if (["pressure", "timer", "hybrid"].includes(partial.pulse.mode))
+            cached.pulse.mode = partial.pulse.mode;
+    }
+    if (partial.mesh) {
+        if (typeof partial.mesh.lanAnnounce === "boolean")
+            cached.mesh.lanAnnounce = partial.mesh.lanAnnounce;
+        if (typeof partial.mesh.allowIncoming === "boolean")
+            cached.mesh.allowIncoming = partial.mesh.allowIncoming;
+    }
+    await saveSettings(cached);
+    return cached;
+}
+// --- Resolvers ---
+/** Returns the active provider. Explicit `provider` setting takes precedence over airplaneMode. */
+export function resolveProvider() {
+    if (cached.provider)
+        return cached.provider;
+    return cached.airplaneMode ? "ollama" : "openrouter";
+}
+/**
+ * Returns the chat (streaming) model string, or undefined for "auto"
+ * (lets the LLM module fall through to its own default).
+ */
+export function resolveChatModel() {
+    const v = cached.models.chat;
+    return v === "auto" ? undefined : v;
+}
+/**
+ * Returns the utility (background tasks) model string, or undefined for "auto"
+ * (lets completeChat fall through to its own default).
+ */
+export function resolveUtilityModel() {
+    const v = cached.models.utility;
+    return v === "auto" ? undefined : v;
+}
+/** Returns the TTS configuration. */
+export function getTtsConfig() {
+    return cached.tts;
+}
+/** Returns the STT configuration. */
+export function getSttConfig() {
+    return cached.stt;
+}
+/** Returns the Avatar configuration. */
+export function getAvatarConfig() {
+    return cached.avatar;
+}
+/** Returns the Backup configuration. */
+export function getBackupConfig() {
+    return cached.backup;
+}
+/** Returns the Pulse configuration. */
+export function getPulseSettings() {
+    return cached.pulse;
+}
+/** Returns the Mesh configuration. */
+export function getMeshConfig() {
+    return cached.mesh;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Skills Library — Public API.
+ */
+export type { Skill, SkillMeta, SkillSlot, SkillState, SkillSource, SkillResolution, SkillValidation, } from "./types.js";
+export { SKILL_TRANSITIONS, SkillLifecycleError } from "./types.js";
+export { parseSkill, parseSkillMeta } from "./loader.js";
+export { validateSkill, extractReferences, parseFrontmatter, } from "./validator.js";
+export { SkillRegistry, createSkillRegistry, getSkillRegistry, skillRegistry, } from "./registry.js";
+export type { SkillMatchContext } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,11 @@
+/**
+ * Skills Library — Public API.
+ */
+export { SKILL_TRANSITIONS, SkillLifecycleError } from "./types.js";
+// Loader
+export { parseSkill, parseSkillMeta } from "./loader.js";
+// Validator
+export { validateSkill, extractReferences, parseFrontmatter, } from "./validator.js";
+// Registry
+export { SkillRegistry, createSkillRegistry, getSkillRegistry, skillRegistry, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD,YAAY;AACZ,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,WAAW;AACX,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Skills Library — Skill loader.
+ *
+ * Parses skill files (YAML frontmatter + Markdown body) into Skill objects.
+ * Stateless — pure functions. Delegates frontmatter parsing and validation
+ * to validator.ts.
+ */
+import type { Skill, SkillMeta } from "./types.js";
+import { extractReferences, validateSkill } from "./validator.js";
+export { validateSkill, extractReferences };
+/**
+ * Parse a skill file into a full Skill object (metadata + body).
+ * Returns null if the file has no valid frontmatter.
+ */
+export declare function parseSkill(filePath: string, content: string): Skill | null;
+/**
+ * Parse only the frontmatter metadata from a skill file.
+ * Cheaper than full parse — skips body processing.
+ * Returns null if the file has no valid frontmatter or is missing required fields.
+ */
+export declare function parseSkillMeta(filePath: string, content: string): SkillMeta | null;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAgC,MAAM,YAAY,CAAC;AACjF,OAAO,EAIL,iBAAiB,EACjB,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAM5C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAiB1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CA0BlB"}

package/dist/skills/loader.js

@@ -0,0 +1,65 @@
+/**
+ * Skills Library — Skill loader.
+ *
+ * Parses skill files (YAML frontmatter + Markdown body) into Skill objects.
+ * Stateless — pure functions. Delegates frontmatter parsing and validation
+ * to validator.ts.
+ */
+import { parseFrontmatter, toBool, FRONTMATTER_RE, extractReferences, validateSkill, } from "./validator.js";
+// Re-export for backwards compatibility and public API
+export { validateSkill, extractReferences };
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a skill file into a full Skill object (metadata + body).
+ * Returns null if the file has no valid frontmatter.
+ */
+export function parseSkill(filePath, content) {
+    const meta = parseSkillMeta(filePath, content);
+    if (!meta)
+        return null;
+    const match = content.match(FRONTMATTER_RE);
+    const body = match ? match[2].trim() : null;
+    const referencedFiles = body ? extractReferences(body) : [];
+    const now = new Date().toISOString();
+    return {
+        meta,
+        body: body || null,
+        referencedFiles,
+        state: "registered",
+        registeredAt: now,
+        refreshedAt: now,
+    };
+}
+/**
+ * Parse only the frontmatter metadata from a skill file.
+ * Cheaper than full parse — skips body processing.
+ * Returns null if the file has no valid frontmatter or is missing required fields.
+ */
+export function parseSkillMeta(filePath, content) {
+    const match = content.match(FRONTMATTER_RE);
+    if (!match)
+        return null;
+    const fm = parseFrontmatter(match[1]);
+    if (!fm.name || !fm.description)
+        return null;
+    const userInvocable = toBool(fm["user-invocable"], false);
+    const source = filePath.includes("brain/registry/installed")
+        ? {
+            type: "registry",
+            package: fm.name,
+            path: filePath,
+        }
+        : { type: "local", path: filePath };
+    return {
+        name: fm.name,
+        description: fm.description,
+        userInvocable,
+        disableModelInvocation: toBool(fm["disable-model-invocation"], false),
+        slot: userInvocable ? "task" : "reference",
+        version: fm.version,
+        source,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAE5C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAC1D,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,eAAe;QACf,KAAK,EAAE,YAAY;QACnB,YAAY,EAAE,GAAG;QACjB,WAAW,EAAE,GAAG;KACjB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE7C,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAgB,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACvE,CAAC,CAAC;YACE,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,EAAE,CAAC,IAAI;YAChB,IAAI,EAAE,QAAQ;SACf;QACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,aAAa;QACb,sBAAsB,EAAE,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,EAAE,KAAK,CAAC;QACrE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW;QAC1C,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/skills/registry.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Skills Library — Skill registry.
+ *
+ * In-memory registry of all known skills with file-backed discovery.
+ * Mirrors the AgentRegistry pattern: in-memory Map, scan directories on init,
+ * lazy body loading, resolution by intent.
+ */
+import type { Skill, SkillState, SkillSlot, SkillResolution, SkillValidation } from "./types.js";
+/** Task context used for skill matching. */
+export interface SkillMatchContext {
+    /** Free-text description of the task (e.g., "write a blog post about AI"). */
+    description: string;
+    /** File paths relevant to the task (used for reference-skill auto-loading). */
+    filePaths?: string[];
+}
+export declare class SkillRegistry {
+    /** In-memory skill map, keyed by skill name. */
+    private readonly skills;
+    /** Ordered list of source directories (priority order). */
+    private readonly sourceDirs;
+    /** Path to brain directory. */
+    private readonly brainDir;
+    private initialized;
+    constructor(opts: {
+        skillsDir: string;
+        brainDir: string;
+    });
+    /**
+     * Scan all source directories and register discovered skills.
+     * Loads metadata eagerly, body lazily.
+     */
+    init(): Promise<void>;
+    /**
+     * Load all skills from the configured source directories, validating each
+     * against the skill schema. Logs debug information about discovered skills,
+     * validation errors, and warnings.
+     *
+     * This is the high-level entry point — wraps `init()` with validation and
+     * debug output. Safe to call multiple times; subsequent calls refresh from disk.
+     *
+     * @returns Array of validation results for each discovered skill file.
+     */
+    loadSkills(): Promise<{
+        file: string;
+        validation: SkillValidation;
+    }[]>;
+    /**
+     * Re-scan source directories. Picks up new/changed/removed files.
+     * Does not unregister skills that were loaded programmatically (inline).
+     */
+    refresh(): Promise<void>;
+    /** Get a skill by name. */
+    get(name: string): Skill | undefined;
+    /** Check if a skill is registered. */
+    has(name: string): boolean;
+    /** Register a skill (from loader or programmatic creation). */
+    register(skill: Skill): void;
+    /** Archive a skill (terminal state — append-only, never removed). */
+    archive(name: string): void;
+    /** Enable a previously disabled skill. */
+    enable(name: string): void;
+    /** Disable a skill (skipped during resolution). */
+    disable(name: string): void;
+    /** List all skills, optionally filtered. */
+    list(filter?: {
+        state?: SkillState;
+        slot?: SkillSlot;
+        source?: "local" | "registry" | "inline";
+    }): Skill[];
+    /**
+     * Load the full body content for a skill.
+     * No-op if body is already loaded.
+     * Reads from the skill's source file path.
+     */
+    loadBody(name: string): Promise<string | null>;
+    /**
+     * Resolve which skill(s) apply to a given intent.
+     *
+     * Resolution order:
+     * 1. Exact name match (e.g., "/write-blog" → skill named "write-blog")
+     * 2. Intent keyword matching against skill descriptions (task skills)
+     * 3. Auto-load reference skills whose descriptions match the task type
+     *
+     * Returns results sorted by priority (local > registry) then confidence.
+     */
+    resolve(intent: string, opts?: {
+        includeReference?: boolean;
+        limit?: number;
+    }): SkillResolution[];
+    /** Resolve a single skill by exact name. */
+    resolveByName(name: string): Skill | undefined;
+    /**
+     * Match skills to a task context. Takes structured context (description and
+     * optional file paths) and returns relevant skills ranked by relevance.
+     *
+     * File paths are used to boost reference skills that mention matching brain
+     * module paths (e.g., a task touching `brain/identity/tone-of-voice.md`
+     * will boost the `voice-guide` reference skill).
+     *
+     * @param context - Task context with description and optional file paths.
+     * @returns Array of matching skill resolutions, sorted by priority then confidence.
+     */
+    matchSkills(context: SkillMatchContext): SkillResolution[];
+    /**
+     * Format a skill's content for injection into an agent prompt.
+     *
+     * Returns a formatted string with the skill name, description, and full
+     * instruction body wrapped in a clear delimiter. Returns null if the skill
+     * is not found or has no loaded body.
+     *
+     * Call `loadBody(skillName)` first if the body hasn't been loaded yet.
+     *
+     * @param skillName - The name of the skill to format.
+     * @returns Formatted prompt string, or null if skill/body unavailable.
+     */
+    getSkillPrompt(skillName: string): string | null;
+    /**
+     * Return all loaded skills for debugging and introspection.
+     *
+     * Unlike `list()` which supports filtering, this returns every skill in the
+     * registry regardless of state, along with summary metadata useful for
+     * debugging (name, slot, state, source type, whether body is loaded).
+     *
+     * @returns Array of all skills with their current state.
+     */
+    getAllSkills(): Array<{
+        name: string;
+        slot: SkillSlot;
+        state: SkillState;
+        source: string;
+        bodyLoaded: boolean;
+        referencedFiles: string[];
+    }>;
+    /** Validate a skill file before registration. */
+    validate(filePath: string, content: string): SkillValidation;
+    /** Count skills by state. */
+    countByState(): Record<SkillState, number>;
+    /** Total registered skills. */
+    get size(): number;
+    /** Transition a skill's state, enforcing the state machine. */
+    private transition;
+    /** Scan all source directories in parallel for .md skill files. */
+    private scanDirectories;
+    /** Register a skill from parsed file content. */
+    private registerFromFile;
+    /** Scan a single directory for skill files and register them (parallel I/O). */
+    private scanDirectory;
+}
+/** Create and initialize the global skill registry. */
+export declare function createSkillRegistry(opts: {
+    skillsDir: string;
+    brainDir: string;
+}): Promise<SkillRegistry>;
+/** Get the global skill registry (null if not initialized). */
+export declare function getSkillRegistry(): SkillRegistry | null;
+/**
+ * Pre-configured singleton using default paths (skills/ and brain/).
+ * Call `skillRegistry.loadSkills()` or `skillRegistry.init()` before use.
+ */
+export declare const skillRegistry: SkillRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/skills/registry.d.ts.map

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