@frontmcp/sdk 1.0.0-beta.8 → 1.0.0-rc.1

package/skill/index.d.ts.map

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

package/skill/resources/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Skill Resources
+ *
+ * MCP resources for discovering and reading skills via the `skills://` URI scheme.
+ * These resources are automatically registered when skills are available.
+ *
+ * URI patterns:
+ * - `skills://catalog` — list all skills
+ * - `skills://{skillName}` — load skill content (SKILL.md)
+ * - `skills://{skillName}/SKILL.md` — same (explicit path alias)
+ * - `skills://{skillName}/references` — list references
+ * - `skills://{skillName}/references/{referenceName}` — read reference
+ * - `skills://{skillName}/examples` — list examples
+ * - `skills://{skillName}/examples/{exampleName}` — read example
+ *
+ * @module skill/resources
+ */
+import { SkillsCatalogResource } from './skills-catalog.resource';
+import { SkillContentResource } from './skill-content.resource';
+import { SkillContentAliasResource } from './skill-content-alias.resource';
+import { SkillReferencesListResource } from './skill-references-list.resource';
+import { SkillReferenceContentResource } from './skill-reference-content.resource';
+import { SkillExamplesListResource } from './skill-examples-list.resource';
+import { SkillExampleContentResource } from './skill-example-content.resource';
+export { SkillsCatalogResource, SkillContentResource, SkillContentAliasResource, SkillReferencesListResource, SkillReferenceContentResource, SkillExamplesListResource, SkillExampleContentResource, };
+export { getMcpVisibleSkills, getMcpVisibleSkillNames, findAndLoadSkill, readSkillFile, readAndParseSkillFile, collectAllReferenceNames, collectAllExampleNames, } from './skill-resource.helpers';
+/**
+ * Get all skill-related resources.
+ * Used by the SDK to register skill resources when skills are available.
+ */
+export declare function getSkillResources(): Function[];
+//# sourceMappingURL=index.d.ts.map

package/skill/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,GAC5B,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,EAAE,CAU9C"}

package/skill/resources/skill-content-alias.resource.d.ts

@@ -0,0 +1,19 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type SkillNameParams = {
+    skillName: string;
+};
+/**
+ * Alias resource template for loading a skill's SKILL.md by explicit path.
+ *
+ * URI: `skills://{skillName}/SKILL.md`
+ *
+ * Identical to `skills://{skillName}` — provided so that explicit
+ * file-path-style access works naturally.
+ */
+export declare class SkillContentAliasResource extends ResourceContext<SkillNameParams> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: SkillNameParams): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-content-alias.resource.d.ts.map

package/skill/resources/skill-content-alias.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content-alias.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-content-alias.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAKpF,KAAK,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,qBAQa,yBAA0B,SAAQ,eAAe,CAAC,eAAe,CAAC;IACvE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAgBjF"}

package/skill/resources/skill-content.resource.d.ts

@@ -0,0 +1,20 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type SkillNameParams = {
+    skillName: string;
+};
+/**
+ * Resource template for loading a skill's full content.
+ *
+ * URI: `skills://{skillName}`
+ *
+ * Returns the SKILL.md content formatted for LLM consumption,
+ * including tool schemas, routing tables for references/examples,
+ * and availability information.
+ */
+export declare class SkillContentResource extends ResourceContext<SkillNameParams> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: SkillNameParams): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-content.resource.d.ts.map

package/skill/resources/skill-content.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-content.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAKpF,KAAK,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;;;;;;GAQG;AACH,qBASa,oBAAqB,SAAQ,eAAe,CAAC,eAAe,CAAC;IAClE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAgBjF"}

package/skill/resources/skill-example-content.resource.d.ts

@@ -0,0 +1,20 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type Params = {
+    skillName: string;
+    exampleName: string;
+};
+/**
+ * Resource template for reading a specific example from a skill.
+ *
+ * URI: `skills://{skillName}/examples/{exampleName}`
+ *
+ * Returns the example markdown content with frontmatter stripped.
+ */
+export declare class SkillExampleContentResource extends ResourceContext<Params> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    exampleNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: Params): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-example-content.resource.d.ts.map

package/skill/resources/skill-example-content.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-example-content.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-example-content.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAUpF,KAAK,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;;;GAMG;AACH,qBAQa,2BAA4B,SAAQ,eAAe,CAAC,MAAM,CAAC;IAChE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKxE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAqBxE"}

