@agenticforge/skills 1.1.2 → 1.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDispatcher.d.ts","sourceRoot":"","sources":["../../src/SkillDispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAcrD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;gBAEjC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B;IAQzF;;;;;;OAMG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAgB/D;;;OAGG;IACH,OAAO,CAAC,SAAS;IAcjB;;;OAGG;YACW,QAAQ;CAgBvB"}

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

@@ -1 +1 @@
-{"version":3,"file":"SkillLoader.d.ts","sourceRoot":"","sources":["../../src/SkillLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAM9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;WACU,aAAa,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAM,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC;IAwC3B;;OAEG;WACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAerE;;;OAGG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,GAClD,aAAa,EAAE;IAMlB;;;OAGG;IACH,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,WAAW,EAAE,EACrB,gBAAgB,CAAC,EAAE,aAAa,GAC/B,aAAa;IAQhB;;OAEG;WACU,qBAAqB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;CAI1B"}
+{"version":3,"file":"SkillLoader.d.ts","sourceRoot":"","sources":["../../src/SkillLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;WACU,aAAa,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,OAAO,CAAC,aAAa,EAAE,CAAC;IA4C3B;;OAEG;WACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAerE;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,aAAa,EAAE;IAI1F;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,gBAAgB,CAAC,EAAE,aAAa,GAAG,aAAa;IAQzF;;OAEG;WACU,qBAAqB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC,aAAa,CAAC;CAI1B"}

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

@@ -1 +1 @@
-{"version":3,"file":"SkillRegistry.d.ts","sourceRoot":"","sources":["../../src/SkillRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAGzC;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIhB,GAAG,IAAI,WAAW,EAAE;IAIpB,0DAA0D;IAC1D,OAAO,IAAI,WAAW,EAAE;IAIxB,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,WAAW,IAAI,MAAM;CAatB"}
+{"version":3,"file":"SkillRegistry.d.ts","sourceRoot":"","sources":["../../src/SkillRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIhB,GAAG,IAAI,WAAW,EAAE;IAIpB,0DAA0D;IAC1D,OAAO,IAAI,WAAW,EAAE;IAIxB,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,WAAW,IAAI,MAAM;CAatB"}

package/dist/types/SkillRunner.d.ts

@@ -1,29 +1,19 @@
-import type { LLMClient } from "@agenticforge/core";
+import type { LLMClient, Config } from "@agenticforge/core";
 import type { IAgentSkill, SkillResult } from "./types";
 import { SkillRegistry } from "./SkillRegistry";
+import type { SkillDispatcherOptions } from "./SkillDispatcher";
 /**
- * A lightweight, framework-independent Skill runner.
+ * 轻量、框架无关的 Skill 编排器。
  *
- * Unlike the `SkillAgent` in `@agenticforge/agents` (which extends `Agent`),
- * this class is a standalone orchestrator that does NOT depend on the agents
- * package — making it usable in any context.
+ * 与 `SkillAgent`（继承自 `Agent` 基类）不同，
+ * `SkillRunner` 不依赖 `@agenticforge/agents`，可在任何上下文中使用。
  *
- * Architecture:
- * ```
- * User query
- *     │
- *     ▼
- * SkillRunner.run()
- *     │
- *     ├─ skillName provided ──► execute named Skill directly
- *     ├─ 1 Skill registered ──► execute that Skill directly
- *     └─ N Skills            ──► LLM routing → execute matched Skill
- * ```
+ * 路由逻辑完全委托给 `SkillDispatcher`：
+ *   1. 规则路由（triggerHint 关键词，零 LLM 开销）
+ *   2. LLM 路由（兜底）
  *
- * Example:
+ * @example
  * ```ts
- * import { SkillRunner, AgentSkill } from "@agenticforge/skills";
- *
  * const runner = new SkillRunner({
  *   llm: myLLMClient,
  *   skills: [weatherSkill, stockSkill],
@@ -31,25 +21,30 @@ import { SkillRegistry } from "./SkillRegistry";
  *
  * const result = await runner.run("东京今天下雨吗？");
  * console.log(result.output);
+ *
+ * // 直接调用指定 Skill，跳过路由
+ * const result2 = await runner.runSkill("stock", "AAPL 现在多少钱？");
  * ```
  */
 export declare class SkillRunner {
     readonly skillRegistry: SkillRegistry;
     private readonly llm;
     private readonly fallbackPrompt;
-    private readonly routerPromptTemplate;
+    private readonly dispatcher;
     constructor(params: {
         llm: LLMClient;
+        config?: Config;
         skills?: IAgentSkill[];
         fallbackPrompt?: string;
-        routerPromptTemplate?: string;
+        /** 传给 SkillDispatcher 的路由选项 */
+        dispatcher?: SkillDispatcherOptions;
     });
     addSkill(skill: IAgentSkill): void;
     removeSkill(name: string): boolean;
     listSkills(): string[];
-    private routeToSkill;
     /**
-     * Run: auto-route to the best Skill and execute it.
+     * 自动路由到最匹配的 Skill 并执行。
+     * 未命中时 fallback 到纯 LLM 调用。
      */
     run(query: string, options?: {
         skillName?: string;
@@ -60,7 +55,7 @@ export declare class SkillRunner {
         }>;
     }): Promise<SkillResult>;
     /**
-     * Directly invoke a named Skill and return the full SkillResult.
+     * 直接调用指定 Skill，跳过路由。
      */
     runSkill(skillName: string, query: string, options?: {
         metadata?: Record<string, unknown>;
@@ -69,5 +64,6 @@ export declare class SkillRunner {
             content: string;
         }>;
     }): Promise<SkillResult>;
+    private resolveSkill;
 }
 //# sourceMappingURL=SkillRunner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SkillRunner.d.ts","sourceRoot":"","sources":["../../src/SkillRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAS,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAC,WAAW,EAAgB,WAAW,EAAC,MAAM,SAAS,CAAC;AACpE,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAM9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,MAAM,EAAE;QAClB,GAAG,EAAE,SAAS,CAAC;QACf,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B;IA4BD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,UAAU,IAAI,MAAM,EAAE;YAQR,YAAY;IAsB1B;;OAEG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC3E,GACA,OAAO,CAAC,WAAW,CAAC;IAgCvB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC3E,GACA,OAAO,CAAC,WAAW,CAAC;CAGxB"}
+{"version":3,"file":"SkillRunner.d.ts","sourceRoot":"","sources":["../../src/SkillRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAgB,WAAW,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAMhE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAEjC,MAAM,EAAE;QAClB,GAAG,EAAE,SAAS,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,+BAA+B;QAC/B,UAAU,CAAC,EAAE,sBAAsB,CAAC;KACrC;IAgBD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,UAAU,IAAI,MAAM,EAAE;IAQtB;;;OAGG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7E,GACA,OAAO,CAAC,WAAW,CAAC;IAuBvB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7E,GACA,OAAO,CAAC,WAAW,CAAC;YAQT,YAAY;CAW3B"}

package/dist/types/SkillTool.d.ts

@@ -0,0 +1,105 @@
+import { Tool } from "@agenticforge/tools";
+import type { ToolParameter } from "@agenticforge/tools";
+import type { LLMClient } from "@agenticforge/core";
+import type { IAgentSkill, SkillResult } from "./types";
+/**
+ * 将任意 `IAgentSkill` 包装成 `Tool`，使其可以注册进 `ToolRegistry`，
+ * 供 `FunctionCallAgent`、`ReActAgent` 等所有基于工具调用的 Agent 使用。
+ *
+ * ### 渐进式披露
+ * `run()` 返回的字符串末尾会附加 `[tools_used: ...]` 元数据行（当 skill
+ * 内部使用了工具时），调用方可选择性解析。需要完整结构化结果时，
+ * 使用 `runSkill()` 方法，它返回原始 `SkillResult`。
+ *
+ * ### 缓存
+ * 构造时传入 `cacheSize` 启用 LRU 缓存。相同 query 的重复调用直接命中缓存，
+ * 不再触发 LLM 调用。适合无副作用的 Markdown Skill 或查询类 Skill。
+ *
+ * @example
+ * ```ts
+ * import { SkillTool, skillsToTools } from "@agenticforge/skills";
+ * import { ToolRegistry } from "@agenticforge/tools";
+ * import { FunctionCallAgent, LLMClient } from "@agenticforge/kit";
+ *
+ * const llm = new LLMClient({ provider: "openai", model: "gpt-4o" });
+ * const skills = await SkillLoader.fromDirectory(".cursor/skills");
+ *
+ * const registry = new ToolRegistry();
+ * // 启用缓存：最多缓存 50 条结果
+ * for (const skill of skills) {
+ *   registry.registerTool(new SkillTool(skill, llm, { cacheSize: 50 }));
+ * }
+ * registry.registerTool(new SearchTool()); // 普通 Tool 混用
+ *
+ * // 任意 Agent 都可以用，不再需要 SkillAgent
+ * const agent = new FunctionCallAgent({ name: "agent", llm, tools: registry.getAll() });
+ * ```
+ */
+export declare class SkillTool extends Tool {
+    private readonly skill;
+    private readonly llm;
+    /** LRU 缓存：query → output，undefined 表示未启用 */
+    private readonly cache?;
+    /**
+     * @param skill      要包装的 Skill 实例
+     * @param llm        LLM 客户端，注入给 skill.execute()
+     * @param options    可选配置
+     * @param options.cacheSize  启用 LRU 缓存并设置最大条目数（默认不缓存）
+     */
+    constructor(skill: IAgentSkill, llm: LLMClient, options?: {
+        /** 启用结果缓存，指定最大缓存条目数。适合无副作用的查询类 Skill。 */
+        cacheSize?: number;
+    });
+    getParameters(): ToolParameter[];
+    /**
+     * 执行 Skill 并返回字符串结果。
+     *
+     * - 缓存命中时直接返回，不调用 LLM
+     * - Skill 内部使用了工具时，输出末尾附加 `[tools_used: ...]` 元数据行
+     * - 发生异常时返回 `Error: ...` 字符串，不抛出（保护 Agent 循环不崩溃）
+     */
+    run(parameters: Record<string, unknown>): Promise<string>;
+    /**
+     * 执行 Skill 并返回完整的 `SkillResult`（渐进式披露的结构化入口）。
+     * 不经过缓存，不格式化输出，适合需要访问 `toolsUsed`、`data` 的场景。
+     */
+    runSkill(query: string): Promise<SkillResult>;
+    /**
+     * 返回被包装的原始 Skill 实例。
+     * 用于在需要访问 Skill 元数据时（如 triggerHint、systemPrompt）直接访问。
+     */
+    getSkill(): IAgentSkill;
+    /**
+     * 返回缓存统计信息。未启用缓存时返回 null。
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    } | null;
+    /**
+     * 清空缓存。
+     */
+    clearCache(): void;
+    /**
+     * 格式化 SkillResult 为字符串。
+     * 渐进式披露：若 skill 内部使用了工具，附加 tools_used 元数据行。
+     * 调用方可通过解析 `[tools_used: ...]` 获取执行链路信息。
+     */
+    private formatOutput;
+}
+/**
+ * 将一组 Skill 批量转换为 SkillTool 数组，方便直接传给 ToolRegistry 或 Agent。
+ *
+ * @example
+ * ```ts
+ * const skills = await SkillLoader.fromDirectory(".cursor/skills");
+ * const tools = skillsToTools(skills, llm, { cacheSize: 50 });
+ *
+ * const registry = new ToolRegistry();
+ * tools.forEach(t => registry.registerTool(t));
+ * ```
+ */
+export declare function skillsToTools(skills: IAgentSkill[], llm: LLMClient, options?: {
+    cacheSize?: number;
+}): SkillTool[];
+//# sourceMappingURL=SkillTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkillTool.d.ts","sourceRoot":"","sources":["../../src/SkillTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAgB,WAAW,EAAE,MAAM,SAAS,CAAC;AAMtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,SAAU,SAAQ,IAAI;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAmB;IAE1C;;;;;OAKG;gBAED,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE;QACR,yCAAyC;QACzC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAgBH,aAAa,IAAI,aAAa,EAAE;IAYhC;;;;;;OAMG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B/D;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOnD;;;OAGG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAKxD;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAMrB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,SAAS,EAAE,CAEb"}

package/dist/types/index.d.ts

@@ -4,4 +4,6 @@ export * from "./SkillRegistry";
 export * from "./SkillRunner";
 export * from "./MarkdownSkill";
 export * from "./SkillLoader";
+export * from "./SkillTool";
+export * from "./SkillDispatcher";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,IAAI,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAM5D,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAC3E;AAMD,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5D;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAM9D,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAMD,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5D;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticforge/skills",
-  "version": "1.1.2",
+  "version": "1.4.0",
   "description": "Agent Skills system for AgenticFORGE - composable, routable agent capability units",
   "type": "module",
   "sideEffects": false,
@@ -26,7 +26,8 @@
   },
   "dependencies": {
     "@agenticforge/core": "workspace:^",
-    "@agenticforge/tools": "workspace:^"
+    "@agenticforge/tools": "workspace:^",
+    "@agenticforge/utils": "workspace:^"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.8",
@@ -35,7 +36,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@types/node": "^25.3.3",
     "rimraf": "^6.0.1",
-    "rollup": "^4.50.1",
+    "rollup": "^4.59.1",
     "rollup-plugin-esbuild": "^6.2.1",
     "tsx": "^4.21.0",
     "typescript": "~5.9.3"