@marifold/core 0.60.0

package/dist/skill/SkillStore.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MarifoldError_1 = require("../errors/MarifoldError");
+const SkillValidator_1 = require("./SkillValidator");
+const SAFE_SKILL_NAME = /^[a-z0-9][a-z0-9_-]*$/;
+/**
+ * Loads `marifold.skill.v0` skills from the shared skills dir and the active
+ * profile's skills/ dir. Each skill is a folder `<name>/SKILL.md` (the Claude
+ * Code layout), so a skill can carry bundled files. A profile skill shadows a
+ * global one of the same name. Skills are the TUI's `$name` primitive and a
+ * future App's source.
+ */
+class SkillStore {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Loadable skills, sorted by name. With no scope, profile skills shadow
+     * global ones (the merged, runnable set); pass a scope to list just that
+     * layer. Folders that fail to parse are skipped — use get() for a precise
+     * error on a single named skill. */
+    list(scope) {
+        const byName = new Map();
+        if (scope !== 'profile') {
+            for (const skill of this.loadDir(this.options.globalDir, 'global'))
+                byName.set(skill.name, skill);
+        }
+        if (scope !== 'global' && this.options.profileDir) {
+            for (const skill of this.loadDir(this.options.profileDir, 'profile'))
+                byName.set(skill.name, skill);
+        }
+        return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    get(name) {
+        assertSafeName(name);
+        // Profile takes precedence over global.
+        for (const [dir, scope] of this.scopedDirs().reverse()) {
+            const skillMd = path.join(dir, name, 'SKILL.md');
+            if (fs.existsSync(skillMd)) {
+                return { ...(0, SkillValidator_1.parseSkill)(fs.readFileSync(skillMd, 'utf-8'), skillMd), scope };
+            }
+        }
+        return undefined;
+    }
+    require(name) {
+        const skill = this.get(name);
+        if (!skill)
+            throw MarifoldError_1.MarifoldError.skillNotFound(name);
+        return skill;
+    }
+    /** Validate then write a skill into the target scope as `<name>/SKILL.md`. */
+    installFromText(text, scope = 'global') {
+        const skill = (0, SkillValidator_1.parseSkill)(text);
+        const skillDir = path.join(this.dirForScope(scope), skill.name);
+        fs.mkdirSync(skillDir, { recursive: true });
+        const skillMd = path.join(skillDir, 'SKILL.md');
+        fs.writeFileSync(skillMd, text.endsWith('\n') ? text : `${text}\n`);
+        return { ...skill, source: skillMd, scope };
+    }
+    /** Install from a `.md` file or a Claude Code-style skill folder containing
+     * `SKILL.md`. Either way the skill lands at `<scope>/<name>/SKILL.md`; a
+     * folder source is copied whole (bundled files travel, though marifold
+     * currently only uses SKILL.md). */
+    installFromFile(filePath, scope = 'global') {
+        const { skillMd, folder } = resolveSkillSource(filePath);
+        const text = fs.readFileSync(skillMd, 'utf-8');
+        if (!folder)
+            return this.installFromText(text, scope);
+        const skill = (0, SkillValidator_1.parseSkill)(text, skillMd); // validate before writing
+        const destDir = path.join(this.dirForScope(scope), skill.name);
+        fs.rmSync(destDir, { recursive: true, force: true });
+        fs.cpSync(folder, destDir, { recursive: true });
+        return { ...skill, source: path.join(destDir, 'SKILL.md'), scope };
+    }
+    /** Remove a skill (its whole `<name>/` folder). With no scope, deletes it
+     * from every layer; pass a scope to delete only that layer (e.g. the profile
+     * copy, revealing a global one). */
+    remove(name, scope) {
+        assertSafeName(name);
+        let removed = false;
+        for (const [dir, dirScope] of this.scopedDirs()) {
+            if (scope !== undefined && dirScope !== scope)
+                continue;
+            const skillDir = path.join(dir, name);
+            if (fs.existsSync(path.join(skillDir, 'SKILL.md'))) {
+                fs.rmSync(skillDir, { recursive: true, force: true });
+                removed = true;
+            }
+        }
+        return removed;
+    }
+    scopedDirs() {
+        const dirs = [[this.options.globalDir, 'global']];
+        if (this.options.profileDir)
+            dirs.push([this.options.profileDir, 'profile']);
+        return dirs;
+    }
+    dirForScope(scope) {
+        if (scope === 'profile') {
+            if (!this.options.profileDir) {
+                throw MarifoldError_1.MarifoldError.skillInvalid('No profile skills directory is configured for this store.');
+            }
+            return this.options.profileDir;
+        }
+        return this.options.globalDir;
+    }
+    loadDir(dir, scope) {
+        if (!fs.existsSync(dir))
+            return [];
+        const skills = [];
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const skillMd = path.join(dir, entry.name, 'SKILL.md');
+            if (!fs.existsSync(skillMd))
+                continue;
+            try {
+                skills.push({ ...(0, SkillValidator_1.parseSkill)(fs.readFileSync(skillMd, 'utf-8'), skillMd), scope });
+            }
+            catch {
+                // Skip unparseable skill folders; get() surfaces the precise error.
+            }
+        }
+        return skills;
+    }
+}
+exports.SkillStore = SkillStore;
+function assertSafeName(name) {
+    if (!SAFE_SKILL_NAME.test(name)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Invalid skill name '${name}'.`);
+    }
+}
+/** Resolve an install target to its `SKILL.md` and, for a folder source, the
+ * folder to copy: a `.md` file directly, or a `SKILL.md` inside a skill folder. */
+function resolveSkillSource(target) {
+    if (!fs.existsSync(target)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Skill not found: ${target}`);
+    }
+    if (fs.statSync(target).isDirectory()) {
+        const skillMd = path.join(target, 'SKILL.md');
+        if (!fs.existsSync(skillMd)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Skill folder has no SKILL.md: ${target}`);
+        }
+        return { skillMd, folder: target };
+    }
+    return { skillMd: target };
+}
+//# sourceMappingURL=SkillStore.js.map

package/dist/skill/SkillStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillStore.js","sourceRoot":"","sources":["../../src/skill/SkillStore.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,MAAY,EAAE,+BAAW;AACzB,MAAY,IAAI,iCAAa;AAC7B,2DAAwD;AAExD,qDAA8C;AAE9C,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAWhD;;;;;;GAMG;AACH;IAC+B,OAAO;IAApC,YAA6B,OAA0B;uBAA1B,OAAO;IAAsB,CAAC;IAE3D;;;wCAGoC;IACpC,IAAI,CAAC,KAAkB;QACrB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpG,CAAC;QACD,IAAI,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtG,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,GAAG,CAAC,IAAY;QACd,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,wCAAwC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,EAAE,GAAG,IAAA,2BAAU,EAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;YAC9E,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,MAAM,6BAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,eAAe,CAAC,IAAY,EAAE,KAAK,GAAe,QAAQ;QACxD,MAAM,KAAK,GAAG,IAAA,2BAAU,EAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACpE,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED;;;wCAGoC;IACpC,eAAe,CAAC,QAAgB,EAAE,KAAK,GAAe,QAAQ;QAC5D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,IAAA,2BAAU,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,0BAA0B;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;IACrE,CAAC;IAED;;wCAEoC;IACpC,MAAM,CAAC,IAAY,EAAE,KAAkB;QACrC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAChD,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;gBAAE,SAAS;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;gBACnD,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU;QAChB,MAAM,IAAI,GAAgC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/E,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,WAAW,CAAC,KAAiB;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC7B,MAAM,6BAAa,CAAC,YAAY,CAAC,2DAA2D,CAAC,CAAC;YAChG,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAEO,OAAO,CAAC,GAAW,EAAE,KAAiB;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAA,2BAAU,EAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;YACtE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,6BAAa,CAAC,YAAY,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;mFACmF;AACnF,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,6BAAa,CAAC,YAAY,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,6BAAa,CAAC,YAAY,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/skill/SkillTemplater.d.ts

@@ -0,0 +1,19 @@
+import { MarifoldSkill } from './SkillSchema';
+export interface SkillRenderResult {
+    /** The expanded prompt with every `{{var}}` resolved. */
+    prompt: string;
+    /** Required variables that had neither a supplied value nor a default. */
+    missing: string[];
+}
+/**
+ * Effective value for each declared variable: the supplied value, else the
+ * declared default. Required variables with neither are reported as missing so
+ * the caller (TUI inline prompt, or an App form) can collect them.
+ */
+export declare function resolveSkillValues(skill: MarifoldSkill, supplied: Record<string, string>): {
+    values: Record<string, string>;
+    missing: string[];
+};
+/** Expand a skill's prompt template against supplied variable values. */
+export declare function renderSkillPrompt(skill: MarifoldSkill, supplied: Record<string, string>): SkillRenderResult;
+//# sourceMappingURL=SkillTemplater.d.ts.map

package/dist/skill/SkillTemplater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillTemplater.d.ts","sourceRoot":"","sources":["../../src/skill/SkillTemplater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBvD;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,iBAAiB,CAOnB"}

package/dist/skill/SkillTemplater.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSkillValues = resolveSkillValues;
+exports.renderSkillPrompt = renderSkillPrompt;
+/**
+ * Effective value for each declared variable: the supplied value, else the
+ * declared default. Required variables with neither are reported as missing so
+ * the caller (TUI inline prompt, or an App form) can collect them.
+ */
+function resolveSkillValues(skill, supplied) {
+    const values = {};
+    const missing = [];
+    for (const variable of skill.variables) {
+        const provided = supplied[variable.name];
+        if (provided !== undefined && provided !== '') {
+            values[variable.name] = provided;
+        }
+        else if (variable.default !== undefined) {
+            values[variable.name] = variable.default;
+        }
+        else if (variable.required) {
+            missing.push(variable.name);
+        }
+        else {
+            values[variable.name] = '';
+        }
+    }
+    return { values, missing };
+}
+/** Expand a skill's prompt template against supplied variable values. */
+function renderSkillPrompt(skill, supplied) {
+    const { values, missing } = resolveSkillValues(skill, supplied);
+    const prompt = skill.prompt.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_match, name) => values[name] ?? '');
+    return { prompt, missing };
+}
+//# sourceMappingURL=SkillTemplater.js.map

package/dist/skill/SkillTemplater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillTemplater.js","sourceRoot":"","sources":["../../src/skill/SkillTemplater.ts"],"names":[],"mappings":";;;;AASA;;;;GAIG;AACH,4BACE,KAAoB,EACpB,QAAgC;IAEhC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QACnC,CAAC;aAAM,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC3C,CAAC;aAAM,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,yEAAyE;AACzE,2BACE,KAAoB,EACpB,QAAgC;IAEhC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CACjC,gCAAgC,EAChC,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAC7C,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/skill/SkillValidator.d.ts

@@ -0,0 +1,10 @@
+import { MarifoldSkill } from './SkillSchema';
+type RawRecord = Record<string, unknown>;
+/**
+ * Parse and validate a `marifold.skill.v0` markdown skill — a YAML frontmatter
+ * block (`--- … ---`) carrying the metadata, followed by the prompt body.
+ */
+export declare function parseSkill(text: string, source?: string): MarifoldSkill;
+export declare function validateSkill(raw: RawRecord, source?: string): MarifoldSkill;
+export {};
+//# sourceMappingURL=SkillValidator.d.ts.map

package/dist/skill/SkillValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillValidator.d.ts","sourceRoot":"","sources":["../../src/skill/SkillValidator.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EAId,MAAM,eAAe,CAAC;AAOvB,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAmBvE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CA+C5E"}

package/dist/skill/SkillValidator.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSkill = parseSkill;
+exports.validateSkill = validateSkill;
+const yaml_1 = require("yaml");
+const MarifoldError_1 = require("../errors/MarifoldError");
+const SkillSchema_1 = require("./SkillSchema");
+const SAFE_SKILL_NAME = /^[a-z0-9][a-z0-9_-]*$/;
+const SAFE_VARIABLE_NAME = /^[a-zA-Z0-9_]+$/;
+// A markdown skill: a YAML frontmatter block, then the prompt body.
+const FRONTMATTER = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+/**
+ * Parse and validate a `marifold.skill.v0` markdown skill — a YAML frontmatter
+ * block (`--- … ---`) carrying the metadata, followed by the prompt body.
+ */
+function parseSkill(text, source) {
+    const normalized = text.replace(/^/, '').replace(/\r\n/g, '\n');
+    const match = normalized.match(FRONTMATTER);
+    if (!match) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('A skill must start with a YAML frontmatter block (--- … ---) followed by the prompt body.', source);
+    }
+    let front;
+    try {
+        front = (0, yaml_1.parse)(match[1]);
+    }
+    catch (error) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Could not parse skill frontmatter: ${String(error)}`, source);
+    }
+    if (typeof front !== 'object' || front === null || Array.isArray(front)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('Skill frontmatter must be a YAML mapping.', source);
+    }
+    return validateSkill({ ...front, prompt: match[2].trim() }, source);
+}
+function validateSkill(raw, source) {
+    // `schema` is optional now (markdown skills don't need a marker); if present
+    // it must still name this schema, to catch a misplaced App definition.
+    if (raw.schema !== undefined) {
+        const schema = requireString(raw.schema, 'schema', source);
+        if (schema !== SkillSchema_1.SKILL_SCHEMA_ID) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Expected schema "${SkillSchema_1.SKILL_SCHEMA_ID}" but found "${schema}".`, source);
+        }
+    }
+    const name = requireString(raw.name, 'name', source).trim();
+    if (!SAFE_SKILL_NAME.test(name)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Invalid skill name '${name}'. Use lowercase letters, numbers, underscores, or hyphens (starting alphanumeric).`, source);
+    }
+    const description = optionalString(raw.description, 'description', source)?.trim() ?? '';
+    const prompt = requireString(raw.prompt, 'prompt', source).trim();
+    if (prompt.length === 0) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('A skill prompt cannot be empty.', source);
+    }
+    const mode = normalizeMode(raw.mode, source);
+    const variables = normalizeVariables(raw.variables, source);
+    // Every variable referenced in the prompt must be declared, so the TUI and a
+    // graphical App resolve the same set before running the skill.
+    const declared = new Set(variables.map(variable => variable.name));
+    const referenced = (0, SkillSchema_1.extractTemplateVariables)(prompt);
+    const undeclared = referenced.filter(variable => !declared.has(variable));
+    if (undeclared.length > 0) {
+        throw MarifoldError_1.MarifoldError.skillInvalid(`Prompt references undeclared variable(s): ${undeclared.join(', ')}. Declare them in the frontmatter "variables:" list.`, source);
+    }
+    return {
+        name,
+        description,
+        prompt,
+        mode,
+        variables,
+        ...(source ? { source } : {}),
+    };
+}
+function normalizeMode(value, source) {
+    // Undefined when not declared: the run follows the session's mode (agent →
+    // agentic with tools; chat → plain turn). A skill pins a mode by declaring it.
+    if (value === undefined)
+        return undefined;
+    const mode = requireString(value, 'mode', source);
+    if (mode === 'agent' || mode === 'chat')
+        return mode;
+    throw MarifoldError_1.MarifoldError.skillInvalid('Expected mode to be "agent" or "chat".', source);
+}
+function normalizeVariables(value, source) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw MarifoldError_1.MarifoldError.skillInvalid('Expected "variables" to be a list.', source);
+    }
+    const seen = new Set();
+    return value.map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Expected variables[${index}] to be a mapping.`, source);
+        }
+        const variable = entry;
+        const name = requireString(variable.name, `variables[${index}].name`, source).trim();
+        if (!SAFE_VARIABLE_NAME.test(name)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Invalid variable name '${name}'. Use letters, numbers, or underscores.`, source);
+        }
+        if (seen.has(name)) {
+            throw MarifoldError_1.MarifoldError.skillInvalid(`Duplicate variable '${name}'.`, source);
+        }
+        seen.add(name);
+        const description = optionalString(variable.description, `variables[${index}].description`, source);
+        const required = optionalBoolean(variable.required, `variables[${index}].required`, source) ?? false;
+        const defaultValue = optionalString(variable.default, `variables[${index}].default`, source);
+        return {
+            name,
+            ...(description !== undefined ? { description } : {}),
+            required,
+            ...(defaultValue !== undefined ? { default: defaultValue } : {}),
+        };
+    });
+}
+function requireString(value, label, source) {
+    if (typeof value === 'string')
+        return value;
+    throw MarifoldError_1.MarifoldError.skillInvalid(`Expected ${label} to be a string.`, source);
+}
+function optionalString(value, label, source) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    throw MarifoldError_1.MarifoldError.skillInvalid(`Expected ${label} to be a string.`, source);
+}
+function optionalBoolean(value, label, source) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'boolean')
+        return value;
+    throw MarifoldError_1.MarifoldError.skillInvalid(`Expected ${label} to be a boolean.`, source);
+}
+//# sourceMappingURL=SkillValidator.js.map

