@backendkit-labs/agent-core 0.14.0

package/dist/skills/providers/github.js

@@ -0,0 +1,146 @@
+"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.GitHubProvider = void 0;
+const result_1 = require("@backendkit-labs/result");
+const parse_md_skill_1 = require("../parse-md-skill");
+const yaml = __importStar(require("yaml"));
+const SKILL_FILE_RE = /\.(ya?ml|md)$/i;
+/**
+ * Fetches skill packs from GitHub repositories.
+ * Looks for skill files in a /skills subfolder first, then the repo root.
+ * Supports both .yaml/.yml and .md (with frontmatter) skill files.
+ *
+ * Accepted source formats:
+ *   https://github.com/{owner}/{repo}
+ *   https://github.com/{owner}/{repo}.git
+ */
+class GitHubProvider {
+    appName;
+    id = 'github';
+    constructor(appName = 'agent') {
+        this.appName = appName;
+    }
+    canHandle(source) {
+        return /^https?:\/\/github\.com\//i.test(source);
+    }
+    async fetch(source, options) {
+        const match = source.match(/github\.com\/([^/]+)\/([^/?#]+)/i);
+        if (!match)
+            throw new Error(`Invalid GitHub URL: ${source}`);
+        const [, owner, repo] = match;
+        const cleanRepo = repo.replace(/\.git$/, '');
+        for (const folder of ['skills', '']) {
+            const apiUrl = `https://api.github.com/repos/${owner}/${cleanRepo}/contents/${folder}`;
+            const files = await this.listSkillFiles(apiUrl);
+            if (files.length > 0) {
+                return this.downloadAndParse(files, options?.skill);
+            }
+        }
+        return [];
+    }
+    async listSkillFiles(apiUrl) {
+        let res;
+        try {
+            res = await fetch(apiUrl, {
+                headers: {
+                    Accept: 'application/vnd.github.v3+json',
+                    'User-Agent': this.appName,
+                },
+            });
+        }
+        catch (e) {
+            throw new Error(`Network error reaching GitHub API: ${String(e)}`);
+        }
+        if (res.status === 404)
+            return [];
+        if (!res.ok)
+            throw new Error(`GitHub API error ${res.status}: ${apiUrl}`);
+        const data = (0, result_1.fromThrowable)(() => res.json());
+        if (!(0, result_1.isOk)(data))
+            return [];
+        const items = await data.value;
+        if (!Array.isArray(items))
+            return [];
+        return items
+            .filter(f => f['type'] === 'file' && typeof f['name'] === 'string' && SKILL_FILE_RE.test(f['name']))
+            .map(f => ({ name: f['name'], download_url: f['download_url'] }));
+    }
+    async downloadAndParse(files, onlySkill) {
+        const results = await Promise.allSettled(files.map(async (file) => {
+            let res;
+            try {
+                res = await fetch(file.download_url);
+            }
+            catch (e) {
+                throw new Error(`Network error fetching ${file.name}: ${String(e)}`);
+            }
+            if (!res.ok)
+                throw new Error(`Failed to download ${file.name}: HTTP ${res.status}`);
+            const text = await res.text();
+            const skill = /\.md$/i.test(file.name)
+                ? (0, parse_md_skill_1.parseMdSkill)(text)
+                : parseYamlSkill(text);
+            if (!skill)
+                throw new Error(`Invalid skill file: ${file.name}`);
+            if (onlySkill && skill.name !== onlySkill)
+                return null;
+            return skill;
+        }));
+        const skills = [];
+        const errors = [];
+        for (const r of results) {
+            if (r.status === 'rejected')
+                errors.push(String(r.reason));
+            else if (r.value != null)
+                skills.push(r.value);
+        }
+        if (errors.length > 0 && skills.length === 0) {
+            throw new Error(`All skill downloads failed:\n${errors.join('\n')}`);
+        }
+        return skills;
+    }
+}
+exports.GitHubProvider = GitHubProvider;
+function parseYamlSkill(text) {
+    const parsed = (0, result_1.fromThrowable)(() => yaml.parse(text));
+    if (!parsed.ok || !parsed.value?.name)
+        return null;
+    const skill = parsed.value;
+    if (!Array.isArray(skill.triggers))
+        skill.triggers = [];
+    return skill;
+}
+//# sourceMappingURL=github.js.map

package/dist/skills/providers/github.js.map

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

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

@@ -0,0 +1,6 @@
+export { GitHubProvider } from './github';
+export { LocalProvider } from './local';
+export { SkillsShProvider } from './skills-sh';
+export { ObsidianProvider } from './obsidian';
+export type { SkillSourceProvider, FetchOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/skills/providers/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObsidianProvider = exports.SkillsShProvider = exports.LocalProvider = exports.GitHubProvider = void 0;
+var github_1 = require("./github");
+Object.defineProperty(exports, "GitHubProvider", { enumerable: true, get: function () { return github_1.GitHubProvider; } });
+var local_1 = require("./local");
+Object.defineProperty(exports, "LocalProvider", { enumerable: true, get: function () { return local_1.LocalProvider; } });
+var skills_sh_1 = require("./skills-sh");
+Object.defineProperty(exports, "SkillsShProvider", { enumerable: true, get: function () { return skills_sh_1.SkillsShProvider; } });
+var obsidian_1 = require("./obsidian");
+Object.defineProperty(exports, "ObsidianProvider", { enumerable: true, get: function () { return obsidian_1.ObsidianProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/skills/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/providers/index.ts"],"names":[],"mappings":";;;AAAA,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AACtB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA"}

package/dist/skills/providers/local.d.ts

@@ -0,0 +1,16 @@
+import type { Skill } from '../types';
+import type { FetchOptions, SkillSourceProvider } from './types';
+/**
+ * Fetches skills from a local filesystem directory.
+ * Supports both .yaml/.yml and .md (with frontmatter) skill files.
+ *
+ * Accepted source formats:
+ *   /absolute/path/to/skills
+ *   ./relative/path/to/skills
+ */
+export declare class LocalProvider implements SkillSourceProvider {
+    readonly id = "local";
+    canHandle(source: string): boolean;
+    fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/skills/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/local.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIjE;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACrD,QAAQ,CAAC,EAAE,WAAW;IAEtB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAuBxE"}

package/dist/skills/providers/local.js

@@ -0,0 +1,91 @@
+"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.LocalProvider = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("yaml"));
+const result_1 = require("@backendkit-labs/result");
+const parse_md_skill_1 = require("../parse-md-skill");
+const SKILL_FILE_RE = /\.(ya?ml|md)$/i;
+/**
+ * Fetches skills from a local filesystem directory.
+ * Supports both .yaml/.yml and .md (with frontmatter) skill files.
+ *
+ * Accepted source formats:
+ *   /absolute/path/to/skills
+ *   ./relative/path/to/skills
+ */
+class LocalProvider {
+    id = 'local';
+    canHandle(source) {
+        return source.startsWith('/') || source.startsWith('.') || /^[A-Za-z]:[/\\]/.test(source);
+    }
+    async fetch(source, options) {
+        const dir = path.resolve(source);
+        const filesResult = await (0, result_1.run)(() => fs.readdir(dir));
+        if (!(0, result_1.isOk)(filesResult))
+            throw new Error(`Cannot read directory: ${dir}`);
+        const skills = [];
+        for (const file of filesResult.value) {
+            if (!SKILL_FILE_RE.test(file))
+                continue;
+            const filePath = path.join(dir, file);
+            const contentResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
+            if (!(0, result_1.isOk)(contentResult))
+                continue;
+            const skill = /\.md$/i.test(file)
+                ? (0, parse_md_skill_1.parseMdSkill)(contentResult.value)
+                : parseYamlSkill(contentResult.value);
+            if (!skill?.name)
+                continue;
+            if (options?.skill && skill.name !== options.skill)
+                continue;
+            skills.push(skill);
+        }
+        return skills;
+    }
+}
+exports.LocalProvider = LocalProvider;
+function parseYamlSkill(text) {
+    const parsed = (0, result_1.fromThrowable)(() => yaml.parse(text));
+    if (!parsed.ok || !parsed.value?.name)
+        return null;
+    const skill = parsed.value;
+    if (!Array.isArray(skill.triggers))
+        skill.triggers = [];
+    return skill;
+}
+//# sourceMappingURL=local.js.map

package/dist/skills/providers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../src/skills/providers/local.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAC7B,2CAA6B;AAC7B,oDAAmE;AACnE,sDAAiD;AAIjD,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAa,aAAa;IACb,EAAE,GAAG,OAAO,CAAC;IAEtB,SAAS,CAAC,MAAc;QACpB,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAsB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,IAAA,aAAI,EAAC,WAAW,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;QAEzE,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,aAAa,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,IAAA,aAAI,EAAC,aAAa,CAAC;gBAAE,SAAS;YAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC7B,CAAC,CAAC,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC;gBACnC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,CAAC,KAAK,EAAE,IAAI;gBAAE,SAAS;YAC3B,IAAI,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK;gBAAE,SAAS;YAC7D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA9BD,sCA8BC;AAED,SAAS,cAAc,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;IACxD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/skills/providers/obsidian.d.ts

@@ -0,0 +1,31 @@
+import type { Skill } from '../types';
+import type { FetchOptions, SkillSourceProvider } from './types';
+/**
+ * Fetches skills from an Obsidian vault.
+ * Skills are .md files with YAML frontmatter stored inside the vault.
+ *
+ * Source format:
+ *   obsidian:///path/to/vault                         — scans vault root, filters by tag='skill'
+ *   obsidian:///path/to/vault?folder=Coding/Skills    — scans folder, filters by tag='skill'
+ *   obsidian:///path/to/vault?tag=agent-skill         — custom tag, scans vault root
+ *   obsidian:///path/to/vault?folder=Skills&tag=      — folder only, no tag filter (tag= empty)
+ *
+ * Tag filter is always active (default: 'skill') unless explicitly disabled with ?tag= (empty).
+ * This prevents loading every .md in the vault accidentally.
+ *
+ * On Windows, use forward slashes:
+ *   obsidian:///C:/Users/name/Obsidian Vault?folder=Skills
+ */
+export declare class ObsidianProvider implements SkillSourceProvider {
+    readonly id = "obsidian";
+    canHandle(source: string): boolean;
+    fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
+    private parseSource;
+    private collectMdFiles;
+    /**
+     * Checks whether a file's frontmatter tags array includes the target tag.
+     * Handles both inline (`tags: [a, b]`) and block (`tags:\n  - a`) YAML formats.
+     */
+    private hasTag;
+}
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/skills/providers/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/obsidian.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IACxD,QAAQ,CAAC,EAAE,cAAc;IAEzB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA0BrE,OAAO,CAAC,WAAW;YAsBL,cAAc;IAiB5B;;;OAGG;IACH,OAAO,CAAC,MAAM;CAajB"}

package/dist/skills/providers/obsidian.js

@@ -0,0 +1,141 @@
+"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.ObsidianProvider = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("yaml"));
+const result_1 = require("@backendkit-labs/result");
+const parse_md_skill_1 = require("../parse-md-skill");
+/**
+ * Fetches skills from an Obsidian vault.
+ * Skills are .md files with YAML frontmatter stored inside the vault.
+ *
+ * Source format:
+ *   obsidian:///path/to/vault                         — scans vault root, filters by tag='skill'
+ *   obsidian:///path/to/vault?folder=Coding/Skills    — scans folder, filters by tag='skill'
+ *   obsidian:///path/to/vault?tag=agent-skill         — custom tag, scans vault root
+ *   obsidian:///path/to/vault?folder=Skills&tag=      — folder only, no tag filter (tag= empty)
+ *
+ * Tag filter is always active (default: 'skill') unless explicitly disabled with ?tag= (empty).
+ * This prevents loading every .md in the vault accidentally.
+ *
+ * On Windows, use forward slashes:
+ *   obsidian:///C:/Users/name/Obsidian Vault?folder=Skills
+ */
+class ObsidianProvider {
+    id = 'obsidian';
+    canHandle(source) {
+        return source.startsWith('obsidian://');
+    }
+    async fetch(source, options) {
+        const { vaultPath, folder, tag } = this.parseSource(source);
+        const scanDir = folder
+            ? path.join(vaultPath, ...folder.split('/'))
+            : vaultPath;
+        const mdFiles = await this.collectMdFiles(scanDir);
+        const skills = [];
+        for (const filePath of mdFiles) {
+            const contentResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
+            if (!(0, result_1.isOk)(contentResult))
+                continue;
+            const skill = (0, parse_md_skill_1.parseMdSkill)(contentResult.value);
+            if (!skill?.name || !Array.isArray(skill.triggers))
+                continue;
+            if (tag && !this.hasTag(contentResult.value, tag))
+                continue;
+            if (options?.skill && skill.name !== options.skill)
+                continue;
+            skills.push(skill);
+        }
+        return skills;
+    }
+    parseSource(source) {
+        const withoutScheme = source.replace(/^obsidian:\/\//, '');
+        const [rawPath, queryString] = withoutScheme.split('?');
+        // Normalize Windows paths: /C:/Users/... → C:/Users/...
+        const vaultPath = path.normalize(rawPath.startsWith('/') && /^\/[A-Za-z]:/.test(rawPath)
+            ? rawPath.slice(1)
+            : rawPath);
+        const params = new URLSearchParams(queryString ?? '');
+        const folder = params.get('folder') ?? undefined;
+        const tagParam = params.get('tag');
+        // Tag filter is always on by default.
+        // Disable explicitly with ?tag= (empty string) when using folder as the scope.
+        const tag = tagParam === null ? 'skill' : (tagParam || undefined);
+        return { vaultPath, folder, tag };
+    }
+    async collectMdFiles(dir) {
+        const entriesResult = await (0, result_1.run)(() => fs.readdir(dir, { withFileTypes: true }));
+        if (!(0, result_1.isOk)(entriesResult))
+            return [];
+        const files = [];
+        for (const entry of entriesResult.value) {
+            if (entry.name.startsWith('.'))
+                continue; // skip .obsidian, .trash, etc.
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...await this.collectMdFiles(fullPath));
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                files.push(fullPath);
+            }
+        }
+        return files;
+    }
+    /**
+     * Checks whether a file's frontmatter tags array includes the target tag.
+     * Handles both inline (`tags: [a, b]`) and block (`tags:\n  - a`) YAML formats.
+     */
+    hasTag(content, tag) {
+        const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+        if (!frontmatterMatch)
+            return false;
+        try {
+            const parsed = yaml.parse(frontmatterMatch[1]);
+            const tags = parsed?.tags;
+            if (Array.isArray(tags))
+                return tags.map(String).includes(tag);
+            if (typeof tags === 'string')
+                return tags === tag;
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.ObsidianProvider = ObsidianProvider;
+//# sourceMappingURL=obsidian.js.map

package/dist/skills/providers/obsidian.js.map

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

package/dist/skills/providers/skills-sh.d.ts

@@ -0,0 +1,32 @@
+import type { FetchOptions, SkillSourceProvider } from './types';
+import type { Skill } from '../types';
+/**
+ * Fetches skills from the skills.sh registry.
+ *
+ * skills.sh is a discovery directory — actual skill files live on GitHub.
+ * This provider resolves a skills.sh URL to its underlying GitHub repo
+ * and delegates fetching to GitHubProvider.
+ *
+ * Accepted source formats:
+ *   https://skills.sh/{owner}/{repo}              — fetch all skills from the repo
+ *   https://www.skills.sh/{owner}/{repo}          — same (www prefix)
+ *   https://skills.sh/{owner}/{repo}/{skill-name} — fetch a specific skill
+ *
+ * Example:
+ *   https://skills.sh/vercel-labs/skills
+ *   → resolves to https://github.com/vercel-labs/skills
+ *   → GitHubProvider fetches skill files from the /skills folder or root
+ */
+export declare class SkillsShProvider implements SkillSourceProvider {
+    readonly id = "skills-sh";
+    private readonly github;
+    constructor(appName?: string);
+    canHandle(source: string): boolean;
+    fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
+    /**
+     * Maps https://skills.sh/{owner}/{repo}/{skill?}
+     * to   https://github.com/{owner}/{repo}
+     */
+    private resolveToGitHub;
+}
+//# sourceMappingURL=skills-sh.d.ts.map

package/dist/skills/providers/skills-sh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-sh.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/skills-sh.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IACxD,QAAQ,CAAC,EAAE,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,OAAO,SAAU;IAI7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOrE;;;OAGG;IACH,OAAO,CAAC,eAAe;CAS1B"}

package/dist/skills/providers/skills-sh.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillsShProvider = void 0;
+const github_1 = require("./github");
+/**
+ * Fetches skills from the skills.sh registry.
+ *
+ * skills.sh is a discovery directory — actual skill files live on GitHub.
+ * This provider resolves a skills.sh URL to its underlying GitHub repo
+ * and delegates fetching to GitHubProvider.
+ *
+ * Accepted source formats:
+ *   https://skills.sh/{owner}/{repo}              — fetch all skills from the repo
+ *   https://www.skills.sh/{owner}/{repo}          — same (www prefix)
+ *   https://skills.sh/{owner}/{repo}/{skill-name} — fetch a specific skill
+ *
+ * Example:
+ *   https://skills.sh/vercel-labs/skills
+ *   → resolves to https://github.com/vercel-labs/skills
+ *   → GitHubProvider fetches skill files from the /skills folder or root
+ */
+class SkillsShProvider {
+    id = 'skills-sh';
+    github;
+    constructor(appName = 'agent') {
+        this.github = new github_1.GitHubProvider(appName);
+    }
+    canHandle(source) {
+        return /^https?:\/\/(www\.)?skills\.sh\//i.test(source);
+    }
+    async fetch(source, options) {
+        const { githubUrl, skillName } = this.resolveToGitHub(source);
+        return this.github.fetch(githubUrl, {
+            skill: options?.skill ?? skillName,
+        });
+    }
+    /**
+     * Maps https://skills.sh/{owner}/{repo}/{skill?}
+     * to   https://github.com/{owner}/{repo}
+     */
+    resolveToGitHub(source) {
+        const match = source.match(/skills\.sh\/([^/?#]+)\/([^/?#]+)(?:\/([^/?#]+))?/i);
+        if (!match)
+            throw new Error(`Cannot parse skills.sh URL: ${source}`);
+        const [, owner, repo, skillName] = match;
+        return {
+            githubUrl: `https://github.com/${owner}/${repo}`,
+            skillName: skillName || undefined,
+        };
+    }
+}
+exports.SkillsShProvider = SkillsShProvider;
+//# sourceMappingURL=skills-sh.js.map

package/dist/skills/providers/skills-sh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-sh.js","sourceRoot":"","sources":["../../../src/skills/providers/skills-sh.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAI1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,gBAAgB;IAChB,EAAE,GAAG,WAAW,CAAC;IAET,MAAM,CAAiB;IAExC,YAAY,OAAO,GAAG,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,uBAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,OAAO,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAsB;QAC9C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE;YAChC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS;SACrC,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,MAAc;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO;YACH,SAAS,EAAE,sBAAsB,KAAK,IAAI,IAAI,EAAE;YAChD,SAAS,EAAE,SAAS,IAAI,SAAS;SACpC,CAAC;IACN,CAAC;CACJ;AAjCD,4CAiCC"}

package/dist/skills/providers/types.d.ts

@@ -0,0 +1,25 @@
+import type { Skill } from '../types';
+export interface FetchOptions {
+    /** Only fetch this specific skill by name */
+    skill?: string;
+}
+/**
+ * A pluggable source for skill packs.
+ * Implement this interface to add support for new registries (skills.sh, npm, etc.)
+ * or custom storage (Obsidian vaults, internal wikis, etc.).
+ *
+ * Registration:
+ *   manager.use(new MyProvider())
+ *
+ * Providers are tried in registration order (last registered = highest priority).
+ * The first provider whose canHandle() returns true is used.
+ */
+export interface SkillSourceProvider {
+    /** Unique identifier, e.g. 'github', 'local', 'skills-sh', 'obsidian' */
+    readonly id: string;
+    /** Returns true if this provider knows how to fetch from the given source string */
+    canHandle(source: string): boolean;
+    /** Fetches skills from the source and returns them normalized as Skill[] */
+    fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skills/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,YAAY;IACzB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACnE"}

package/dist/skills/providers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/skills/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/providers/types.ts"],"names":[],"mappings":""}

package/dist/skills/registry.d.ts

@@ -0,0 +1,18 @@
+import type { SkillHandler, SkillExecuteResult } from './types';
+/**
+ * Instance-based skill handler registry.
+ * Not a singleton — each AgentEngine gets its own SkillRegistry,
+ * enabling test isolation and multi-tenant deployments.
+ */
+export declare class SkillRegistry {
+    private readonly handlers;
+    register(name: string, fn: SkillHandler): void;
+    get(name: string): SkillHandler | undefined;
+    has(name: string): boolean;
+    execute(name: string, args: unknown): Promise<SkillExecuteResult>;
+    /** Removes characters that could be used for injection via handler name */
+    sanitizeName(name: string): string;
+    registeredNames(): string[];
+    clear(): void;
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;GAIG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI;IAI9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYvE,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,eAAe,IAAI,MAAM,EAAE;IAI3B,KAAK,IAAI,IAAI;CAGhB"}