opc-agent 4.2.13 → 5.0.0-alpha.1

package/dist/scheduler/cron.js

@@ -0,0 +1,64 @@
+"use strict";
+// v2 cron — lightweight cron-expression scheduler for agent proactive tasks
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronScheduler = void 0;
+class CronScheduler {
+    jobs = new Map();
+    timers = new Map();
+    add(job) {
+        this.jobs.set(job.id, job);
+        if (job.enabled)
+            this.schedule(job);
+    }
+    remove(id) {
+        const timer = this.timers.get(id);
+        if (timer)
+            clearTimeout(timer);
+        this.timers.delete(id);
+        this.jobs.delete(id);
+    }
+    enable(id) {
+        const job = this.jobs.get(id);
+        if (job) {
+            job.enabled = true;
+            this.schedule(job);
+        }
+    }
+    disable(id) {
+        const timer = this.timers.get(id);
+        if (timer)
+            clearTimeout(timer);
+        const job = this.jobs.get(id);
+        if (job)
+            job.enabled = false;
+    }
+    list() {
+        return Array.from(this.jobs.values());
+    }
+    schedule(job) {
+        const ms = nextIntervalMs(job.expression);
+        if (ms === null)
+            return;
+        const timer = setTimeout(async () => {
+            job.lastRunAt = Date.now();
+            try {
+                await job.handler();
+            }
+            catch { /* swallow — caller responsibility */ }
+            if (job.enabled)
+                this.schedule(job);
+        }, ms);
+        this.timers.set(job.id, timer);
+        job.nextRunAt = Date.now() + ms;
+    }
+}
+exports.CronScheduler = CronScheduler;
+function nextIntervalMs(expression) {
+    const match = /^@every\s+(\d+)(s|m|h)$/.exec(expression);
+    if (!match)
+        return null;
+    const n = parseInt(match[1], 10);
+    const unit = match[2];
+    return n * (unit === 's' ? 1000 : unit === 'm' ? 60_000 : 3_600_000);
+}
+//# sourceMappingURL=cron.js.map

package/dist/scheduler/cron.js.map

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

package/dist/schema/oad.d.ts