package/dist/skill/SkillValidator.js.map

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

package/dist/skill/SkillVars.d.ts

@@ -0,0 +1,10 @@
+import { MarifoldSkill } from './SkillSchema';
+/**
+ * Expand `#name` tokens in `text` using the skill's sibling `vars.toml`
+ * (reusable prompt fragments defined as `name = "value"`). Only names defined
+ * in the file are replaced; unknown `#name` tokens and Midjourney-style
+ * `{a, b}` permutations are left untouched. Missing/unreadable `vars.toml`
+ * returns the text unchanged.
+ */
+export declare function expandSkillVars(text: string, skill: MarifoldSkill): string;
+//# sourceMappingURL=SkillVars.d.ts.map

package/dist/skill/SkillVars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillVars.d.ts","sourceRoot":"","sources":["../../src/skill/SkillVars.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAc1E"}

package/dist/skill/SkillVars.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandSkillVars = expandSkillVars;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const smol_toml_1 = require("smol-toml");
+/**
+ * Expand `#name` tokens in `text` using the skill's sibling `vars.toml`
+ * (reusable prompt fragments defined as `name = "value"`). Only names defined
+ * in the file are replaced; unknown `#name` tokens and Midjourney-style
+ * `{a, b}` permutations are left untouched. Missing/unreadable `vars.toml`
+ * returns the text unchanged.
+ */
+function expandSkillVars(text, skill) {
+    if (!skill.source)
+        return text;
+    const varsPath = path.join(path.dirname(skill.source), 'vars.toml');
+    let table;
+    try {
+        if (!fs.existsSync(varsPath))
+            return text;
+        table = (0, smol_toml_1.parse)(fs.readFileSync(varsPath, 'utf-8'));
+    }
+    catch {
+        return text;
+    }
+    return text.replace(/#([A-Za-z0-9_]+)/g, (match, name) => {
+        const value = table[name];
+        return typeof value === 'string' ? value : match;
+    });
+}
+//# sourceMappingURL=SkillVars.js.map