package/skill/resources/skill-examples-list.resource.d.ts

@@ -0,0 +1,19 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type SkillNameParams = {
+    skillName: string;
+};
+/**
+ * Resource template listing all examples for a skill.
+ *
+ * URI: `skills://{skillName}/examples`
+ *
+ * Returns a JSON array of example metadata (name, description, reference, level).
+ * Use `skills://{skillName}/examples/{exampleName}` to read the content.
+ */
+export declare class SkillExamplesListResource extends ResourceContext<SkillNameParams> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: SkillNameParams): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-examples-list.resource.d.ts.map

package/skill/resources/skill-examples-list.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-examples-list.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-examples-list.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAIpF,KAAK,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,qBASa,yBAA0B,SAAQ,eAAe,CAAC,eAAe,CAAC;IACvE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAsBjF"}

package/skill/resources/skill-reference-content.resource.d.ts

@@ -0,0 +1,20 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type Params = {
+    skillName: string;
+    referenceName: string;
+};
+/**
+ * Resource template for reading a specific reference document from a skill.
+ *
+ * URI: `skills://{skillName}/references/{referenceName}`
+ *
+ * Returns the reference markdown content with frontmatter stripped.
+ */
+export declare class SkillReferenceContentResource extends ResourceContext<Params> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    referenceNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: Params): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-reference-content.resource.d.ts.map

package/skill/resources/skill-reference-content.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-reference-content.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-reference-content.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAUpF,KAAK,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;;;GAMG;AACH,qBAQa,6BAA8B,SAAQ,eAAe,CAAC,MAAM,CAAC;IAClE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAK1E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAqBxE"}

package/skill/resources/skill-references-list.resource.d.ts

@@ -0,0 +1,19 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, ResourceCompletionResult } from '../../common/interfaces';
+type SkillNameParams = {
+    skillName: string;
+};
+/**
+ * Resource template listing all references for a skill.
+ *
+ * URI: `skills://{skillName}/references`
+ *
+ * Returns a JSON array of reference metadata (name, description, filename).
+ * Use `skills://{skillName}/references/{referenceName}` to read the content.
+ */
+export declare class SkillReferencesListResource extends ResourceContext<SkillNameParams> {
+    skillNameCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: SkillNameParams): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-references-list.resource.d.ts.map

package/skill/resources/skill-references-list.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-references-list.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-references-list.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAIpF,KAAK,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,qBASa,2BAA4B,SAAQ,eAAe,CAAC,eAAe,CAAC;IACzE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoBjF"}

package/skill/resources/skill-resource.helpers.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared helpers for skill resource templates.
+ *
+ * Extracts reusable logic for loading skills, reading files, and
+ * collecting completer values across the `skills://` resource scheme.
+ *
+ * @module skill/resources/skill-resource.helpers
+ */
+import type { ScopeEntry, SkillEntry } from '../../common';
+import type { SkillInstance } from '../skill.instance';
+import type { SkillLoadResult } from '../../common/entries/skill.entry';
+/**
+ * Get all MCP-visible skill entries from the scope's skill registry.
+ *
+ * @param scope - The active scope
+ * @returns Array of skill entries with visibility 'mcp' or 'both'
+ */
+export declare function getMcpVisibleSkills(scope: ScopeEntry): SkillEntry[];
+/**
+ * Get MCP-visible skill names filtered by an optional partial prefix.
+ *
+ * @param scope - The active scope
+ * @param partial - Optional prefix to filter names by
+ * @returns Array of matching skill names
+ */
+export declare function getMcpVisibleSkillNames(scope: ScopeEntry, partial?: string): string[];
+/**
+ * Load a skill by name, verifying MCP visibility.
+ *
+ * @param scope - The active scope
+ * @param skillName - Skill ID or name
+ * @returns The load result with skill content, tool availability info
+ * @throws Error if skill not found or not MCP-visible
+ */
+export declare function findAndLoadSkill(scope: ScopeEntry, skillName: string): Promise<{
+    loadResult: SkillLoadResult;
+    instance: SkillInstance;
+}>;
+/**
+ * Read a reference or example file from a skill's resource directory.
+ *
+ * @param instance - The skill instance
+ * @param resourceType - 'references' or 'examples'
+ * @param filename - The filename to read
+ * @returns The file content as a string
+ * @throws Error if the file cannot be read
+ */
+export declare function readSkillFile(instance: SkillInstance, resourceType: 'references' | 'examples', filename: string): Promise<string>;
+/**
+ * Read a skill file and parse its frontmatter.
+ *
+ * @param instance - The skill instance
+ * @param resourceType - 'references' or 'examples'
+ * @param filename - The filename to read
+ * @returns Parsed frontmatter and markdown body
+ */
+export declare function readAndParseSkillFile(instance: SkillInstance, resourceType: 'references' | 'examples', filename: string): Promise<{
+    frontmatter: Record<string, unknown>;
+    body: string;
+}>;
+/**
+ * Collect all reference names across all MCP-visible skills, filtered by partial.
+ *
+ * @param scope - The active scope
+ * @param partial - Optional prefix to filter by
+ * @returns Array of reference names
+ */
+export declare function collectAllReferenceNames(scope: ScopeEntry, partial?: string): Promise<string[]>;
+/**
+ * Collect all example names across all MCP-visible skills, filtered by partial.
+ *
+ * @param scope - The active scope
+ * @param partial - Optional prefix to filter by
+ * @returns Array of example names
+ */
+export declare function collectAllExampleNames(scope: ScopeEntry, partial?: string): Promise<string[]>;
+//# sourceMappingURL=skill-resource.helpers.d.ts.map