@@ -70,12 +70,12 @@ export declare const HITLSchema: z.ZodObject<{
     enabled: boolean;
     requireApproval: string[];
     defaultTimeoutMs: number;
-    defaultAction: "approve" | "deny";
+    defaultAction: "deny" | "approve";
 }, {
     enabled?: boolean | undefined;
     requireApproval?: string[] | undefined;
     defaultTimeoutMs?: number | undefined;
-    defaultAction?: "approve" | "deny" | undefined;
+    defaultAction?: "deny" | "approve" | undefined;
 }>;
 export declare const PluginRefSchema: z.ZodObject<{
     name: z.ZodString;
@@ -279,14 +279,14 @@ export declare const MarketplaceSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     certified: boolean;
+    tags?: string[] | undefined;
     category?: string | undefined;
     pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-    tags?: string[] | undefined;
 }, {
+    tags?: string[] | undefined;
     certified?: boolean | undefined;
     category?: string | undefined;
     pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-    tags?: string[] | undefined;
 }>;
 export declare const MetadataSchema: z.ZodObject<{
     name: z.ZodString;
@@ -301,14 +301,14 @@ export declare const MetadataSchema: z.ZodObject<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         certified: boolean;
+        tags?: string[] | undefined;
         category?: string | undefined;
         pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-        tags?: string[] | undefined;
     }, {
+        tags?: string[] | undefined;
         certified?: boolean | undefined;
         category?: string | undefined;
         pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-        tags?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -318,9 +318,9 @@ export declare const MetadataSchema: z.ZodObject<{
     author?: string | undefined;
     marketplace?: {
         certified: boolean;
+        tags?: string[] | undefined;
         category?: string | undefined;
         pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-        tags?: string[] | undefined;
     } | undefined;
 }, {
     name: string;
@@ -329,10 +329,10 @@ export declare const MetadataSchema: z.ZodObject<{
     author?: string | undefined;
     license?: string | undefined;
     marketplace?: {
+        tags?: string[] | undefined;
         certified?: boolean | undefined;
         category?: string | undefined;
         pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-        tags?: string[] | undefined;
     } | undefined;
 }>;
 export declare const RoomSchema: z.ZodObject<{
@@ -858,12 +858,12 @@ export declare const SpecSchema: z.ZodObject<{
         enabled: boolean;
         requireApproval: string[];
         defaultTimeoutMs: number;
-        defaultAction: "approve" | "deny";
+        defaultAction: "deny" | "approve";
     }, {
         enabled?: boolean | undefined;
         requireApproval?: string[] | undefined;
         defaultTimeoutMs?: number | undefined;
-        defaultAction?: "approve" | "deny" | undefined;
+        defaultAction?: "deny" | "approve" | undefined;
     }>>;
     auth: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1036,6 +1036,10 @@ export declare const SpecSchema: z.ZodObject<{
         }[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    streaming: boolean | {
+        enabled: boolean;
+        chunkSize?: number | undefined;
+    };
     model: string;
     skills: {
         name: string;
@@ -1047,14 +1051,6 @@ export declare const SpecSchema: z.ZodObject<{
         port?: number | undefined;
         config?: Record<string, unknown> | undefined;
     }[];
-    streaming: boolean | {
-        enabled: boolean;
-        chunkSize?: number | undefined;
-    };
-    plugins?: {
-        name: string;
-        config?: Record<string, unknown> | undefined;
-    }[] | undefined;
     tools?: {
         builtin?: string[] | undefined;
         mcp?: {
@@ -1064,6 +1060,10 @@ export declare const SpecSchema: z.ZodObject<{
             env?: Record<string, string> | undefined;
         }[] | undefined;
     } | undefined;
+    plugins?: {
+        name: string;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
     provider?: {
         default: string;
         allowed: string[];
@@ -1125,7 +1125,7 @@ export declare const SpecSchema: z.ZodObject<{
         enabled: boolean;
         requireApproval: string[];
         defaultTimeoutMs: number;
-        defaultAction: "approve" | "deny";
+        defaultAction: "deny" | "approve";
     } | undefined;
     telemetry?: {
         enabled: boolean;
@@ -1165,10 +1165,6 @@ export declare const SpecSchema: z.ZodObject<{
         }[] | undefined;
     } | undefined;
 }, {
-    plugins?: {
-        name: string;
-        config?: Record<string, unknown> | undefined;
-    }[] | undefined;
     tools?: {
         builtin?: string[] | undefined;
         mcp?: {
@@ -1178,6 +1174,14 @@ export declare const SpecSchema: z.ZodObject<{
             env?: Record<string, string> | undefined;
         }[] | undefined;
     } | undefined;
+    streaming?: boolean | {
+        enabled?: boolean | undefined;
+        chunkSize?: number | undefined;
+    } | undefined;
+    plugins?: {
+        name: string;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
     model?: string | undefined;
     provider?: {
         default?: string | undefined;
@@ -1238,10 +1242,6 @@ export declare const SpecSchema: z.ZodObject<{
         agents?: string[] | undefined;
         topics?: string[] | undefined;
     } | undefined;
-    streaming?: boolean | {
-        enabled?: boolean | undefined;
-        chunkSize?: number | undefined;
-    } | undefined;
     locale?: "en" | "zh-CN" | undefined;
     workflows?: {
         name: string;
@@ -1254,7 +1254,7 @@ export declare const SpecSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         requireApproval?: string[] | undefined;
         defaultTimeoutMs?: number | undefined;
-        defaultAction?: "approve" | "deny" | undefined;
+        defaultAction?: "deny" | "approve" | undefined;
     } | undefined;
     telemetry?: {
         enabled?: boolean | undefined;
@@ -1310,14 +1310,14 @@ export declare const OADSchema: z.ZodObject<{
             tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             certified: boolean;
+            tags?: string[] | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         }, {
+            tags?: string[] | undefined;
             certified?: boolean | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -1327,9 +1327,9 @@ export declare const OADSchema: z.ZodObject<{
         author?: string | undefined;
         marketplace?: {
             certified: boolean;
+            tags?: string[] | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         } | undefined;
     }, {
         name: string;
@@ -1338,10 +1338,10 @@ export declare const OADSchema: z.ZodObject<{
         author?: string | undefined;
         license?: string | undefined;
         marketplace?: {
+            tags?: string[] | undefined;
             certified?: boolean | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         } | undefined;
     }>;
     spec: z.ZodObject<{
@@ -1604,12 +1604,12 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             requireApproval: string[];
             defaultTimeoutMs: number;
-            defaultAction: "approve" | "deny";
+            defaultAction: "deny" | "approve";
         }, {
             enabled?: boolean | undefined;
             requireApproval?: string[] | undefined;
             defaultTimeoutMs?: number | undefined;
-            defaultAction?: "approve" | "deny" | undefined;
+            defaultAction?: "deny" | "approve" | undefined;
         }>>;
         auth: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1782,6 +1782,10 @@ export declare const OADSchema: z.ZodObject<{
             }[] | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        streaming: boolean | {
+            enabled: boolean;
+            chunkSize?: number | undefined;
+        };
         model: string;
         skills: {
             name: string;
@@ -1793,14 +1797,6 @@ export declare const OADSchema: z.ZodObject<{
             port?: number | undefined;
             config?: Record<string, unknown> | undefined;
         }[];
-        streaming: boolean | {
-            enabled: boolean;
-            chunkSize?: number | undefined;
-        };
-        plugins?: {
-            name: string;
-            config?: Record<string, unknown> | undefined;
-        }[] | undefined;
         tools?: {
             builtin?: string[] | undefined;
             mcp?: {
@@ -1810,6 +1806,10 @@ export declare const OADSchema: z.ZodObject<{
                 env?: Record<string, string> | undefined;
             }[] | undefined;
         } | undefined;
+        plugins?: {
+            name: string;
+            config?: Record<string, unknown> | undefined;
+        }[] | undefined;
         provider?: {
             default: string;
             allowed: string[];
@@ -1871,7 +1871,7 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             requireApproval: string[];
             defaultTimeoutMs: number;
-            defaultAction: "approve" | "deny";
+            defaultAction: "deny" | "approve";
         } | undefined;
         telemetry?: {
             enabled: boolean;
@@ -1911,10 +1911,6 @@ export declare const OADSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
     }, {
-        plugins?: {
-            name: string;
-            config?: Record<string, unknown> | undefined;
-        }[] | undefined;
         tools?: {
             builtin?: string[] | undefined;
             mcp?: {
@@ -1924,6 +1920,14 @@ export declare const OADSchema: z.ZodObject<{
                 env?: Record<string, string> | undefined;
             }[] | undefined;
         } | undefined;
+        streaming?: boolean | {
+            enabled?: boolean | undefined;
+            chunkSize?: number | undefined;
+        } | undefined;
+        plugins?: {
+            name: string;
+            config?: Record<string, unknown> | undefined;
+        }[] | undefined;
         model?: string | undefined;
         provider?: {
             default?: string | undefined;
@@ -1984,10 +1988,6 @@ export declare const OADSchema: z.ZodObject<{
             agents?: string[] | undefined;
             topics?: string[] | undefined;
         } | undefined;
-        streaming?: boolean | {
-            enabled?: boolean | undefined;
-            chunkSize?: number | undefined;
-        } | undefined;
         locale?: "en" | "zh-CN" | undefined;
         workflows?: {
             name: string;
@@ -2000,7 +2000,7 @@ export declare const OADSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             requireApproval?: string[] | undefined;
             defaultTimeoutMs?: number | undefined;
-            defaultAction?: "approve" | "deny" | undefined;
+            defaultAction?: "deny" | "approve" | undefined;
         } | undefined;
         telemetry?: {
             enabled?: boolean | undefined;
@@ -2049,14 +2049,18 @@ export declare const OADSchema: z.ZodObject<{
         author?: string | undefined;
         marketplace?: {
             certified: boolean;
+            tags?: string[] | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         } | undefined;
     };
     kind: "Agent";
     apiVersion: "opc/v1";
     spec: {
+        streaming: boolean | {
+            enabled: boolean;
+            chunkSize?: number | undefined;
+        };
         model: string;
         skills: {
             name: string;
@@ -2068,14 +2072,6 @@ export declare const OADSchema: z.ZodObject<{
             port?: number | undefined;
             config?: Record<string, unknown> | undefined;
         }[];
-        streaming: boolean | {
-            enabled: boolean;
-            chunkSize?: number | undefined;
-        };
-        plugins?: {
-            name: string;
-            config?: Record<string, unknown> | undefined;
-        }[] | undefined;
         tools?: {
             builtin?: string[] | undefined;
             mcp?: {
@@ -2085,6 +2081,10 @@ export declare const OADSchema: z.ZodObject<{
                 env?: Record<string, string> | undefined;
             }[] | undefined;
         } | undefined;
+        plugins?: {
+            name: string;
+            config?: Record<string, unknown> | undefined;
+        }[] | undefined;
         provider?: {
             default: string;
             allowed: string[];
@@ -2146,7 +2146,7 @@ export declare const OADSchema: z.ZodObject<{
             enabled: boolean;
             requireApproval: string[];
             defaultTimeoutMs: number;
-            defaultAction: "approve" | "deny";
+            defaultAction: "deny" | "approve";
         } | undefined;
         telemetry?: {
             enabled: boolean;
@@ -2194,19 +2194,15 @@ export declare const OADSchema: z.ZodObject<{
         author?: string | undefined;
         license?: string | undefined;
         marketplace?: {
+            tags?: string[] | undefined;
             certified?: boolean | undefined;
             category?: string | undefined;
             pricing?: "free" | "freemium" | "paid" | "enterprise" | undefined;
-            tags?: string[] | undefined;
         } | undefined;
     };
     kind: "Agent";
     apiVersion: "opc/v1";
     spec: {
-        plugins?: {
-            name: string;
-            config?: Record<string, unknown> | undefined;
-        }[] | undefined;
         tools?: {
             builtin?: string[] | undefined;
             mcp?: {
@@ -2216,6 +2212,14 @@ export declare const OADSchema: z.ZodObject<{
                 env?: Record<string, string> | undefined;
             }[] | undefined;
         } | undefined;
+        streaming?: boolean | {
+            enabled?: boolean | undefined;
+            chunkSize?: number | undefined;
+        } | undefined;
+        plugins?: {
+            name: string;
+            config?: Record<string, unknown> | undefined;
+        }[] | undefined;
         model?: string | undefined;
         provider?: {
             default?: string | undefined;
@@ -2276,10 +2280,6 @@ export declare const OADSchema: z.ZodObject<{
             agents?: string[] | undefined;
             topics?: string[] | undefined;
         } | undefined;
-        streaming?: boolean | {
-            enabled?: boolean | undefined;
-            chunkSize?: number | undefined;
-        } | undefined;
         locale?: "en" | "zh-CN" | undefined;
         workflows?: {
             name: string;
@@ -2292,7 +2292,7 @@ export declare const OADSchema: z.ZodObject<{
             enabled?: boolean | undefined;
             requireApproval?: string[] | undefined;
             defaultTimeoutMs?: number | undefined;
-            defaultAction?: "approve" | "deny" | undefined;
+            defaultAction?: "deny" | "approve" | undefined;
         } | undefined;
         telemetry?: {
             enabled?: boolean | undefined;

package/dist/skills/loader.d.ts

@@ -0,0 +1,16 @@
+import type { SkillConfig, SkillDefinition } from '../core/types';
+export interface LoadedSkill {
+    config: SkillConfig;
+    module: unknown;
+    loadedAt: number;
+}
+export declare function loadSkill(config: SkillConfig): Promise<LoadedSkill>;
+export declare function loadAllSkills(configs: SkillConfig[]): Promise<LoadedSkill[]>;
+export declare function loadSkillIndex(dirs: string[]): Promise<{
+    name: string;
+    description: string;
+    path: string;
+}[]>;
+export declare function loadSkillFull(skillPath: string): Promise<SkillDefinition>;
+export declare function loadSkillReference(skillDir: string, refPath: string): Promise<string>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIlE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAQzE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAOlF;AAKD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAchE;AAGD,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAG/E;AAGD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3F"}

package/dist/skills/loader.js

@@ -0,0 +1,114 @@
+"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.loadSkill = loadSkill;
+exports.loadAllSkills = loadAllSkills;
+exports.loadSkillIndex = loadSkillIndex;
+exports.loadSkillFull = loadSkillFull;
+exports.loadSkillReference = loadSkillReference;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function loadSkill(config) {
+    const resolvedPath = path.isAbsolute(config.path)
+        ? config.path
+        : path.resolve(process.cwd(), config.path);
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mod = await Promise.resolve(`${resolvedPath}`).then(s => __importStar(require(s)));
+    return { config, module: mod, loadedAt: Date.now() };
+}
+async function loadAllSkills(configs) {
+    const results = [];
+    for (const config of configs) {
+        if (config.enabled === false)
+            continue;
+        results.push(await loadSkill(config));
+    }
+    return results;
+}
+// --- L0/L1/L2 progressive markdown skill loader ---
+// L0: load name + description index only (~3k tokens)
+async function loadSkillIndex(dirs) {
+    const index = [];
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        const files = await fs.promises.readdir(dir, { recursive: true });
+        for (const file of files) {
+            if (!String(file).endsWith('.md'))
+                continue;
+            const fullPath = path.join(dir, String(file));
+            const content = await fs.promises.readFile(fullPath, 'utf-8');
+            const { name, description } = parseSkillFrontmatter(content);
+            if (name)
+                index.push({ name, description: description || '', path: fullPath });
+        }
+    }
+    return index;
+}
+// L1: load full skill definition from a markdown file
+async function loadSkillFull(skillPath) {
+    const content = await fs.promises.readFile(skillPath, 'utf-8');
+    return parseSkillContent(content);
+}
+// L2: load an external file referenced by a skill
+async function loadSkillReference(skillDir, refPath) {
+    return fs.promises.readFile(path.join(skillDir, refPath), 'utf-8');
+}
+function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return { name: '', description: '' };
+    const yaml = match[1];
+    const name = yaml.match(/name:\s*(.+)/)?.[1]?.trim() ?? '';
+    const description = yaml.match(/description:\s*['"]?(.+?)['"]?\s*$/m)?.[1]?.trim() ?? '';
+    return { name, description };
+}
+function parseSkillContent(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    const yaml = match?.[1] ?? '';
+    const body = match?.[2] ?? content;
+    const name = yaml.match(/name:\s*(.+)/)?.[1]?.trim() ?? '';
+    const description = yaml.match(/description:\s*['"]?(.+?)['"]?\s*$/m)?.[1]?.trim() ?? '';
+    const triggersMatch = yaml.match(/triggers:\s*\[([^\]]*)\]/);
+    const triggers = triggersMatch
+        ? triggersMatch[1].split(',').map((t) => t.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean)
+        : [];
+    const referencesMatch = yaml.match(/references:\s*\[([^\]]*)\]/);
+    const references = referencesMatch
+        ? referencesMatch[1].split(',').map((r) => r.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean)
+        : [];
+    return { name, description, triggers, content: body.trim(), references };
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/matcher.d.ts

@@ -0,0 +1,18 @@
+import type { SkillConfig } from '../core/types';
+export interface MatchResult {
+    skill: SkillConfig;
+    score: number;
+    reason: string;
+}
+export declare function matchSkills(message: string, skills: SkillConfig[]): Promise<MatchResult[]>;
+export declare function matchSkillIndex(query: string, index: {
+    name: string;
+    description: string;
+    path: string;
+}[], topK?: number): {
+    name: string;
+    path: string;
+    score: number;
+}[];
+export declare function topMatch(results: MatchResult[], threshold?: number): MatchResult | null;
+//# sourceMappingURL=matcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/skills/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAUxB;AAGD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC5D,IAAI,SAAI,GACP;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CA0BjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,SAAM,GAAG,WAAW,GAAG,IAAI,CAGpF"}