@kilnai/core 0.10.0 → 0.14.0

package/dist/skill/md-parser.js

@@ -0,0 +1,168 @@
+import { parse } from "yaml";
+import { readFileSync } from "node:fs";
+import { KilnError } from "../engine/errors.js";
+import { EVENT_LEVEL_MAP } from "../events/index.js";
+const VALID_EVENT_TYPES = new Set(Object.keys(EVENT_LEVEL_MAP));
+const FRONTMATTER_DELIMITER = "---";
+export class SkillMdError extends KilnError {
+    errors;
+    filePath;
+    constructor(errors, filePath) {
+        const msg = errors.map((e) => `  ${e.field}: ${e.message}`).join("\n");
+        super("SKILL_MD_INVALID", `Invalid SKILL.md${filePath ? ` (${filePath})` : ""}:\n${msg}`, {
+            context: { errors, filePath },
+            retryable: false,
+        });
+        this.name = "SkillMdError";
+        this.errors = errors;
+        this.filePath = filePath;
+    }
+}
+/** Split SKILL.md content into frontmatter YAML and markdown body */
+function splitFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith(FRONTMATTER_DELIMITER)) {
+        return { frontmatter: "", body: content };
+    }
+    const afterFirst = trimmed.slice(FRONTMATTER_DELIMITER.length);
+    const endIndex = afterFirst.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+    if (endIndex === -1) {
+        return { frontmatter: "", body: content };
+    }
+    const frontmatter = afterFirst.slice(0, endIndex).trim();
+    const bodyStart = endIndex + 1 + FRONTMATTER_DELIMITER.length;
+    const body = afterFirst.slice(bodyStart).trim();
+    return { frontmatter, body };
+}
+/** Validate frontmatter object and return errors */
+function validateFrontmatter(data) {
+    const errors = [];
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        errors.push({ field: "(root)", message: "Frontmatter must be a YAML object" });
+        return errors;
+    }
+    const obj = data;
+    // Required: name, description
+    if (!("name" in obj) || typeof obj.name !== "string" || obj.name.trim() === "") {
+        errors.push({ field: "name", message: "Required string field" });
+    }
+    if (!("description" in obj) || typeof obj.description !== "string" || obj.description.trim() === "") {
+        errors.push({ field: "description", message: "Required string field" });
+    }
+    // Optional: handler (string)
+    if ("handler" in obj && typeof obj.handler !== "string") {
+        errors.push({ field: "handler", message: `Expected string, got ${typeof obj.handler}` });
+    }
+    // Optional: tools (string[])
+    if ("tools" in obj) {
+        if (!Array.isArray(obj.tools)) {
+            errors.push({ field: "tools", message: `Expected array, got ${typeof obj.tools}` });
+        }
+        else {
+            for (let i = 0; i < obj.tools.length; i++) {
+                if (typeof obj.tools[i] !== "string") {
+                    errors.push({ field: `tools[${i}]`, message: `Expected string, got ${typeof obj.tools[i]}` });
+                }
+            }
+        }
+    }
+    // Optional: tags (string[])
+    if ("tags" in obj) {
+        if (!Array.isArray(obj.tags)) {
+            errors.push({ field: "tags", message: `Expected array, got ${typeof obj.tags}` });
+        }
+        else {
+            for (let i = 0; i < obj.tags.length; i++) {
+                if (typeof obj.tags[i] !== "string") {
+                    errors.push({ field: `tags[${i}]`, message: `Expected string, got ${typeof obj.tags[i]}` });
+                }
+            }
+        }
+    }
+    // Optional: triggers (array of {event, filter?})
+    if ("triggers" in obj) {
+        if (!Array.isArray(obj.triggers)) {
+            errors.push({ field: "triggers", message: `Expected array, got ${typeof obj.triggers}` });
+        }
+        else {
+            for (let i = 0; i < obj.triggers.length; i++) {
+                const trigger = obj.triggers[i];
+                if (typeof trigger !== "object" || trigger === null || Array.isArray(trigger)) {
+                    errors.push({ field: `triggers[${i}]`, message: "Expected an object" });
+                }
+                else {
+                    const t = trigger;
+                    if (!("event" in t) || typeof t.event !== "string") {
+                        errors.push({ field: `triggers[${i}].event`, message: "Required string field" });
+                    }
+                }
+            }
+        }
+    }
+    return errors;
+}
+/** Build SkillIndex from validated frontmatter */
+function buildIndex(obj, filePath) {
+    const rawTriggers = obj.triggers ?? [];
+    // Validate event types
+    const triggerErrors = [];
+    for (let i = 0; i < rawTriggers.length; i++) {
+        const event = rawTriggers[i].event;
+        if (!VALID_EVENT_TYPES.has(event)) {
+            triggerErrors.push({ field: `triggers[${i}].event`, message: `Unknown event type "${event}"` });
+        }
+    }
+    if (triggerErrors.length > 0)
+        throw new SkillMdError(triggerErrors, filePath);
+    return {
+        name: obj.name,
+        description: obj.description,
+        tools: obj.tools ?? [],
+        triggers: rawTriggers.map((t) => ({
+            event: t.event,
+            ...(t.filter !== undefined ? { filter: t.filter } : {}),
+        })),
+        tags: obj.tags ?? [],
+        ...(obj.handler !== undefined ? { handler: obj.handler } : {}),
+        filePath,
+    };
+}
+/** Parse SKILL.md content into a full SkillConfig (frontmatter + body) */
+export function parseSkillMd(content, filePath = "") {
+    const { frontmatter, body } = splitFrontmatter(content);
+    if (!frontmatter) {
+        throw new SkillMdError([{ field: "(root)", message: "Missing YAML frontmatter (wrap in --- delimiters)" }], filePath);
+    }
+    const data = parse(frontmatter);
+    const errors = validateFrontmatter(data);
+    if (errors.length > 0)
+        throw new SkillMdError(errors, filePath);
+    if (!body) {
+        throw new SkillMdError([{ field: "body", message: "Missing markdown body (instructions)" }], filePath);
+    }
+    const index = buildIndex(data, filePath);
+    return { ...index, instructions: body };
+}
+/** Parse only the frontmatter of a SKILL.md file (index-only, skips body) */
+export function parseSkillMdIndex(content, filePath = "") {
+    const { frontmatter } = splitFrontmatter(content);
+    if (!frontmatter) {
+        throw new SkillMdError([{ field: "(root)", message: "Missing YAML frontmatter (wrap in --- delimiters)" }], filePath);
+    }
+    const data = parse(frontmatter);
+    const errors = validateFrontmatter(data);
+    if (errors.length > 0)
+        throw new SkillMdError(errors, filePath);
+    return buildIndex(data, filePath);
+}
+/** Read a SKILL.md file from disk and parse into full SkillConfig */
+export function loadSkillMd(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    return parseSkillMd(content, filePath);
+}
+/** Read a SKILL.md file from disk and parse only the index (frontmatter) */
+export function loadSkillMdIndex(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    return parseSkillMdIndex(content, filePath);
+}
+//# sourceMappingURL=md-parser.js.map