package/dist/skill/SkillVars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillVars.js","sourceRoot":"","sources":["../../src/skill/SkillVars.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,0CAcC;AA1BD,uCAAyB;AACzB,2CAA6B;AAC7B,yCAAkC;AAGlC;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,KAAoB;IAChE,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IACpE,IAAI,KAA8B,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,KAAK,GAAG,IAAA,iBAAK,EAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAA4B,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/skill/index.d.ts

@@ -0,0 +1,10 @@
+export { SKILL_SCHEMA_ID, extractTemplateVariables, } from './SkillSchema';
+export type { MarifoldSkill, SkillMode, SkillVariable } from './SkillSchema';
+export { parseSkill, validateSkill } from './SkillValidator';
+export { renderSkillPrompt, resolveSkillValues } from './SkillTemplater';
+export type { SkillRenderResult } from './SkillTemplater';
+export { bindSkillArgs, parseSkillInvocation, resolveSkillInvocation, resolveSkillValuesInvocation, skillUsage, tokenizeSkillArgs, } from './SkillInvocation';
+export type { ParsedSkillInvocation, ResolvedSkillInvocation } from './SkillInvocation';
+export { SkillStore } from './SkillStore';
+export type { SkillScope, SkillStoreOptions } from './SkillStore';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAC5B,UAAU,EACV,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/skill/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillStore = exports.tokenizeSkillArgs = exports.skillUsage = exports.resolveSkillValuesInvocation = exports.resolveSkillInvocation = exports.parseSkillInvocation = exports.bindSkillArgs = exports.resolveSkillValues = exports.renderSkillPrompt = exports.validateSkill = exports.parseSkill = exports.extractTemplateVariables = exports.SKILL_SCHEMA_ID = void 0;
+var SkillSchema_1 = require("./SkillSchema");
+Object.defineProperty(exports, "SKILL_SCHEMA_ID", { enumerable: true, get: function () { return SkillSchema_1.SKILL_SCHEMA_ID; } });
+Object.defineProperty(exports, "extractTemplateVariables", { enumerable: true, get: function () { return SkillSchema_1.extractTemplateVariables; } });
+var SkillValidator_1 = require("./SkillValidator");
+Object.defineProperty(exports, "parseSkill", { enumerable: true, get: function () { return SkillValidator_1.parseSkill; } });
+Object.defineProperty(exports, "validateSkill", { enumerable: true, get: function () { return SkillValidator_1.validateSkill; } });
+var SkillTemplater_1 = require("./SkillTemplater");
+Object.defineProperty(exports, "renderSkillPrompt", { enumerable: true, get: function () { return SkillTemplater_1.renderSkillPrompt; } });
+Object.defineProperty(exports, "resolveSkillValues", { enumerable: true, get: function () { return SkillTemplater_1.resolveSkillValues; } });
+var SkillInvocation_1 = require("./SkillInvocation");
+Object.defineProperty(exports, "bindSkillArgs", { enumerable: true, get: function () { return SkillInvocation_1.bindSkillArgs; } });
+Object.defineProperty(exports, "parseSkillInvocation", { enumerable: true, get: function () { return SkillInvocation_1.parseSkillInvocation; } });
+Object.defineProperty(exports, "resolveSkillInvocation", { enumerable: true, get: function () { return SkillInvocation_1.resolveSkillInvocation; } });
+Object.defineProperty(exports, "resolveSkillValuesInvocation", { enumerable: true, get: function () { return SkillInvocation_1.resolveSkillValuesInvocation; } });
+Object.defineProperty(exports, "skillUsage", { enumerable: true, get: function () { return SkillInvocation_1.skillUsage; } });
+Object.defineProperty(exports, "tokenizeSkillArgs", { enumerable: true, get: function () { return SkillInvocation_1.tokenizeSkillArgs; } });
+var SkillStore_1 = require("./SkillStore");
+Object.defineProperty(exports, "SkillStore", { enumerable: true, get: function () { return SkillStore_1.SkillStore; } });
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":";;;AAAA,6CAGuB;AAFrB,8GAAA,eAAe,OAAA;AACf,uHAAA,wBAAwB,OAAA;AAG1B,mDAA6D;AAApD,4GAAA,UAAU,OAAA;AAAE,+GAAA,aAAa,OAAA;AAClC,mDAAyE;AAAhE,mHAAA,iBAAiB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAE9C,qDAO2B;AANzB,gHAAA,aAAa,OAAA;AACb,uHAAA,oBAAoB,OAAA;AACpB,yHAAA,sBAAsB,OAAA;AACtB,+HAAA,4BAA4B,OAAA;AAC5B,6GAAA,UAAU,OAAA;AACV,oHAAA,iBAAiB,OAAA;AAGnB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA"}

package/dist/skillapp/SkillAppActionResolver.d.ts

@@ -0,0 +1,13 @@
+import { MarifoldSkill } from '../skill/SkillSchema';
+import { ResolvedSkillInvocation } from '../skill/SkillInvocation';
+import { SkillAppDefinition, SkillAppExecution } from './SkillAppSchema';
+export interface ResolvedSkillAppAction extends ResolvedSkillInvocation {
+    appName: string;
+    actionName: string;
+    output: string;
+    execution: SkillAppExecution;
+}
+/** Validate renderer state and resolve one server-owned Skill action. Clients
+ * send values only; they cannot replace the Skill, prompt, or execution policy. */
+export declare function resolveSkillAppAction(definition: SkillAppDefinition, actionName: string, supplied: Record<string, unknown>, skill: MarifoldSkill): ResolvedSkillAppAction;
+//# sourceMappingURL=SkillAppActionResolver.d.ts.map

package/dist/skillapp/SkillAppActionResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAppActionResolver.d.ts","sourceRoot":"","sources":["../../src/skillapp/SkillAppActionResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EAGlB,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;mFACmF;AACnF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,EAAE,aAAa,GACnB,sBAAsB,CA4CxB"}