package/skill/resources/skill-resource.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resource.helpers.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skill-resource.helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAKxE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAMnE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrF;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,UAAU,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CA2BnE;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,GAAG,UAAU,EACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,YAAY,GAAG,UAAU,EACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAGjE;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBrG;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnG"}

package/skill/resources/skills-catalog.resource.d.ts

@@ -0,0 +1,14 @@
+import { ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext } from '../../common/interfaces';
+/**
+ * Static resource listing all MCP-visible skills.
+ *
+ * URI: `skills://catalog`
+ *
+ * Returns a JSON array of skill summaries including id, name, description,
+ * tags, and whether the skill has references/examples.
+ */
+export declare class SkillsCatalogResource extends ResourceContext {
+    execute(uri: string): Promise<ReadResourceResult>;
+}
+//# sourceMappingURL=skills-catalog.resource.d.ts.map

package/skill/resources/skills-catalog.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-catalog.resource.d.ts","sourceRoot":"","sources":["../../../src/skill/resources/skills-catalog.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI1D;;;;;;;GAOG;AACH,qBASa,qBAAsB,SAAQ,eAAe;IAClD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA8BxD"}

package/skill/skill-directory-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-directory-loader.d.ts","sourceRoot":"","sources":["../../src/skill/skill-directory-loader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB7E;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAmE3G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAEjG"}
+{"version":3,"file":"skill-directory-loader.d.ts","sourceRoot":"","sources":["../../src/skill/skill-directory-loader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyB7E;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAmE3G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAEjG"}

package/skill/skill-http.utils.d.ts

@@ -6,7 +6,8 @@
  * - /llm_full.txt - Full skills with instructions and tool schemas
  * - /skills API - JSON responses
  */
-import type { SkillContent, SkillEntry, ToolRegistryInterface } from '../common';
+import type { SkillContent, SkillEntry } from '../common';
+import type ToolRegistry from '../tool/tool.registry';
 import type { SkillVisibility, SkillResources } from '../common/metadata/skill.metadata';
 import type { SkillRegistryInterface as SkillRegistryInterfaceType } from './skill.registry';
 /**
@@ -50,7 +51,7 @@ export declare function formatSkillsForLlmCompact(skills: SkillEntry[]): string;
  * @param visibility - Optional visibility filter ('http' or 'both')
  * @returns Formatted plain text with full skill details
  */
-export declare function formatSkillsForLlmFull(registry: SkillRegistryInterfaceType, toolRegistry: ToolRegistryInterface, visibility?: SkillVisibility): Promise<string>;
+export declare function formatSkillsForLlmFull(registry: SkillRegistryInterfaceType, toolRegistry: ToolRegistry, visibility?: SkillVisibility): Promise<string>;
 /**
  * Format a skill with FULL tool schemas (input/output) - not just names.
  * Used by /llm_full.txt and enhanced loadSkill response.
@@ -61,7 +62,7 @@ export declare function formatSkillsForLlmFull(registry: SkillRegistryInterfaceT
  * @param toolRegistry - Tool registry for schema lookup
  * @returns Formatted markdown string
  */
-export declare function formatSkillForLLMWithSchemas(skill: SkillContent, availableTools: string[], missingTools: string[], toolRegistry: ToolRegistryInterface): string;
+export declare function formatSkillForLLMWithSchemas(skill: SkillContent, availableTools: string[], missingTools: string[], toolRegistry: ToolRegistry): string;
 /**
  * Skill API response structure.
  */

package/skill/skill-http.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-http.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill-http.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAa,MAAM,WAAW,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,IAAI,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAiCtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,0BAA0B,EACpC,YAAY,EAAE,qBAAqB,EACnC,UAAU,GAAE,eAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAuGR;AAaD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB,GACA,gBAAgB,CA6BlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,EAAE,CAMpG"}
+{"version":3,"file":"skill-http.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill-http.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,IAAI,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAiCtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,0BAA0B,EACpC,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,eAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,YAAY,GACzB,MAAM,CAuGR;AAaD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB,GACA,gBAAgB,CA6BlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,EAAE,CAMpG"}

package/skill/skill-md-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md-parser.d.ts","sourceRoot":"","sources":["../../src/skill/skill-md-parser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA+B3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAUnH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"skill-md-parser.d.ts","sourceRoot":"","sources":["../../src/skill/skill-md-parser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAIf,MAAM,mCAAmC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA+B3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAyIxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAUnH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/skill/skill-scope.helper.d.ts

@@ -9,8 +9,8 @@
 import type { FrontMcpLogger } from '../common';
 import type { SkillsConfigOptions } from '../common/types/options/skills-http';
 import type FlowRegistry from '../flows/flow.registry';
-import type ToolRegistry from '../tool/tool.registry';
 import type ProviderRegistry from '../provider/provider.registry';
+import type ResourceRegistry from '../resource/resource.registry';
 import type SkillRegistry from './skill.registry';
 /**
  * Options for registering skill capabilities.
@@ -20,8 +20,8 @@ export interface SkillScopeRegistrationOptions {
     skillRegistry: SkillRegistry;
     /** Flow registry for registering skill flows */
     flowRegistry: FlowRegistry;
-    /** Tool registry for registering skill tools */
-    toolRegistry: ToolRegistry;
+    /** Resource registry for registering skill resource templates */
+    resourceRegistry: ResourceRegistry;
     /** Provider registry for dependency injection */
     providers: ProviderRegistry;
     /** Skills configuration from @FrontMcp metadata */
@@ -30,11 +30,11 @@ export interface SkillScopeRegistrationOptions {
     logger: FrontMcpLogger;
 }
 /**
- * Register skill-related flows and tools in the scope.
+ * Register skill-related flows and resources in the scope.
  *
  * This function handles:
  * - Registering MCP flows for skill discovery/loading (SearchSkillsFlow, LoadSkillFlow)
- * - Registering skill MCP tools (searchSkills, loadSkill) unless disabled
+ * - Registering skill MCP resources (skills:// URI scheme) unless disabled
  * - Registering HTTP flows (llm.txt, llm_full.txt, /skills) when skillsConfig is enabled
  *
  * @param options - Registration options
@@ -44,7 +44,7 @@ export interface SkillScopeRegistrationOptions {
  * await registerSkillCapabilities({
  *   skillRegistry: this.scopeSkills,
  *   flowRegistry: this.scopeFlows,
- *   toolRegistry: this.scopeTools,
+ *   resourceRegistry: this.scopeResources,
  *   providers: this.scopeProviders,
  *   skillsConfig: this.metadata.skillsConfig,
  *   logger: this.logger,

package/skill/skill-scope.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-scope.helper.d.ts","sourceRoot":"","sources":["../../src/skill/skill-scope.helper.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kDAAkD;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,iDAAiD;IACjD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,kCAAkC;IAClC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrG"}
+{"version":3,"file":"skill-scope.helper.d.ts","sourceRoot":"","sources":["../../src/skill/skill-scope.helper.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kDAAkD;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,iEAAiE;IACjE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,iDAAiD;IACjD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,kCAAkC;IAClC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrG"}

package/skill/skill-storage.factory.d.ts

@@ -7,7 +7,7 @@
  * @module skill/skill-storage.factory
  */
 import type { FrontMcpLogger } from '../common';
-import type { ToolRegistryInterface } from '../common/interfaces/internal';
+import type ToolRegistry from '../tool/tool.registry';
 import type { SkillStorageProvider, SkillStorageProviderType } from './skill-storage.interface';
 import { SkillToolValidator } from './skill-validator';
 import { MemorySkillProviderOptions } from './providers/memory-skill.provider';
@@ -108,7 +108,7 @@ export interface SkillStorageFactoryOptions {
      * Tool registry for validating tool references.
      * Required for tool validation in search results.
      */
-    toolRegistry?: ToolRegistryInterface;
+    toolRegistry?: ToolRegistry;
     /**
      * Logger instance.
      */
@@ -186,7 +186,7 @@ export declare function createSkillStorageProvider(options?: SkillStorageFactory
  * @returns An in-memory skill storage provider
  */
 export declare function createMemorySkillProvider(options?: {
-    toolRegistry?: ToolRegistryInterface;
+    toolRegistry?: ToolRegistry;
     defaultTopK?: number;
     defaultMinScore?: number;
     logger?: FrontMcpLogger;

package/skill/skill-storage.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-storage.factory.d.ts","sourceRoot":"","sources":["../../src/skill/skill-storage.factory.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAuB,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAE9C;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAE7C;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,wBAAwB,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,0BAA+B,GACvC,iCAAiC,CA6EnC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,CAAC;CACpB,GACL,yBAAyB,CAiB3B"}
+{"version":3,"file":"skill-storage.factory.d.ts","sourceRoot":"","sources":["../../src/skill/skill-storage.factory.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAuB,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAE9C;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAE7C;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,wBAAwB,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,0BAA+B,GACvC,iCAAiC,CA6EnC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,CAAC;CACpB,GACL,yBAAyB,CAiB3B"}

package/skill/skill-validator.d.ts

@@ -1,4 +1,4 @@
-import { ToolRegistryInterface } from '../common/interfaces/internal';
+import type ToolRegistry from '../tool/tool.registry';
 /**
  * Result of validating tool availability for a skill.
  */
@@ -28,7 +28,7 @@ export interface ToolValidationResult {
  */
 export declare class SkillToolValidator {
     private readonly toolRegistry;
-    constructor(toolRegistry: ToolRegistryInterface);
+    constructor(toolRegistry: ToolRegistry);
     /**
      * Validate tool availability for a list of tool names.
      *

package/skill/skill-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-validator.d.ts","sourceRoot":"","sources":["../../src/skill/skill-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,YAAY,EAAE,qBAAqB;IAI/C;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,oBAAoB;IAsDhF;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBlF;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK1C;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAItC"}
+{"version":3,"file":"skill-validator.d.ts","sourceRoot":"","sources":["../../src/skill/skill-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,YAAY,EAAE,YAAY;IAItC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,oBAAoB;IAsDhF;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBlF;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK1C;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAItC"}

package/skill/skill.instance.d.ts

@@ -1,7 +1,7 @@
 import { EntryOwnerRef, SkillEntry, SkillRecord, SkillToolRef } from '../common';
 import { SkillContent } from '../common/interfaces';
 import ProviderRegistry from '../provider/provider.registry';
-import { Scope } from '../scope';
+import { ScopeEntry } from '../common';
 /**
  * Concrete implementation of a skill that can be loaded and searched.
  *
@@ -14,7 +14,7 @@ export declare class SkillInstance extends SkillEntry {
     /** The provider registry this skill is bound to */
     private readonly providersRef;
     /** The scope this skill operates in */
-    readonly scope: Scope;
+    readonly scope: ScopeEntry;
     /** Cached instructions (loaded lazily) */
     private cachedInstructions?;
     /** Cached skill content (built lazily) */
@@ -42,6 +42,10 @@ export declare class SkillInstance extends SkillEntry {
      * Load the full skill content.
      * Results are cached after the first load.
      */
+    /**
+     * Resolve the base directory for this skill (for file/reference resolution).
+     */
+    getBaseDir(): string | undefined;
     load(): Promise<SkillContent>;
     /**
      * Get tool references with normalized format.

package/skill/skill.instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.instance.d.ts","sourceRoot":"","sources":["../../src/skill/skill.instance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAa,WAAW,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAgBjC;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAEhD,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,0CAA0C;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAqB;IAE3C,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAEhC,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa;cAsBlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3C;;OAEG;IACM,cAAc,IAAI,MAAM;IAIjC;;;OAGG;IACY,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBlD;;;OAGG;IACY,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAoB5C;;OAEG;IACM,WAAW,IAAI,YAAY,EAAE;IAMtC;;OAEG;IACM,YAAY,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACM,OAAO,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACM,QAAQ,IAAI,OAAO;IAI5B;;OAEG;IACM,WAAW,IAAI,MAAM;IAI9B;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;OAMG;IACH,cAAc,IAAI,YAAY,GAAG,SAAS;CAa3C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,aAAa,GACnB,aAAa,CAEf"}
+{"version":3,"file":"skill.instance.d.ts","sourceRoot":"","sources":["../../src/skill/skill.instance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAa,WAAW,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAwC,MAAM,sBAAsB,CAAC;AAE1F,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBvC;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAEhD,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,0CAA0C;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAqB;IAE3C,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAEhC,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa;cAsBlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3C;;OAEG;IACM,cAAc,IAAI,MAAM;IAIjC;;;OAGG;IACY,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAuBlD;;;OAGG;IACH;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAUjB,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IA8C5C;;OAEG;IACM,WAAW,IAAI,YAAY,EAAE;IAMtC;;OAEG;IACM,YAAY,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACM,OAAO,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACM,QAAQ,IAAI,OAAO;IAI5B;;OAEG;IACM,WAAW,IAAI,MAAM;IAI9B;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;OAMG;IACH,cAAc,IAAI,YAAY,GAAG,SAAS;CAa3C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,aAAa,GACnB,aAAa,CAEf"}

package/skill/skill.registry.d.ts

@@ -1,11 +1,10 @@
 import { Token } from '@frontmcp/di';
-import { EntryLineage, EntryOwnerRef, SkillEntry, SkillType, SkillToolValidationMode } from '../common';
+import { EntryLineage, EntryOwnerRef, ScopeEntry, SkillEntry, SkillType, SkillToolValidationMode } from '../common';
 import { SkillChangeEvent } from './skill.events';
 import { SkillInstance } from './skill.instance';
 import { SkillRecord } from '../common/records';
 import ProviderRegistry from '../provider/provider.registry';
 import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
-import { Scope } from '../scope';
 import { SkillSearchOptions, SkillSearchResult, SkillLoadResult, SkillListOptions, SkillListResult } from './skill-storage.interface';
 import type { ExternalSkillProviderBase } from './providers/external-skill.provider';
 import type { SyncResult } from './sync/sync-state.interface';
@@ -177,7 +176,7 @@ export default class SkillRegistry extends RegistryAbstract<SkillInstance, Skill
     /** Tool validator for checking tool availability */
     private toolValidator?;
     /** The scope this registry operates in */
-    readonly scope: Scope;
+    readonly scope: ScopeEntry;
     /** Registry-level options for validation behavior */
     private readonly options;
     constructor(providers: ProviderRegistry, list: SkillType[], owner: EntryOwnerRef, options?: SkillRegistryOptions);

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

@@ -1 +1 @@
-{"version":3,"file":"skill.registry.d.ts","sourceRoot":"","sources":["../../src/skill/skill.registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill.registry.d.ts","sourceRoot":"","sources":["../../src/skill/skill.registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAa,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpH,OAAO,EAAE,gBAAgB,EAAgB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAuB,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAA+C,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAErH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,uBAAuB,CAAC;IAEhD;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,UAAU,EAAE,CAAC;IAE9D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAEjD;;;OAGG;IACH,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAEnE;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAElF;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjE;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/E;;;;OAIG;IACH,SAAS,CACP,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAA;KAAE,EACtE,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GACpC,MAAM,IAAI,CAAC;IAEd;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/C;;;;;;OAMG;IACH,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,mBAAmB,IAAI,yBAAyB,GAAG,SAAS,CAAC;IAE7D;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,aACnB,SAAQ,gBAAgB,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,CAChE,YAAW,sBAAsB;IAEjC,6BAA6B;IAC7B,KAAK,EAAE,aAAa,CAAC;IAErB,sCAAsC;IACtC,OAAO,CAAC,SAAS,CAAsB;IAEvC,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAA4C;IAE3D,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAA4B;IAE5C,mBAAmB;IACnB,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,cAAc,CAAmC;IAEzD,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAsB;IAErC,2CAA2C;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAE9C,kDAAkD;IAClD,OAAO,CAAC,gBAAgB,CAAC,CAA4B;IAErD,oDAAoD;IACpD,OAAO,CAAC,aAAa,CAAC,CAAqB;IAE3C,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB;cAqB7F,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,sBAAsB,CAAC,WAAW,CAAC;IAgBnF,SAAS,CAAC,UAAU,IAAI,IAAI;cAgBH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2EpD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDrF;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,UAAU,EAAE;IA6B7D;;OAEG;IACH,eAAe,IAAI,aAAa,EAAE;IAIlC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAKhD;;OAEG;IACH,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IASlE;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIvF;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAqDtE;;OAEG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAItE;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpF;;OAEG;IACH,SAAS,CACP,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAA;KAAE,EACtE,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GACpC,MAAM,IAAI;IAiBb;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAQ9C;;;;;;;;;;;;OAYG;IACG,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAoGxD,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,IAAI;IAUZ;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAa9D;;OAEG;IACH,mBAAmB,IAAI,yBAAyB,GAAG,SAAS;IAI5D;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAkDnD"}

package/skill/skill.utils.d.ts

@@ -1,6 +1,6 @@
 import { Token } from '@frontmcp/di';
 import { SkillMetadata, SkillRecord, SkillType, SkillInstructionSource } from '../common';
-import { SkillContent } from '../common/interfaces';
+import { SkillContent, SkillReferenceInfo, SkillExampleInfo } from '../common/interfaces';
 /**
  * Collect skill metadata from a decorated class.
  *
@@ -45,9 +45,26 @@ export declare function loadInstructions(source: SkillInstructionSource, basePat
  *
  * @param metadata - The skill metadata
  * @param instructions - The resolved instructions string
+ * @param resolvedReferences - Optional resolved reference metadata from references/ directory
  * @returns The full skill content
  */
-export declare function buildSkillContent(metadata: SkillMetadata, instructions: string): SkillContent;
+export declare function buildSkillContent(metadata: SkillMetadata, instructions: string, resolvedReferences?: SkillReferenceInfo[], resolvedExamples?: SkillExampleInfo[]): SkillContent;
+/**
+ * Scan an examples/ directory for .md files organized by reference subdirectories.
+ * Parses YAML frontmatter for name, description, reference, and level.
+ *
+ * @param examplesDir - Absolute path to the examples/ directory
+ * @returns Array of resolved example info, or undefined if no examples
+ */
+export declare function resolveExamples(examplesDir: string): Promise<SkillExampleInfo[] | undefined>;
+/**
+ * Scan a references/ directory for .md files and extract metadata.
+ * Parses YAML frontmatter for name/description, falls back to heading/paragraph.
+ *
+ * @param refsDir - Absolute path to the references/ directory
+ * @returns Array of resolved reference info, or undefined if no references
+ */
+export declare function resolveReferences(refsDir: string): Promise<SkillReferenceInfo[] | undefined>;
 /**
  * Format a skill for LLM consumption.
  *

package/skill/skill.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAA2C,MAAM,cAAc,CAAC;AAC9E,OAAO,EACL,aAAa,EAEb,WAAW,EAIX,SAAS,EAIT,sBAAsB,EAEvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,CAWlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CA0BzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAwBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,EAAE,CAW5D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBzG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAe7F;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAuE/G;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,EACxG,iBAAiB,EAAE,OAAO,GACzB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,EACnE,KAAK,EAAE,MAAM,GACZ,MAAM,CAyBR"}
+{"version":3,"file":"skill.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAA2C,MAAM,cAAc,CAAC;AAC9E,OAAO,EACL,aAAa,EAEb,WAAW,EAIX,SAAS,EAIT,sBAAsB,EAEvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK1F;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,CAWlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CA0BzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAwBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,EAAE,CAW5D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBzG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,EACzC,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,GACpC,YAAY,CA0Bd;AAqCD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAmElG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,GAAG,SAAS,CAAC,CA+ClG;AA8DD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAuE/G;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,EACxG,iBAAiB,EAAE,OAAO,GACzB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,EACnE,KAAK,EAAE,MAAM,GACZ,MAAM,CAyBR"}