@agenticforge/skills 1.1.0

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+"use strict";var t=require("@agenticforge/tools");class e{name;description;triggerHint;systemPrompt;tools;visible;constructor(t){this.name=t.name,this.description=t.description,this.triggerHint=t.triggerHint,this.systemPrompt=t.systemPrompt,this.tools=t.tools??[],this.visible=t.visible??!0}_registry;get toolRegistry(){if(!this._registry){this._registry=new t.ToolRegistry;for(const e of this.tools)e instanceof t.Tool?this._registry.registerTool(e):this._registry.registerFunction(e.name,e.description,e.func,e.schema)}return this._registry}async execute(t,e){const s=[{role:"system",content:this.systemPrompt??`你是专门负责"${this.description}"的助理。`},...t.history??[],{role:"user",content:t.query}];if(0===this.tools.length)return{output:await e.think(s)};const i=[],r=s.map(t=>({...t})),o=this.toolRegistry.getOpenAISchemas(),n=e.client,l=e.model;if(!n||!l)return{output:await e.think(s)};let a="";for(let t=0;t<3;t++){const t=await n.chat.completions.create({model:l,messages:r,tools:o,tool_choice:"auto",stream:!1}),e=t.choices?.[0]?.message,s=e?.content??"",c=e?.tool_calls??[];if(0===c.length){a=s;break}r.push({role:"assistant",content:s,tool_calls:c});for(const t of c){i.push(t.function.name);let e={};try{e=JSON.parse(t.function.arguments)}catch{}let s="";try{s=await this.toolRegistry.execute(t.function.name,e)}catch(t){s=`Error: ${t instanceof Error?t.message:String(t)}`}r.push({role:"tool",tool_call_id:t.id,name:t.function.name,content:s})}}if(!a){const t=await n.chat.completions.create({model:l,messages:r,tools:o,tool_choice:"none",stream:!1});a=t.choices?.[0]?.message?.content??""}return{output:a,toolsUsed:i}}describe(){const t=[`- **${this.name}**: ${this.description}`];return this.triggerHint&&t.push(`  触发条件：${this.triggerHint}`),t.join("\n")}}class s{skills=new Map;register(t){this.skills.set(t.name,t)}unregister(t){return this.skills.delete(t)}get(t){return this.skills.get(t)}has(t){return this.skills.has(t)}list(){return Array.from(this.skills.keys())}all(){return Array.from(this.skills.values())}visible(){return this.all().filter(t=>!1!==t.visible)}size(){return this.skills.size}describeAll(){const t=this.visible();return 0===t.length?"（暂无可用 Skill）":t.map(t=>t instanceof e?t.describe():`- **${t.name}**: ${t.description}${t.triggerHint?`\n  触发条件：${t.triggerHint}`:""}`).join("\n")}}function i(t){const e=t.trim().match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!e){const e=t.match(/^#\s+(.+)$/m);return{frontmatter:{name:e?r(e[1]):"unknown-skill",description:e?e[1]:"Unnamed skill"},body:t}}const[,s,i]=e,o={};for(const t of s.split(/\r?\n/)){const e=t.match(/^([\w-]+):\s*(.*)$/);if(!e)continue;const[,s,i]=e;o[s]="true"===i||"false"!==i&&i.replace(/^"|"$/g,"").replace(/^'|'$/g,"").trim()}if(!o.name){const t=i.match(/^#\s+(.+)$/m);o.name=t?r(t[1]):"unknown-skill"}return o.description||(o.description=o.name),{frontmatter:o,body:i.trim()}}function r(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}class o{name;description;triggerHint;visible;tools=[];systemPrompt;frontmatter;filePath;constructor(t,e,s){this.frontmatter=t,this.name=t.name,this.description=t.description,this.triggerHint=t.triggerHint,this.visible=!1!==t.visible,this.systemPrompt=e,this.filePath=s}static fromSource(t,e){const{frontmatter:s,body:r}=i(t);return new o(s,r,e)}static async fromFile(t){const{readFile:e}=await import("node:fs/promises"),s=await e(t,"utf8");return o.fromSource(s,t)}async execute(t,e){const s=[{role:"system",content:this.systemPrompt},...t.history??[],{role:"user",content:t.query}];return{output:await e.think(s)}}describe(){const t=[`- **${this.name}**: ${this.description}`];return this.triggerHint&&t.push(`  触发条件：${this.triggerHint}`),t.join("\n")}}class n{static async fromDirectory(t,e={}){const{readdir:s,stat:i}=await import("node:fs/promises"),{join:r,resolve:n}=await import("node:path"),a=e.recursive??!0,c=[],m=n(t);return await async function t(e){let n;try{n=await s(e)}catch{return}for(const s of n){const n=r(e,s);let m;try{m=await i(n)}catch{continue}if(m.isDirectory())a&&await t(n);else if(l(s))try{c.push(await o.fromFile(n))}catch(t){console.warn(`[SkillLoader] Failed to load ${n}: ${String(t)}`)}}}(m),c}static async fromFiles(t){const{resolve:e}=await import("node:path"),s=[];for(const i of t)try{s.push(await o.fromFile(e(i)))}catch(t){console.warn(`[SkillLoader] Failed to load ${i}: ${String(t)}`)}return s}static fromSources(t){return t.map(({source:t,filePath:e})=>o.fromSource(t,e))}static toRegistry(t,e){const i=e??new s;for(const e of t)i.register(e);return i}static async registryFromDirectory(t,e){const s=await n.fromDirectory(t,e);return n.toRegistry(s)}}function l(t){const e=t.toLowerCase();return"skill.md"===e||e.endsWith(".skill.md")}exports.AgentSkill=e,exports.MarkdownSkill=o,exports.SkillLoader=n,exports.SkillRegistry=s,exports.SkillRunner=class{skillRegistry;llm;fallbackPrompt;routerPromptTemplate;constructor(t){this.llm=t.llm,this.fallbackPrompt=t.fallbackPrompt??"你是一个通用AI助理，请回答用户的问题。",this.routerPromptTemplate=t.routerPromptTemplate??["你是一个意图路由器。根据用户输入，从下面的 Skill 列表中选出最合适的一个。","只回答 Skill 的名称（name 字段），不要包含任何解释或标点。","","## 可用 Skills","{skills}","","## 用户输入","{query}","","## 你的选择（只填 Skill name）："].join("\n"),this.skillRegistry=new s;for(const e of t.skills??[])this.skillRegistry.register(e)}addSkill(t){this.skillRegistry.register(t)}removeSkill(t){return this.skillRegistry.unregister(t)}listSkills(){return this.skillRegistry.list()}async routeToSkill(t){const e=this.skillRegistry.visible();if(0===e.length)return;if(1===e.length)return e[0];const s=this.routerPromptTemplate.replace("{skills}",this.skillRegistry.describeAll()).replace("{query}",t),i=(await this.llm.think([{role:"user",content:s}])).trim().toLowerCase();return this.skillRegistry.get(i)??e.find(t=>t.name.toLowerCase().startsWith(i))??e.find(t=>i.includes(t.name.toLowerCase()))}async run(t,e){let s;if(e?.skillName){if(s=this.skillRegistry.get(e.skillName),!s)throw new Error(`Skill "${e.skillName}" not found. Available: ${this.skillRegistry.list().join(", ")}`)}else s=await this.routeToSkill(t);if(!s)return{output:await this.llm.think([{role:"system",content:this.fallbackPrompt},...e?.history??[],{role:"user",content:t}])};const i={query:t,metadata:e?.metadata,history:e?.history};return s.execute(i,this.llm)}async runSkill(t,e,s){return this.run(e,{skillName:t,...s})}},exports.parseFrontmatter=i;

package/dist/esm/index.js

@@ -0,0 +1 @@
+import{ToolRegistry as t,Tool as e}from"@agenticforge/tools";class s{name;description;triggerHint;systemPrompt;tools;visible;constructor(t){this.name=t.name,this.description=t.description,this.triggerHint=t.triggerHint,this.systemPrompt=t.systemPrompt,this.tools=t.tools??[],this.visible=t.visible??!0}_registry;get toolRegistry(){if(!this._registry){this._registry=new t;for(const t of this.tools)t instanceof e?this._registry.registerTool(t):this._registry.registerFunction(t.name,t.description,t.func,t.schema)}return this._registry}async execute(t,e){const s=[{role:"system",content:this.systemPrompt??`你是专门负责"${this.description}"的助理。`},...t.history??[],{role:"user",content:t.query}];if(0===this.tools.length)return{output:await e.think(s)};const i=[],r=s.map(t=>({...t})),o=this.toolRegistry.getOpenAISchemas(),n=e.client,l=e.model;if(!n||!l)return{output:await e.think(s)};let a="";for(let t=0;t<3;t++){const t=await n.chat.completions.create({model:l,messages:r,tools:o,tool_choice:"auto",stream:!1}),e=t.choices?.[0]?.message,s=e?.content??"",c=e?.tool_calls??[];if(0===c.length){a=s;break}r.push({role:"assistant",content:s,tool_calls:c});for(const t of c){i.push(t.function.name);let e={};try{e=JSON.parse(t.function.arguments)}catch{}let s="";try{s=await this.toolRegistry.execute(t.function.name,e)}catch(t){s=`Error: ${t instanceof Error?t.message:String(t)}`}r.push({role:"tool",tool_call_id:t.id,name:t.function.name,content:s})}}if(!a){const t=await n.chat.completions.create({model:l,messages:r,tools:o,tool_choice:"none",stream:!1});a=t.choices?.[0]?.message?.content??""}return{output:a,toolsUsed:i}}describe(){const t=[`- **${this.name}**: ${this.description}`];return this.triggerHint&&t.push(`  触发条件：${this.triggerHint}`),t.join("\n")}}class i{skills=new Map;register(t){this.skills.set(t.name,t)}unregister(t){return this.skills.delete(t)}get(t){return this.skills.get(t)}has(t){return this.skills.has(t)}list(){return Array.from(this.skills.keys())}all(){return Array.from(this.skills.values())}visible(){return this.all().filter(t=>!1!==t.visible)}size(){return this.skills.size}describeAll(){const t=this.visible();return 0===t.length?"（暂无可用 Skill）":t.map(t=>t instanceof s?t.describe():`- **${t.name}**: ${t.description}${t.triggerHint?`\n  触发条件：${t.triggerHint}`:""}`).join("\n")}}class r{skillRegistry;llm;fallbackPrompt;routerPromptTemplate;constructor(t){this.llm=t.llm,this.fallbackPrompt=t.fallbackPrompt??"你是一个通用AI助理，请回答用户的问题。",this.routerPromptTemplate=t.routerPromptTemplate??["你是一个意图路由器。根据用户输入，从下面的 Skill 列表中选出最合适的一个。","只回答 Skill 的名称（name 字段），不要包含任何解释或标点。","","## 可用 Skills","{skills}","","## 用户输入","{query}","","## 你的选择（只填 Skill name）："].join("\n"),this.skillRegistry=new i;for(const e of t.skills??[])this.skillRegistry.register(e)}addSkill(t){this.skillRegistry.register(t)}removeSkill(t){return this.skillRegistry.unregister(t)}listSkills(){return this.skillRegistry.list()}async routeToSkill(t){const e=this.skillRegistry.visible();if(0===e.length)return;if(1===e.length)return e[0];const s=this.routerPromptTemplate.replace("{skills}",this.skillRegistry.describeAll()).replace("{query}",t),i=(await this.llm.think([{role:"user",content:s}])).trim().toLowerCase();return this.skillRegistry.get(i)??e.find(t=>t.name.toLowerCase().startsWith(i))??e.find(t=>i.includes(t.name.toLowerCase()))}async run(t,e){let s;if(e?.skillName){if(s=this.skillRegistry.get(e.skillName),!s)throw new Error(`Skill "${e.skillName}" not found. Available: ${this.skillRegistry.list().join(", ")}`)}else s=await this.routeToSkill(t);if(!s)return{output:await this.llm.think([{role:"system",content:this.fallbackPrompt},...e?.history??[],{role:"user",content:t}])};const i={query:t,metadata:e?.metadata,history:e?.history};return s.execute(i,this.llm)}async runSkill(t,e,s){return this.run(e,{skillName:t,...s})}}function o(t){const e=t.trim().match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!e){const e=t.match(/^#\s+(.+)$/m);return{frontmatter:{name:e?n(e[1]):"unknown-skill",description:e?e[1]:"Unnamed skill"},body:t}}const[,s,i]=e,r={};for(const t of s.split(/\r?\n/)){const e=t.match(/^([\w-]+):\s*(.*)$/);if(!e)continue;const[,s,i]=e;r[s]="true"===i||"false"!==i&&i.replace(/^"|"$/g,"").replace(/^'|'$/g,"").trim()}if(!r.name){const t=i.match(/^#\s+(.+)$/m);r.name=t?n(t[1]):"unknown-skill"}return r.description||(r.description=r.name),{frontmatter:r,body:i.trim()}}function n(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")}class l{name;description;triggerHint;visible;tools=[];systemPrompt;frontmatter;filePath;constructor(t,e,s){this.frontmatter=t,this.name=t.name,this.description=t.description,this.triggerHint=t.triggerHint,this.visible=!1!==t.visible,this.systemPrompt=e,this.filePath=s}static fromSource(t,e){const{frontmatter:s,body:i}=o(t);return new l(s,i,e)}static async fromFile(t){const{readFile:e}=await import("node:fs/promises"),s=await e(t,"utf8");return l.fromSource(s,t)}async execute(t,e){const s=[{role:"system",content:this.systemPrompt},...t.history??[],{role:"user",content:t.query}];return{output:await e.think(s)}}describe(){const t=[`- **${this.name}**: ${this.description}`];return this.triggerHint&&t.push(`  触发条件：${this.triggerHint}`),t.join("\n")}}class a{static async fromDirectory(t,e={}){const{readdir:s,stat:i}=await import("node:fs/promises"),{join:r,resolve:o}=await import("node:path"),n=e.recursive??!0,a=[],m=o(t);return await async function t(e){let o;try{o=await s(e)}catch{return}for(const s of o){const o=r(e,s);let m;try{m=await i(o)}catch{continue}if(m.isDirectory())n&&await t(o);else if(c(s))try{a.push(await l.fromFile(o))}catch(t){console.warn(`[SkillLoader] Failed to load ${o}: ${String(t)}`)}}}(m),a}static async fromFiles(t){const{resolve:e}=await import("node:path"),s=[];for(const i of t)try{s.push(await l.fromFile(e(i)))}catch(t){console.warn(`[SkillLoader] Failed to load ${i}: ${String(t)}`)}return s}static fromSources(t){return t.map(({source:t,filePath:e})=>l.fromSource(t,e))}static toRegistry(t,e){const s=e??new i;for(const e of t)s.register(e);return s}static async registryFromDirectory(t,e){const s=await a.fromDirectory(t,e);return a.toRegistry(s)}}function c(t){const e=t.toLowerCase();return"skill.md"===e||e.endsWith(".skill.md")}export{s as AgentSkill,l as MarkdownSkill,a as SkillLoader,i as SkillRegistry,r as SkillRunner,o as parseFrontmatter};

package/dist/types/core/src/agent.d.ts

@@ -0,0 +1,50 @@
+import { Message } from "./message";
+import { LLMClient } from "./llm";
+import { Config } from "./config";
+import { type ZodType } from "zod";
+/** Agent 基类 */
+export declare abstract class Agent {
+    protected readonly name: string;
+    protected readonly llm: LLMClient;
+    protected readonly systemPrompt?: string;
+    protected readonly config: Config;
+    protected readonly history: Message[];
+    constructor(params: {
+        name: string;
+        llm: LLMClient;
+        systemPrompt?: string;
+        config?: Config;
+    });
+    /** 运行 Agent */
+    abstract run(inputText: string, ...args: unknown[]): Promise<string> | string;
+    /** 添加消息到历史记录 */
+    addMessage(message: Message): void;
+    /** 清空历史记录 */
+    clearHistory(): void;
+    /** 获取历史记录 */
+    getHistory(): Message[];
+    /**
+     * 结构化输出入口：
+     * - 通过 schema 约束模型返回 JSON
+     * - 自动从回复中提取 JSON 并进行校验
+     */
+    runStructured<T>(params: {
+        inputText: string;
+        schema: ZodType<T>;
+        instruction?: string;
+        maxRetries?: number;
+        options?: unknown;
+    }): Promise<T>;
+    /**
+     * 根据 Zod schema 自动生成结构化输出提示词。
+     */
+    protected buildStructuredInstructionFromSchema<T>(schema: ZodType<T>): string;
+    /**
+     * 从文本中提取 JSON 主体：
+     * - 支持 ```json ... ``` 包裹
+     * - 支持纯 JSON 文本
+     */
+    protected extractJsonBlock(text: string): string;
+    toString(): string;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/core/src/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../core/src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAChC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,EAAI,KAAK,OAAO,EAAC,MAAM,KAAK,CAAC;AAEpC,eAAe;AACf,8BAAsB,KAAK;IACzB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAM;gBAE/B,MAAM,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,SAAS,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOD,eAAe;IACf,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAE7E,gBAAgB;IAChB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,aAAa;IACb,YAAY,IAAI,IAAI;IAIpB,aAAa;IACb,UAAU,IAAI,OAAO,EAAE;IAIvB;;;;OAIG;IACG,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,CAAC,CAAC;IA+Dd;;OAEG;IACH,SAAS,CAAC,oCAAoC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM;IAU7E;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA8BhD,QAAQ,IAAI,MAAM;CAInB"}

package/dist/types/core/src/config.d.ts

@@ -0,0 +1,11 @@
+import type { Provider, ProviderConfig } from "./types";
+export interface RuntimeConfig {
+    defaultProvider: Provider;
+    providers: Record<string, ProviderConfig>;
+}
+export declare class Config {
+    defaultProvider: Provider;
+    providers: Record<string, ProviderConfig>;
+    constructor(overrides?: Partial<RuntimeConfig>);
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/core/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../core/src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,QAAQ,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED,qBAAa,MAAM;IACV,eAAe,EAAE,QAAQ,CAAY;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM;gBAE1C,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM;CAInD"}

package/dist/types/core/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./agent";
+export * from "./config";
+export * from "./llm";
+export * from "./message";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/types/core/src/llm.d.ts

@@ -0,0 +1,9 @@
+import type { LLMMessage, LLMOptions } from "./types";
+export declare class LLMClient {
+    private readonly client;
+    private readonly model;
+    constructor(options?: LLMOptions);
+    think(messages: LLMMessage[], temperature?: number): Promise<string>;
+    streamThink(messages: LLMMessage[], temperature?: number): AsyncGenerator<string>;
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/types/core/src/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../../../../core/src/llm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,SAAS,CAAC;AAkBpD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,UAAe;IAqB9B,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9D,WAAW,CAChB,QAAQ,EAAE,UAAU,EAAE,EACtB,WAAW,SAAI,GACd,cAAc,CAAC,MAAM,CAAC;CAe1B"}

package/dist/types/core/src/message.d.ts

@@ -0,0 +1,23 @@
+export type MessageRole = "user" | "assistant" | "system" | "tool";
+export interface MessageMetadata {
+    [key: string]: unknown;
+}
+export declare class Message {
+    readonly content: string;
+    readonly role: MessageRole;
+    readonly timestamp: Date;
+    readonly metadata: MessageMetadata;
+    constructor(params: {
+        content: string;
+        role: MessageRole;
+        timestamp?: Date;
+        metadata?: MessageMetadata;
+    });
+    /** 转换为字典格式（OpenAI API 格式） */
+    toDict(): {
+        role: MessageRole;
+        content: string;
+    };
+    toString(): string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/core/src/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../core/src/message.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,OAAO;IAClB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAClC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAChC,SAAgB,QAAQ,EAAE,eAAe,CAAC;gBAE9B,MAAM,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,WAAW,CAAC;QAClB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;IAOD,6BAA6B;IAC7B,MAAM,IAAI;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC;IAO9C,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/types/core/src/types.d.ts

@@ -0,0 +1,18 @@
+export type Provider = "openai" | "anthropic" | "local";
+export interface ProviderConfig {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    timeoutMs?: number;
+}
+export interface LLMOptions {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    timeoutMs?: number;
+}
+export interface LLMMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../core/src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/skills/src/AgentSkill.d.ts

@@ -0,0 +1,63 @@
+import { Tool, type FunctionTool, ToolRegistry } from "@agenticforge/tools";
+import type { LLMClient } from "@agenticforge/core";
+import type { IAgentSkill, SkillContext, SkillDefinition, SkillResult } from "./types";
+/**
+ * AgentSkill 是一个可复用的 Agent 能力单元。
+ *
+ * 类比：
+ * - Semantic Kernel 的 `KernelPlugin`
+ * - Copilot Studio 的 `Skill`
+ * - AutoGen 的 `AssistantAgent` with specific tools
+ *
+ * 每个 Skill 封装了：
+ *  - 一个明确的业务语义（name + description）
+ *  - 专属的 System Prompt
+ *  - 专属的工具集（只有这个 Skill 能用的工具）
+ *  - 独立的 execute() 执行逻辑
+ *
+ * 使用方式 A — 直接实例化（适合简单场景）：
+ * ```ts
+ * const weatherSkill = new AgentSkill({
+ *   name: "weather",
+ *   description: "获取城市实时天气，回答关于温度、降雨、风速的问题",
+ *   triggerHint: "当用户询问天气、温度、是否下雨时",
+ *   systemPrompt: "你是天气助理，只回答天气相关问题，用简洁中文回答。",
+ *   tools: [weatherApiTool],
+ * });
+ * ```
+ *
+ * 使用方式 B — 继承扩展（适合复杂场景）：
+ * ```ts
+ * class StockSkill extends AgentSkill {
+ *   constructor() {
+ *     super({ name: "stock", description: "查询股票实时价格", tools: [stockTool] });
+ *   }
+ *
+ *   override async execute(ctx, llm): Promise<SkillResult> {
+ *     const price = await fetchStockPrice(ctx.query);
+ *     return { output: `当前股价：${price}` };
+ *   }
+ * }
+ * ```
+ */
+export declare class AgentSkill implements IAgentSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly triggerHint?: string;
+    readonly systemPrompt?: string;
+    readonly tools: Array<Tool | FunctionTool<Record<string, unknown>>>;
+    readonly visible: boolean;
+    constructor(definition: SkillDefinition);
+    private _registry?;
+    protected get toolRegistry(): ToolRegistry;
+    /**
+     * Default implementation: builds messages from context + systemPrompt,
+     * appends tool schemas if tools are configured, calls the LLM,
+     * and runs a tool-call loop (up to 3 iterations).
+     *
+     * Override this method for fully custom Skill logic.
+     */
+    execute(context: SkillContext, llm: LLMClient): Promise<SkillResult>;
+    describe(): string;
+}
+//# sourceMappingURL=AgentSkill.d.ts.map

package/dist/types/skills/src/AgentSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSkill.d.ts","sourceRoot":"","sources":["../../../../src/AgentSkill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,YAAY,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAMrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,UAAU,EAAE,eAAe;IAavC,OAAO,CAAC,SAAS,CAAC,CAAe;IAEjC,SAAS,KAAK,YAAY,IAAI,YAAY,CAiBzC;IAMD;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAsG1E,QAAQ,IAAI,MAAM;CAKnB"}

package/dist/types/skills/src/MarkdownSkill.d.ts

@@ -0,0 +1,81 @@
+import type { LLMClient } from "@agenticforge/core";
+import type { IAgentSkill, SkillContext, SkillResult } from "./types";
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    triggerHint?: string;
+    visible?: boolean;
+    /** Any extra frontmatter fields are preserved here */
+    [key: string]: unknown;
+}
+/**
+ * Parse YAML-like frontmatter from a markdown string.
+ * Supports only simple key: value pairs (no nesting, no arrays).
+ * Delimited by `---` at the top of the file.
+ */
+export declare function parseFrontmatter(source: string): {
+    frontmatter: SkillFrontmatter;
+    body: string;
+};
+/**
+ * A Skill defined entirely in a Markdown file.
+ *
+ * The markdown body is injected as the system prompt when the Skill executes,
+ * so the LLM "becomes" whatever persona/rules the markdown describes.
+ *
+ * File format:
+ * ```markdown
+ * ---
+ * name: weather-assistant
+ * description: Get real-time weather for any city
+ * triggerHint: 当用户询问天气、温度、降雨、风速时
+ * ---
+ *
+ * # Weather Assistant
+ *
+ * ## Role
+ * You are a concise weather assistant. Answer only weather-related questions.
+ *
+ * ## Rules
+ * - Always state the city and date in your answer.
+ * - If weather data is unavailable, say so clearly.
+ * - Do NOT answer non-weather questions.
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * const skill = MarkdownSkill.fromSource(markdownText);
+ * // or
+ * const skill = await MarkdownSkill.fromFile("/path/to/skill.md");
+ * ```
+ */
+export declare class MarkdownSkill implements IAgentSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly triggerHint?: string;
+    readonly visible: boolean;
+    readonly tools: never[];
+    /** The full markdown body used as the system prompt */
+    readonly systemPrompt: string;
+    /** Raw parsed frontmatter (for inspection) */
+    readonly frontmatter: SkillFrontmatter;
+    /** Original source file path (if loaded from disk) */
+    readonly filePath?: string;
+    private constructor();
+    /**
+     * Create a MarkdownSkill from a raw markdown string.
+     */
+    static fromSource(source: string, filePath?: string): MarkdownSkill;
+    /**
+     * Load a MarkdownSkill from a file path.
+     * Uses Node.js `fs/promises` — only available in Node environments.
+     */
+    static fromFile(filePath: string): Promise<MarkdownSkill>;
+    /**
+     * Execute the skill: inject the markdown body as system prompt,
+     * prepend conversation history, then call the LLM.
+     */
+    execute(context: SkillContext, llm: LLMClient): Promise<SkillResult>;
+    describe(): string;
+}
+//# sourceMappingURL=MarkdownSkill.d.ts.map

package/dist/types/skills/src/MarkdownSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSkill.d.ts","sourceRoot":"","sources":["../../../../src/MarkdownSkill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAMpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CA0CA;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAS,KAAK,EAAE,CAAC;IAE/B,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IAEvC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,OAAO;IAkBP;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa;IAKnE;;;OAGG;WACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAU/D;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAe1E,QAAQ,IAAI,MAAM;CAKnB"}

package/dist/types/skills/src/SkillLoader.d.ts

@@ -0,0 +1,69 @@
+import { MarkdownSkill } from "./MarkdownSkill";
+import type { IAgentSkill } from "./types";
+import { SkillRegistry } from "./SkillRegistry";
+/**
+ * Scans a directory (or list of paths) for `SKILL.md` / `*.skill.md` files
+ * and loads them as `MarkdownSkill` instances.
+ *
+ * Convention (mirrors Cursor / Claude skills layout):
+ * ```
+ * skills/
+ *   weather/
+ *     SKILL.md          ← loaded
+ *   stock-query/
+ *     SKILL.md          ← loaded
+ *     examples.md       ← ignored
+ *   my-tool.skill.md    ← loaded (flat layout)
+ * ```
+ *
+ * Example:
+ * ```ts
+ * // Load all skills from a directory
+ * const skills = await SkillLoader.fromDirectory(".cursor/skills");
+ *
+ * // Or load from explicit file paths
+ * const skills = await SkillLoader.fromFiles([
+ *   "./skills/weather/SKILL.md",
+ *   "./skills/stock/SKILL.md",
+ * ]);
+ *
+ * // Populate a SkillRegistry
+ * const registry = SkillLoader.toRegistry(skills);
+ * ```
+ */
+export declare class SkillLoader {
+    /**
+     * Load all skills from a directory tree.
+     * Matches files named `SKILL.md` or ending with `.skill.md`.
+     *
+     * @param dir      Absolute or relative path to the skills directory.
+     * @param options  `recursive` (default true) — whether to walk subdirectories.
+     */
+    static fromDirectory(dir: string, options?: {
+        recursive?: boolean;
+    }): Promise<MarkdownSkill[]>;
+    /**
+     * Load skills from an explicit list of file paths.
+     */
+    static fromFiles(filePaths: string[]): Promise<MarkdownSkill[]>;
+    /**
+     * Load skills from raw markdown source strings.
+     * Useful for testing or browser environments where `fs` is unavailable.
+     */
+    static fromSources(sources: Array<{
+        source: string;
+        filePath?: string;
+    }>): MarkdownSkill[];
+    /**
+     * Create a SkillRegistry populated with the given skills.
+     * If `existingRegistry` is provided, skills are added to it.
+     */
+    static toRegistry(skills: IAgentSkill[], existingRegistry?: SkillRegistry): SkillRegistry;
+    /**
+     * Convenience: load all skills from a directory AND return a ready registry.
+     */
+    static registryFromDirectory(dir: string, options?: {
+        recursive?: boolean;
+    }): Promise<SkillRegistry>;
+}
+//# sourceMappingURL=SkillLoader.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/skills/src/SkillRegistry.d.ts

@@ -0,0 +1,32 @@
+import type { IAgentSkill } from "./types";
+/**
+ * Manages a collection of AgentSkills.
+ *
+ * ```ts
+ * const registry = new SkillRegistry();
+ * registry.register(weatherSkill);
+ * registry.register(stockSkill);
+ *
+ * registry.get("weather");  // => AgentSkill
+ * registry.list();           // => ["weather", "stock"]
+ * registry.describeAll();    // markdown bullet list for LLM prompt
+ * ```
+ */
+export declare class SkillRegistry {
+    private readonly skills;
+    register(skill: IAgentSkill): void;
+    unregister(name: string): boolean;
+    get(name: string): IAgentSkill | undefined;
+    has(name: string): boolean;
+    list(): string[];
+    all(): IAgentSkill[];
+    /** Return only Skills that are visible for LLM routing */
+    visible(): IAgentSkill[];
+    size(): number;
+    /**
+     * Produce a markdown bullet list of all visible Skills.
+     * Used by SkillAgent to build the routing system prompt.
+     */
+    describeAll(): string;
+}
+//# sourceMappingURL=SkillRegistry.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/skills/src/SkillRunner.d.ts

@@ -0,0 +1,73 @@
+import type { LLMClient } from "@agenticforge/core";
+import type { IAgentSkill, SkillResult } from "./types";
+import { SkillRegistry } from "./SkillRegistry";
+/**
+ * A lightweight, framework-independent Skill runner.
+ *
+ * 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.
+ *
+ * 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
+ * ```
+ *
+ * Example:
+ * ```ts
+ * import { SkillRunner, AgentSkill } from "@agenticforge/skills";
+ *
+ * const runner = new SkillRunner({
+ *   llm: myLLMClient,
+ *   skills: [weatherSkill, stockSkill],
+ * });
+ *
+ * const result = await runner.run("东京今天下雨吗？");
+ * console.log(result.output);
+ * ```
+ */
+export declare class SkillRunner {
+    readonly skillRegistry: SkillRegistry;
+    private readonly llm;
+    private readonly fallbackPrompt;
+    private readonly routerPromptTemplate;
+    constructor(params: {
+        llm: LLMClient;
+        skills?: IAgentSkill[];
+        fallbackPrompt?: string;
+        routerPromptTemplate?: string;
+    });
+    addSkill(skill: IAgentSkill): void;
+    removeSkill(name: string): boolean;
+    listSkills(): string[];
+    private routeToSkill;
+    /**
+     * Run: auto-route to the best Skill and execute it.
+     */
+    run(query: string, options?: {
+        skillName?: string;
+        metadata?: Record<string, unknown>;
+        history?: Array<{
+            role: "user" | "assistant" | "system";
+            content: string;
+        }>;
+    }): Promise<SkillResult>;
+    /**
+     * Directly invoke a named Skill and return the full SkillResult.
+     */
+    runSkill(skillName: string, query: string, options?: {
+        metadata?: Record<string, unknown>;
+        history?: Array<{
+            role: "user" | "assistant" | "system";
+            content: string;
+        }>;
+    }): Promise<SkillResult>;
+}
+//# sourceMappingURL=SkillRunner.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/skills/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types";
+export * from "./AgentSkill";
+export * from "./SkillRegistry";
+export * from "./SkillRunner";
+export * from "./MarkdownSkill";
+export * from "./SkillLoader";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,64 @@
+import type { LLMClient } from "@agenticforge/core";
+import type { Tool, FunctionTool } from "@agenticforge/tools";
+export interface SkillContext {
+    /** 当前用户输入 */
+    query: string;
+    /** 调用方传入的任意元数据（权限、用户身份、会话 ID 等） */
+    metadata?: Record<string, unknown>;
+    /** 可选：对话历史（转发给 Skill 内部 LLM 调用） */
+    history?: Array<{
+        role: "user" | "assistant" | "system";
+        content: string;
+    }>;
+}
+export interface SkillResult {
+    /** Skill 最终产出的文本 */
+    output: string;
+    /** 执行过程中调用的工具名列表（可选，用于可观测性） */
+    toolsUsed?: string[];
+    /** Skill 自定义的附加数据 */
+    data?: Record<string, unknown>;
+}
+export interface SkillDefinition {
+    /**
+     * Skill 唯一标识名，用于注册与路由。
+     * 建议使用 kebab-case，例如 "stock-query"、"email-composer"。
+     */
+    name: string;
+    /**
+     * 一句话描述该 Skill 能做什么。
+     * SkillAgent 会把所有 Skill 的描述展示给 LLM，
+     * 让它选择最合适的 Skill。
+     */
+    description: string;
+    /**
+     * 触发条件（可选）。
+     * 描述什么样的用户输入应该触发这个 Skill。
+     * 例如："当用户询问股票价格、K线图或市值时"
+     */
+    triggerHint?: string;
+    /**
+     * 该 Skill 专属的 System Prompt（可选）。
+     */
+    systemPrompt?: string;
+    /**
+     * 该 Skill 可用的工具（可选）。
+     * 只有这些工具会在该 Skill 的执行上下文中出现。
+     */
+    tools?: Array<Tool | FunctionTool<Record<string, unknown>>>;
+    /**
+     * 是否在 SkillAgent 路由时对外可见（默认 true）。
+     * 设为 false 则只能通过 runSkill(name) 直接调用。
+     */
+    visible?: boolean;
+}
+export interface IAgentSkill extends SkillDefinition {
+    /**
+     * 执行该 Skill。
+     * @param context  包含 query、history、metadata 的调用上下文
+     * @param llm      由 SkillAgent 注入的 LLM 客户端
+     * @returns        SkillResult
+     */
+    execute(context: SkillContext, llm: LLMClient): Promise<SkillResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/tools/src/AsyncToolExecutor.d.ts

@@ -0,0 +1,30 @@
+import { ToolRegistry } from "./ToolRegistry";
+export interface ToolCallRequest {
+    id: string;
+    toolName: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolCallResult {
+    id: string;
+    toolName: string;
+    output: string;
+    error?: string;
+    durationMs: number;
+}
+/**
+ * Executes multiple tool calls concurrently and collects results.
+ */
+export declare class AsyncToolExecutor {
+    private readonly registry;
+    private readonly concurrency;
+    constructor(registry: ToolRegistry, concurrency?: number);
+    /**
+     * Execute a batch of tool calls with bounded concurrency.
+     */
+    executeBatch(requests: ToolCallRequest[]): Promise<ToolCallResult[]>;
+    /**
+     * Execute a single tool call.
+     */
+    executeSingle(request: ToolCallRequest): Promise<ToolCallResult>;
+}
+//# sourceMappingURL=AsyncToolExecutor.d.ts.map

package/dist/types/tools/src/AsyncToolExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncToolExecutor.d.ts","sourceRoot":"","sources":["../../../../../tools/src/AsyncToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,QAAQ,EAAE,YAAY,EAAE,WAAW,SAAI;IAKnD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgB1E;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBvE"}

package/dist/types/tools/src/Tool.d.ts

@@ -0,0 +1,74 @@
+import "reflect-metadata";
+import { z, type ZodType } from "zod";
+import type { ToolParameter } from "./types";
+export type { ToolParameter };
+export interface OpenAIFunctionSchema {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ToolActionMeta {
+    key: string;
+    description: string;
+    method: string;
+}
+/**
+ * Decorator that registers a method as a named tool action.
+ * Usage: @toolAction("action_key", "Description")
+ */
+export declare function toolAction(key: string, description: string): (target: object, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare abstract class Tool {
+    readonly name: string;
+    readonly description: string;
+    readonly expandable: boolean;
+    constructor(name: string, description: string, expandable?: boolean);
+    abstract run(parameters: Record<string, unknown>): Promise<string> | string;
+    abstract getParameters(): ToolParameter[];
+    /**
+     * Validate that required parameters are present and have basic types.
+     * Returns true if valid.
+     */
+    validateParameters(parameters: Record<string, unknown>): boolean;
+    /**
+     * Validate and coerce parameters, returning a Result object.
+     */
+    validateAndNormalizeParameters(parameters: Record<string, unknown>): {
+        success: true;
+        data: Record<string, unknown>;
+    } | {
+        success: false;
+        error: string;
+    };
+    /**
+     * Convert this Tool to an OpenAI function-calling schema.
+     */
+    toOpenAISchema(): OpenAIFunctionSchema;
+    /**
+     * Return a formatted description of all available tool actions (for system prompt).
+     */
+    describe(): string;
+}
+export interface FunctionTool<TArgs = Record<string, unknown>> {
+    name: string;
+    description: string;
+    func: (args: TArgs) => string | Promise<string>;
+    schema?: ZodType<TArgs>;
+}
+/**
+ * Convenience factory for creating type-safe function tools.
+ *
+ * ```ts
+ * const myTool = defineFunctionTool({
+ *   name: "myTool",
+ *   description: "...",
+ *   schema: z.object({ input: z.string() }),
+ *   func: ({ input }) => input.toUpperCase(),
+ * });
+ * ```
+ */
+export declare function defineFunctionTool<TArgs extends Record<string, unknown>>(options: FunctionTool<TArgs>): FunctionTool<TArgs>;
+export { z };
+//# sourceMappingURL=Tool.d.ts.map

package/dist/types/tools/src/Tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../../../../tools/src/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,CAAC,EAAE,KAAK,OAAO,EAAC,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAE3C,YAAY,EAAC,aAAa,EAAC,CAAC;AAM5B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAQD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAEvD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,aAAa,kBAAkB,KAC9B,IAAI,CAMR;AAMD,8BAAsB,IAAI;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,UAAQ;IAMjE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAC3E,QAAQ,CAAC,aAAa,IAAI,aAAa,EAAE;IAEzC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAUhE;;OAEG;IACH,8BAA8B,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,GAAG;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;IAwBnF;;OAEG;IACH,cAAc,IAAI,oBAAoB;IA8BtC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUnB;AAcD,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,YAAY,CAAC,KAAK,CAAC,CAErB;AAED,OAAO,EAAC,CAAC,EAAC,CAAC"}

package/dist/types/tools/src/ToolChain.d.ts

@@ -0,0 +1,47 @@
+import { ToolRegistry } from "./ToolRegistry";
+export interface ToolChainStep {
+    /** Name of the tool/function to call */
+    toolName: string;
+    /** Input template string; use {variableName} to reference context variables */
+    inputTemplate: string;
+    /** Key under which the step output is stored in context */
+    outputKey: string;
+}
+/**
+ * A sequential chain of tool steps.
+ * Each step can reference outputs of prior steps via `{key}` placeholders.
+ *
+ * ```ts
+ * const chain = new ToolChain("my_chain", "Does X then Y");
+ * chain.addStep("search", "{input}", "search_result");
+ * chain.addStep("summarize", "{search_result}", "summary");
+ * ```
+ */
+export declare class ToolChain {
+    readonly name: string;
+    readonly description: string;
+    private readonly steps;
+    constructor(name: string, description: string);
+    addStep(toolName: string, inputTemplate: string, outputKey: string): this;
+    getSteps(): ToolChainStep[];
+    /**
+     * Execute the chain against a registry.
+     * @param registry  ToolRegistry that holds the referenced tools.
+     * @param input     Initial `{input}` value.
+     * @returns         The value stored under the last step's outputKey.
+     */
+    execute(registry: ToolRegistry, input: string): Promise<string>;
+}
+/**
+ * Manages multiple named ToolChains and executes them against a shared registry.
+ */
+export declare class ToolChainManager {
+    private readonly chains;
+    private readonly registry;
+    constructor(registry: ToolRegistry);
+    registerChain(chain: ToolChain): void;
+    getChain(name: string): ToolChain | undefined;
+    listChains(): string[];
+    executeChain(chainName: string, input: string): Promise<string>;
+}
+//# sourceMappingURL=ToolChain.d.ts.map

package/dist/types/tools/src/ToolChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolChain.d.ts","sourceRoot":"","sources":["../../../../../tools/src/ToolChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK7C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzE,QAAQ,IAAI,aAAa,EAAE;IAI3B;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAatE;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,QAAQ,EAAE,YAAY;IAIlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C,UAAU,IAAI,MAAM,EAAE;IAIhB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKtE"}

package/dist/types/tools/src/ToolRegistry.d.ts

@@ -0,0 +1,22 @@
+import { Tool, type FunctionTool, type OpenAIFunctionSchema } from "./Tool";
+/**
+ * Central registry that manages Tool instances and raw FunctionTools.
+ * Supports registration, lookup, and execution.
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    private readonly functions;
+    registerTool(tool: Tool): void;
+    unregisterTool(name: string): boolean;
+    registerFunction<TArgs extends Record<string, unknown>>(name: string, description: string, func: (args: TArgs) => string | Promise<string>, schema?: FunctionTool<TArgs>["schema"]): void;
+    unregisterFunction(name: string): boolean;
+    getTool(name: string): Tool | undefined;
+    getFunction(name: string): FunctionTool<Record<string, unknown>> | undefined;
+    getAllTools(): Tool[];
+    listTools(): string[];
+    hasTool(name: string): boolean;
+    execute(name: string, parameters: Record<string, unknown>): Promise<string>;
+    getAvailableTools(): string;
+    getOpenAISchemas(): Array<OpenAIFunctionSchema | Record<string, unknown>>;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/types/tools/src/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../tools/src/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAC,MAAM,QAAQ,CAAC;AAE1E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4D;IAMtF,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAC/C,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GACrC,IAAI;IASP,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS;IAI5E,WAAW,IAAI,IAAI,EAAE;IAIrB,SAAS,IAAI,MAAM,EAAE;IAOrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBjF,iBAAiB,IAAI,MAAM;IAe3B,gBAAgB,IAAI,KAAK,CAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAyB1E"}

package/dist/types/tools/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./Tool";
+export * from "./ToolChain";
+export * from "./ToolRegistry";
+export * from "./AsyncToolExecutor";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../tools/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/types/tools/src/types.d.ts

@@ -0,0 +1,13 @@
+export interface ToolParameter {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default: unknown;
+}
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../tools/src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@agenticforge/skills",
+  "version": "1.1.0",
+  "description": "Agent Skills system for AgenticFORGE — composable, routable agent capability units",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:js": "rollup -c",
+    "build": "pnpm run clean && pnpm run typecheck && pnpm run build:types && pnpm run build:js"
+  },
+  "dependencies": {
+    "@agenticforge/core": "workspace:^",
+    "@agenticforge/tools": "workspace:^"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.8",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/node": "^25.3.3",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.50.1",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "tsx": "^4.21.0",
+    "typescript": "~5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LittleBlacky/AgenticFORGE.git",
+    "directory": "packages/skills"
+  },
+  "homepage": "https://github.com/LittleBlacky/AgenticFORGE/tree/main/packages/skills#readme",
+  "bugs": {
+    "url": "https://github.com/LittleBlacky/AgenticFORGE/issues"
+  },
+  "license": "CC-BY-NC-SA-4.0",
+  "keywords": [
+    "agenticforge",
+    "agent",
+    "ai",
+    "llm",
+    "typescript",
+    "skills",
+    "agent-skills",
+    "skill-agent",
+    "plugin",
+    "semantic-kernel"
+  ]
+}