package/dist/skill/md-parser.js.map

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

package/dist/skill/skill-registry.d.ts

@@ -1,16 +1,23 @@
-import type { SkillConfig } from "./types.js";
+import type { SkillIndex, SkillConfig } from "./types.js";
 import type { DomainPackageManifest } from "../package/types.js";
 export interface SkillRegistryOptions {
     readonly builtinSkills?: readonly SkillConfig[];
 }
 export declare class SkillRegistry {
-    private readonly skills;
+    private readonly indexes;
+    private readonly fullCache;
     constructor(options?: SkillRegistryOptions);
-    /** Register a skill. First-registered wins -- no overwrite. */
-    register(skill: SkillConfig): void;
-    get(name: string): SkillConfig | undefined;
-    all(): SkillConfig[];
-    /** Discover skills from a directory path. Returns number of skills loaded. */
+    /** Register a skill index. First-registered wins. */
+    register(index: SkillIndex): void;
+    /** Register a full SkillConfig (for builtins or programmatic use). Stores index + caches full config. */
+    registerFull(config: SkillConfig): void;
+    get(name: string): SkillIndex | undefined;
+    all(): SkillIndex[];
+    /** Load full SkillConfig on demand. Reads file from disk if not already cached. */
+    load(name: string): SkillConfig | undefined;
+    /** Resolve skills matching any of the given names or tags. */
+    resolve(names?: readonly string[], tags?: readonly string[]): SkillIndex[];
+    /** Discover SKILL.md files from a directory. Returns number of skills loaded. */
     discoverFrom(dirPath: string): number;
     /** Discover skills from a domain package manifest. Returns number loaded. */
     discoverFromPackage(manifest: DomainPackageManifest): number;
@@ -19,8 +26,9 @@ export declare class SkillRegistry {
      * 1. workspace: projectPath/.kiln/skills/
      * 2. user: userHome/.kiln/skills/
      * 3. builtin (passed via constructor)
-     * Earlier tiers override later (workspace wins over user wins over builtin).
+     * Earlier tiers win (workspace > user > builtin).
      */
     discoverAll(projectPath: string, userHome: string): number;
+    private tryLoadIndex;
 }
 //# sourceMappingURL=skill-registry.d.ts.map

package/dist/skill/skill-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/skill/skill-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACjD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAE7C,OAAO,CAAC,EAAE,oBAAoB;IAQ1C,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,GAAG,IAAI,WAAW,EAAE;IAIpB,8EAA8E;IAC9E,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAsBrC,6EAA6E;IAC7E,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM;IAmB5D;;;;;;OAMG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAS3D"}
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/skill/skill-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACjD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAEhD,OAAO,CAAC,EAAE,oBAAoB;IAQ1C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMjC,yGAAyG;IACzG,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAOvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,GAAG,IAAI,UAAU,EAAE;IAInB,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAgB3C,8DAA8D;IAC9D,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE;IAoB1E,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAqBrC,6EAA6E;IAC7E,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM;IAW5D;;;;;;OAMG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAU1D,OAAO,CAAC,YAAY;CAYrB"}

package/dist/skill/skill-registry.js

@@ -1,43 +1,86 @@
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
-import { loadSkillYaml } from "./yaml-parser.js";
+import { loadSkillMdIndex, loadSkillMd } from "./md-parser.js";
 export class SkillRegistry {
-    skills = new Map();
+    indexes = new Map();
+    fullCache = new Map();
     constructor(options) {
         if (options?.builtinSkills) {
             for (const skill of options.builtinSkills) {
-                this.register(skill);
+                this.registerFull(skill);
             }
         }
     }
-    /** Register a skill. First-registered wins -- no overwrite. */
-    register(skill) {
-        if (!this.skills.has(skill.name)) {
-            this.skills.set(skill.name, skill);
+    /** Register a skill index. First-registered wins. */
+    register(index) {
+        if (!this.indexes.has(index.name)) {
+            this.indexes.set(index.name, index);
+        }
+    }
+    /** Register a full SkillConfig (for builtins or programmatic use). Stores index + caches full config. */
+    registerFull(config) {
+        if (!this.indexes.has(config.name)) {
+            this.indexes.set(config.name, config);
+            this.fullCache.set(config.name, config);
         }
     }
     get(name) {
-        return this.skills.get(name);
+        return this.indexes.get(name);
     }
     all() {
-        return [...this.skills.values()];
+        return [...this.indexes.values()];
+    }
+    /** Load full SkillConfig on demand. Reads file from disk if not already cached. */
+    load(name) {
+        const cached = this.fullCache.get(name);
+        if (cached)
+            return cached;
+        const index = this.indexes.get(name);
+        if (!index?.filePath)
+            return undefined;
+        try {
+            const config = loadSkillMd(index.filePath);
+            this.fullCache.set(name, config);
+            return config;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Resolve skills matching any of the given names or tags. */
+    resolve(names, tags) {
+        if (!names?.length && !tags?.length)
+            return [];
+        const nameSet = names ? new Set(names) : undefined;
+        const tagSet = tags ? new Set(tags) : undefined;
+        const results = [];
+        for (const index of this.indexes.values()) {
+            if (nameSet?.has(index.name)) {
+                results.push(index);
+                continue;
+            }
+            if (tagSet && index.tags.some((t) => tagSet.has(t))) {
+                results.push(index);
+            }
+        }
+        return results;
     }
-    /** Discover skills from a directory path. Returns number of skills loaded. */
+    /** Discover SKILL.md files from a directory. Returns number of skills loaded. */
     discoverFrom(dirPath) {
         if (!existsSync(dirPath))
             return 0;
-        const files = readdirSync(dirPath).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
+        const entries = readdirSync(dirPath, { withFileTypes: true });
         let loaded = 0;
-        for (const file of files) {
-            try {
-                const skill = loadSkillYaml(join(dirPath, file));
-                if (!this.skills.has(skill.name)) {
-                    this.skills.set(skill.name, skill);
-                    loaded++;
+        for (const entry of entries) {
+            // Convention: each skill is a directory containing SKILL.md, or a flat SKILL.md file
+            if (entry.isDirectory()) {
+                const skillMdPath = join(dirPath, entry.name, "SKILL.md");
+                if (existsSync(skillMdPath)) {
+                    loaded += this.tryLoadIndex(skillMdPath);
                 }
             }
-            catch {
-                // Skip invalid files silently
+            else if (entry.name.endsWith(".md")) {
+                loaded += this.tryLoadIndex(join(dirPath, entry.name));
             }
         }
         return loaded;
@@ -49,16 +92,7 @@ export class SkillRegistry {
         let loaded = 0;
         for (const skillPath of manifest.skills) {
             const fullPath = join(manifest.installPath, skillPath);
-            try {
-                const skill = loadSkillYaml(fullPath);
-                if (!this.skills.has(skill.name)) {
-                    this.skills.set(skill.name, skill);
-                    loaded++;
-                }
-            }
-            catch {
-                // Skip invalid skill files silently
-            }
+            loaded += this.tryLoadIndex(fullPath);
         }
         return loaded;
     }
@@ -67,7 +101,7 @@ export class SkillRegistry {
      * 1. workspace: projectPath/.kiln/skills/
      * 2. user: userHome/.kiln/skills/
      * 3. builtin (passed via constructor)
-     * Earlier tiers override later (workspace wins over user wins over builtin).
+     * Earlier tiers win (workspace > user > builtin).
      */
     discoverAll(projectPath, userHome) {
         const workspaceDir = join(projectPath, ".kiln", "skills");
@@ -77,5 +111,18 @@ export class SkillRegistry {
         total += this.discoverFrom(userDir);
         return total;
     }
+    tryLoadIndex(filePath) {
+        try {
+            const index = loadSkillMdIndex(filePath);
+            if (!this.indexes.has(index.name)) {
+                this.indexes.set(index.name, index);
+                return 1;
+            }
+        }
+        catch {
+            // Skip invalid files silently
+        }
+        return 0;
+    }
 }
 //# sourceMappingURL=skill-registry.js.map

package/dist/skill/skill-registry.js.map

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

package/dist/skill/types.d.ts

@@ -4,14 +4,18 @@ export interface SkillTrigger {
     readonly event: EventType;
     readonly filter?: Record<string, unknown>;
 }
-/** Skill configuration (runtime form) */
-export interface SkillConfig {
+/** Lightweight index entry — loaded at discovery time (progressive disclosure) */
+export interface SkillIndex {
     readonly name: string;
     readonly description: string;
     readonly tools: readonly string[];
     readonly triggers: readonly SkillTrigger[];
     readonly tags: readonly string[];
-    readonly instructions: string;
     readonly handler?: string;
+    readonly filePath: string;
+}
+/** Full skill config — loaded on activation. Body is the markdown instructions. */
+export interface SkillConfig extends SkillIndex {
+    readonly instructions: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kilnai/core",
-  "version": "0.10.0",
+  "version": "0.14.0",
   "description": "Domain-agnostic AI orchestration engine -- 7 primitives, 3 composites, YAML-configured",
   "type": "module",
   "exports": {

package/dist/skill/yaml-parser.d.ts

@@ -1,18 +0,0 @@
-import { KilnError } from "../engine/errors.js";
-import type { SkillConfig } from "./types.js";
-export declare class SkillYamlError extends KilnError {
-    readonly errors: readonly {
-        field: string;
-        message: string;
-    }[];
-    readonly filePath?: string;
-    constructor(errors: readonly {
-        field: string;
-        message: string;
-    }[], filePath?: string);
-}
-/** Parse a YAML string into a validated SkillConfig */
-export declare function parseSkillYaml(content: string, filePath?: string): SkillConfig;
-/** Read a YAML file from disk and parse into SkillConfig */
-export declare function loadSkillYaml(filePath: string): SkillConfig;
-//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/skill/yaml-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/skill/yaml-parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,qBAAa,cAAe,SAAQ,SAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,MAAM,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,EACrD,QAAQ,CAAC,EAAE,MAAM;CAWpB;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAkC9E;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAG3D"}

package/dist/skill/yaml-parser.js

@@ -1,61 +0,0 @@
-import { parse } from "yaml";
-import { readFileSync } from "node:fs";
-import { KilnError } from "../engine/errors.js";
-import { validateSkillYaml } from "./yaml-schema.js";
-import { EVENT_LEVEL_MAP } from "../events/index.js";
-const VALID_EVENT_TYPES = new Set(Object.keys(EVENT_LEVEL_MAP));
-export class SkillYamlError extends KilnError {
-    errors;
-    filePath;
-    constructor(errors, filePath) {
-        const msg = errors.map((e) => `  ${e.field}: ${e.message}`).join("\n");
-        super("SKILL_YAML_INVALID", `Invalid skill YAML${filePath ? ` (${filePath})` : ""}:\n${msg}`, {
-            context: { errors, filePath },
-            retryable: false,
-        });
-        this.name = "SkillYamlError";
-        this.errors = errors;
-        this.filePath = filePath;
-    }
-}
-/** Parse a YAML string into a validated SkillConfig */
-export function parseSkillYaml(content, filePath) {
-    const data = parse(content);
-    const errors = validateSkillYaml(data, filePath);
-    if (errors.length > 0)
-        throw new SkillYamlError(errors, filePath);
-    // Safe cast: validation above confirmed the required shape
-    const yaml = data;
-    // Validate trigger event values against known EventType strings
-    const triggerErrors = [];
-    const rawTriggers = yaml.triggers ?? [];
-    for (let i = 0; i < rawTriggers.length; i++) {
-        const trigger = rawTriggers[i];
-        if (!VALID_EVENT_TYPES.has(trigger.event)) {
-            triggerErrors.push({
-                field: `triggers[${i}].event`,
-                message: `Unknown event type "${trigger.event}"`,
-            });
-        }
-    }
-    if (triggerErrors.length > 0)
-        throw new SkillYamlError(triggerErrors, filePath);
-    return {
-        name: yaml.name,
-        description: yaml.description,
-        tools: yaml.tools ?? [],
-        triggers: rawTriggers.map((t) => ({
-            event: t.event,
-            ...(t.filter !== undefined ? { filter: t.filter } : {}),
-        })),
-        tags: yaml.tags ?? [],
-        instructions: yaml.instructions,
-        ...(yaml.handler !== undefined ? { handler: yaml.handler } : {}),
-    };
-}
-/** Read a YAML file from disk and parse into SkillConfig */
-export function loadSkillYaml(filePath) {
-    const content = readFileSync(filePath, "utf-8");
-    return parseSkillYaml(content, filePath);
-}
-//# sourceMappingURL=yaml-parser.js.map

package/dist/skill/yaml-parser.js.map

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

package/dist/skill/yaml-schema.d.ts

@@ -1,20 +0,0 @@
-import type { YamlValidationError } from "../domain/yaml-schema.js";
-export type { YamlValidationError };
-/** Trigger as expressed in YAML */
-export interface SkillTriggerYaml {
-    readonly event: string;
-    readonly filter?: Record<string, unknown>;
-}
-/** Skill config as expressed in YAML */
-export interface SkillYaml {
-    readonly name: string;
-    readonly description: string;
-    readonly tools?: readonly string[];
-    readonly triggers?: readonly SkillTriggerYaml[];
-    readonly tags?: readonly string[];
-    readonly instructions: string;
-    readonly handler?: string;
-}
-/** Validate a parsed YAML object against the SkillYaml schema */
-export declare function validateSkillYaml(data: unknown, filePath?: string): YamlValidationError[];
-//# sourceMappingURL=yaml-schema.d.ts.map

package/dist/skill/yaml-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"yaml-schema.d.ts","sourceRoot":"","sources":["../../src/skill/yaml-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,iEAAiE;AACjE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,mBAAmB,EAAE,CA+EvB"}

package/dist/skill/yaml-schema.js

@@ -1,80 +0,0 @@
-const REQUIRED_FIELDS = ["name", "description", "instructions"];
-/** Validate a parsed YAML object against the SkillYaml schema */
-export function validateSkillYaml(data, filePath) {
-    const errors = [];
-    if (typeof data !== "object" || data === null || Array.isArray(data)) {
-        errors.push({ field: "(root)", message: "Expected an object", filePath });
-        return errors;
-    }
-    const obj = data;
-    // Required fields
-    for (const field of REQUIRED_FIELDS) {
-        if (!(field in obj)) {
-            errors.push({ field, message: `Missing required field "${field}"`, filePath });
-        }
-    }
-    // Type checks for present fields
-    if ("name" in obj && typeof obj.name !== "string") {
-        errors.push({ field: "name", message: `Expected string, got ${typeof obj.name}`, filePath });
-    }
-    if ("description" in obj && typeof obj.description !== "string") {
-        errors.push({ field: "description", message: `Expected string, got ${typeof obj.description}`, filePath });
-    }
-    if ("instructions" in obj && typeof obj.instructions !== "string") {
-        errors.push({ field: "instructions", message: `Expected string, got ${typeof obj.instructions}`, filePath });
-    }
-    if ("handler" in obj && typeof obj.handler !== "string") {
-        errors.push({ field: "handler", message: `Expected string, got ${typeof obj.handler}`, filePath });
-    }
-    // tools: optional array of strings
-    if ("tools" in obj) {
-        if (!Array.isArray(obj.tools)) {
-            errors.push({ field: "tools", message: `Expected array, got ${typeof obj.tools}`, filePath });
-        }
-        else {
-            for (let i = 0; i < obj.tools.length; i++) {
-                if (typeof obj.tools[i] !== "string") {
-                    errors.push({ field: `tools[${i}]`, message: `Expected string, got ${typeof obj.tools[i]}`, filePath });
-                }
-            }
-        }
-    }
-    // tags: optional array of strings
-    if ("tags" in obj) {
-        if (!Array.isArray(obj.tags)) {
-            errors.push({ field: "tags", message: `Expected array, got ${typeof obj.tags}`, filePath });
-        }
-        else {
-            for (let i = 0; i < obj.tags.length; i++) {
-                if (typeof obj.tags[i] !== "string") {
-                    errors.push({ field: `tags[${i}]`, message: `Expected string, got ${typeof obj.tags[i]}`, filePath });
-                }
-            }
-        }
-    }
-    // triggers: optional array of objects with event=string
-    if ("triggers" in obj) {
-        if (!Array.isArray(obj.triggers)) {
-            errors.push({ field: "triggers", message: `Expected array, got ${typeof obj.triggers}`, filePath });
-        }
-        else {
-            for (let i = 0; i < obj.triggers.length; i++) {
-                const trigger = obj.triggers[i];
-                if (typeof trigger !== "object" || trigger === null || Array.isArray(trigger)) {
-                    errors.push({ field: `triggers[${i}]`, message: "Expected an object", filePath });
-                }
-                else {
-                    const t = trigger;
-                    if (!("event" in t)) {
-                        errors.push({ field: `triggers[${i}].event`, message: `Missing required field "event"`, filePath });
-                    }
-                    else if (typeof t.event !== "string") {
-                        errors.push({ field: `triggers[${i}].event`, message: `Expected string, got ${typeof t.event}`, filePath });
-                    }
-                }
-            }
-        }
-    }
-    return errors;
-}
-//# sourceMappingURL=yaml-schema.js.map