@frontmcp/sdk 1.1.2 → 1.2.0

package/skill/cache/skill-http-cache.holder.d.ts

@@ -7,7 +7,7 @@
  * @module skill/cache/skill-http-cache.holder
  */
 import type { ScopeEntry } from '../../common/index.js';
-import { SkillHttpCache } from './skill-http-cache.js';
+import { type SkillHttpCache } from './skill-http-cache.js';
 /**
  * Get or create a skill HTTP cache for a scope.
  *

package/skill/cache/skill-http-cache.holder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-http-cache.holder.d.ts","sourceRoot":"","sources":["../../../src/skill/cache/skill-http-cache.holder.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAc7E;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkCzF;AA0CD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}
+{"version":3,"file":"skill-http-cache.holder.d.ts","sourceRoot":"","sources":["../../../src/skill/cache/skill-http-cache.holder.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAalF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkCzF;AA0CD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}

package/skill/flows/http/skills-api.flow.d.ts

@@ -16,6 +16,9 @@ declare const stateSchema: import("@frontmcp/lazy-zod").ZodObject<{
     tools: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
     limit: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
     offset: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
+    category: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    minRating: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
+    semanticQuery: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 declare const outputSchema: import("@frontmcp/lazy-zod").ZodObject<{
     kind: import("@frontmcp/lazy-zod").ZodLiteral<"json">;
@@ -70,6 +73,12 @@ export default class SkillsApiFlow extends FlowBase<typeof name> {
     handleRequest(): Promise<void>;
     private handleGetSkill;
     private handleSearchSkills;
+    /**
+     * Lazily resolve the optional semantic-search provider. Wrapped in a
+     * helper so the flow stays a single-class file and tests can stub the
+     * provider via the scope DI container.
+     */
+    private tryGetSemanticProvider;
     private handleListSkills;
 }
 export {};

package/skill/flows/http/skills-api.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-api.flow.d.ts","sourceRoot":"","sources":["../../../../src/skill/flows/http/skills-api.flow.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,QAAQ,EAQR,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAQzB,QAAA,MAAM,WAAW;;;;gCAAkB,CAAC;AAEpC,QAAA,MAAM,WAAW;;;;;;;;;;;;gCAQf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;gCAAiB,CAAC;AAEpC,QAAA,MAAM,IAAI;;;CAG2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,iBAAiB,EAAE,cAAc,CAC/B,aAAa,EACb,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,iBAA0B,CAAC;AAGxC;;;;;;;;GAQG;AAWH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAC9D,MAAM,2CAA2C;IAEjD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAsBhE,YAAY;IAsCZ,YAAY;IAqEZ,aAAa;YAuCL,cAAc;YA8Dd,kBAAkB;YAkClB,gBAAgB;CA2C/B"}
+{"version":3,"file":"skills-api.flow.d.ts","sourceRoot":"","sources":["../../../../src/skill/flows/http/skills-api.flow.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,QAAQ,EAQR,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AASzB,QAAA,MAAM,WAAW;;;;gCAAkB,CAAC;AAEpC,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;gCAWf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;gCAAiB,CAAC;AAEpC,QAAA,MAAM,IAAI;;;CAG2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,iBAAiB,EAAE,cAAc,CAC/B,aAAa,EACb,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,iBAA0B,CAAC;AAGxC;;;;;;;;GAQG;AAWH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAC9D,MAAM,2CAA2C;IAEjD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAsBhE,YAAY;IAsCZ,YAAY;IA+FZ,aAAa;YA2CL,cAAc;YA8Dd,kBAAkB;IAqHhC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;YAoChB,gBAAgB;CA0D/B"}

package/skill/flows/search-skills.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-skills.flow.d.ts","sourceRoot":"","sources":["../../../src/skill/flows/search-skills.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAAgD,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAKjH,QAAA,MAAM,WAAW;;;;;;;;;;;;gCAYf,CAAC;AAGH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;gCAmBhB,CAAC;AAKH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAUf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,eAAe,EAAE,cAAc,CAC7B,gBAAgB,EAChB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,eAAwB,CAAC;AAGtC;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACjE,MAAM,wCAA8C;IAG9C,UAAU;IAyBV,MAAM;IAoBN,QAAQ;CA6Df"}
+{"version":3,"file":"search-skills.flow.d.ts","sourceRoot":"","sources":["../../../src/skill/flows/search-skills.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAAgD,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAwCjH,QAAA,MAAM,WAAW;;;;;;;;;;;;gCAYf,CAAC;AAGH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;gCAmBhB,CAAC;AAKH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAUf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,eAAe,EAAE,cAAc,CAC7B,gBAAgB,EAChB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,eAAwB,CAAC;AAGtC;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACjE,MAAM,wCAA8C;IAG9C,UAAU;IAyBV,MAAM;IAyCN,QAAQ;CA6Df"}

package/skill/index.d.ts

@@ -64,10 +64,15 @@ export { parseSkillMdFrontmatter, skillMdFrontmatterToMetadata, loadSkillMdFile,
 export type { SkillMdParseResult } from './skill-md-parser';
 export { loadSkillDirectory, scanSkillResources, skillDir } from './skill-directory-loader';
 export type { ScanResult } from './skill-directory-loader';
+export { SkillSemanticSearchToken } from './semantic/skill-semantic-search.interface';
+export type { SkillSemanticSearchProvider } from './semantic/skill-semantic-search.interface';
 export { formatSkillsForLlmCompact, formatSkillsForLlmFull, formatSkillForLLMWithSchemas, skillToApiResponse, filterSkillsByVisibility, } from './skill-http.utils';
 export type { CompactSkillSummary } from './skill-http.utils';
 export { SearchSkillsFlow, LoadSkillFlow } from './flows';
-export { getSkillResources, SkillsCatalogResource, SkillContentResource, SkillContentAliasResource, SkillReferencesListResource, SkillReferenceContentResource, SkillExamplesListResource, SkillExampleContentResource, getMcpVisibleSkills, getMcpVisibleSkillNames, findAndLoadSkill, readSkillFile, readAndParseSkillFile, collectAllReferenceNames, collectAllExampleNames, } from './resources';
+export { SEP_2640_EXTENSION_ID, SEP_2640_META_NAMESPACE, SKILL_ARCHIVE_MIME_TYPES, SKILL_INDEX_MIME_TYPE, SKILL_INDEX_SCHEMA_URI, SKILL_INDEX_URI, SKILL_MD_MIME_TYPE, SKILL_MD_PRIORITY, SKILL_SUPPORT_PRIORITY, SKILL_URI_SCHEME, buildArchiveIndexEntry, buildResourceTemplateIndexEntry, buildSkillIndex, buildSkillMdIndexEntry, buildSkillUri, isSkillIndexUri, isSkillUri, parseSkillUri, parseSkillUriWithKnownSkill, serializeSkillMd, validateSkillPath, type ParsedSkillUri, type SkillIndexDocument, type SkillIndexEntry, type SkillIndexEntryType, } from './sep-2640';
+export { getSep2640Resources, Sep2640SkillFileResource, Sep2640SkillIndexResource, Sep2640SkillMdResource, } from './sep-2640/resources';
+export { findAndLoadSkillByPath, findSkillByPath, getSepVisibleSkills, readSkillFileByPath, } from './sep-2640/sep-2640.resource-helpers';
+export { findNestedSkillMd } from './skill-directory-loader';
 export { SkillSessionManager } from './session/skill-session.manager';
 export { MemorySkillSessionStore, createSkillSessionStore } from './session/skill-session-store.interface';
 export type { SkillSessionStore } from './session/skill-session-store.interface';
@@ -81,8 +86,12 @@ export { SkillValidationError } from './errors/skill-validation.error';
 export type { SkillValidationResult, SkillValidationReport } from './errors/skill-validation.error';
 export { registerSkillCapabilities } from './skill-scope.helper';
 export type { SkillScopeRegistrationOptions } from './skill-scope.helper';
+export { registerSkillAuditWriter, setSkillAuditFactory, hasSkillAuditFactory } from './skill-audit.helper';
+export type { AuditModuleShape, SkillAuditFactory } from './skill-audit.helper';
 export { detectSkillsOnlyMode, isSkillsOnlySession } from './skill-mode.utils';
 export type { SkillsOnlySessionPayload } from './skill-mode.utils';
+export { buildSkillsCatalogSummary, composeInitializeInstructions, buildChannelInstructions, } from './skill-instructions.helper';
+export type { InjectInstructionsPolicy } from './skill-instructions.helper';
 export { SkillHttpAuthValidator, createSkillHttpAuthValidator } from './auth';
 export type { SkillHttpAuthContext, SkillHttpAuthResult, SkillHttpAuthValidatorOptions } from './auth';
 export { MemorySkillHttpCache, RedisSkillHttpCache, createSkillHttpCache, getSkillHttpCache, invalidateScopeCache, invalidateSkillInCache, disposeAllCaches, } from './cache';

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/providers/memory-skill.provider.d.ts

@@ -1,6 +1,6 @@
-import { SkillContent } from '../../common/interfaces';
-import { SkillToolValidator } from '../skill-validator';
-import { SkillStorageProviderType, SkillSearchOptions, SkillSearchResult, SkillLoadResult, SkillListOptions, SkillListResult, MutableSkillStorageProvider } from '../skill-storage.interface';
+import { type SkillContent } from '../../common/interfaces';
+import { type MutableSkillStorageProvider, type SkillListOptions, type SkillListResult, type SkillLoadResult, type SkillSearchOptions, type SkillSearchResult, type SkillStorageProviderType } from '../skill-storage.interface';
+import { type SkillToolValidator } from '../skill-validator';
 /**
  * Configuration options for MemorySkillProvider.
  */

package/skill/providers/memory-skill.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-skill.provider.d.ts","sourceRoot":"","sources":["../../../src/skill/providers/memory-skill.provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAwB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAmGpC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,2BAA2B;IACrE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAY;IAEnD,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,0BAA+B;IAWpD;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAI/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsFrF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA+BtD,IAAI,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgD9D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC,KAAK,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBlF,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA0D3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiCvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,aAAa;CAGtB"}
+{"version":3,"file":"memory-skill.provider.d.ts","sourceRoot":"","sources":["../../../src/skill/providers/memory-skill.provider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,kBAAkB,EAA6B,MAAM,oBAAoB,CAAC;AAmGxF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,2BAA2B;IACrE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAY;IAEnD,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAqB;IAC3C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,0BAA+B;IAWpD;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAI/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsFrF,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA+BtD,IAAI,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgD9D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC,KAAK,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBlF,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA0D3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiCvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,aAAa;CAGtB"}

package/skill/semantic/index.d.ts

@@ -0,0 +1,2 @@
+export { SkillSemanticSearchToken, type SkillSemanticSearchProvider } from './skill-semantic-search.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skill/semantic/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,KAAK,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}

package/skill/semantic/skill-semantic-search.interface.d.ts

@@ -0,0 +1,41 @@
+import type { Token } from '@frontmcp/di';
+import type { SkillContent } from '../../common/interfaces/skill.interface';
+/**
+ * Pluggable semantic-search backend for the skills HTTP API.
+ *
+ * Implementations may keep their index in-memory, persist to a vector DB, or
+ * delegate to a managed service. The SDK only ever calls these methods
+ * through the DI token — the host owns the lifecycle.
+ */
+export interface SkillSemanticSearchProvider {
+    /** Stable name (used in warning messages and traces). */
+    readonly name: string;
+    /**
+     * Add or replace a skill in the index. Called from
+     * `SkillRegistry.registerSkillContent` after the in-memory state is mutated
+     * so the index is always at least eventually consistent.
+     */
+    index(skillId: string, content: SkillContent): Promise<void>;
+    /**
+     * Remove a skill from the index. Called from `unregisterSkill`.
+     */
+    remove(skillId: string): Promise<void>;
+    /**
+     * Search for the top-K skills matching `query`. Returns sorted results
+     * (highest score first); the HTTP flow then applies category/min-rating/
+     * tags/tools filters on top of these.
+     */
+    search(query: string, limit: number): Promise<{
+        skillId: string;
+        score: number;
+    }[]>;
+    /** Optional teardown hook fired on scope dispose. */
+    dispose?(): Promise<void>;
+}
+/**
+ * DI token for the host-supplied semantic-search provider. Resolved lazily
+ * by the skills HTTP flow via `tryGet` so absent providers fall back to
+ * text search rather than throwing.
+ */
+export declare const SkillSemanticSearchToken: Token<SkillSemanticSearchProvider>;
+//# sourceMappingURL=skill-semantic-search.interface.d.ts.map

package/skill/semantic/skill-semantic-search.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-semantic-search.interface.d.ts","sourceRoot":"","sources":["../../../src/skill/semantic/skill-semantic-search.interface.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAEpF,qDAAqD;IACrD,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,2BAA2B,CAEjC,CAAC"}

package/skill/sep-2640/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SEP-2640 (Skills Extension) conformance helpers.
+ *
+ * This module implements the convention defined by MCP SEP-2640 for serving
+ * Agent Skills over MCP using the Resources primitive and the singular
+ * `skill://` URI scheme — the only URI scheme FrontMCP serves skills under.
+ *
+ * @module skill/sep-2640
+ */
+export { SEP_2640_EXTENSION_ID, SEP_2640_META_NAMESPACE, SKILL_ARCHIVE_MIME_TYPES, SKILL_INDEX_MIME_TYPE, SKILL_INDEX_SCHEMA_URI, SKILL_INDEX_URI, SKILL_MD_MIME_TYPE, SKILL_MD_PRIORITY, SKILL_SUPPORT_PRIORITY, SKILL_URI_SCHEME, type SkillIndexDocument, type SkillIndexEntry, type SkillIndexEntryType, } from './sep-2640.constants';
+export { buildSkillUri, isSkillIndexUri, isSkillUri, parseSkillUri, parseSkillUriWithKnownSkill, validateSkillPath, type ParsedSkillUri, } from './sep-2640.uri';
+export { buildArchiveIndexEntry, buildResourceTemplateIndexEntry, buildSkillIndex, buildSkillMdIndexEntry, metadataToContentStub, serializeSkillMd, type IndexEntryInput, } from './sep-2640.builders';
+//# sourceMappingURL=index.d.ts.map

package/skill/sep-2640/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,2BAA2B,EAC3B,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/skill/sep-2640/resources/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SEP-2640 (Skills Extension) MCP resources.
+ *
+ * Three resources:
+ *   - `skill://index.json`              — discovery index (Sep2640SkillIndexResource)
+ *   - `skill://{+skillPath}/SKILL.md`    — raw SKILL.md       (Sep2640SkillMdResource)
+ *   - `skill://{+skillPath}/{+filePath}` — generic sub-files  (Sep2640SkillFileResource)
+ *
+ * Order matters at registration time: the SKILL.md template MUST be
+ * registered before the generic file template so the more-specific match
+ * wins.
+ */
+import { Sep2640SkillFileResource } from './skill-file.resource';
+import { Sep2640SkillIndexResource } from './skill-index.resource';
+import { Sep2640SkillMdResource } from './skill-md.resource';
+export { Sep2640SkillFileResource, Sep2640SkillIndexResource, Sep2640SkillMdResource };
+/**
+ * Constructor type for SEP-2640 resource classes. The concrete resource
+ * classes (`Sep2640SkillIndexResource`, `Sep2640SkillMdResource`,
+ * `Sep2640SkillFileResource`) are MCP `Resource` / `ResourceTemplate`
+ * subclasses; consumers register them via `registerDynamicResource`.
+ */
+export type Sep2640ResourceCtor = typeof Sep2640SkillIndexResource | typeof Sep2640SkillMdResource | typeof Sep2640SkillFileResource;
+/**
+ * Get all SEP-2640 conformance resources in registration-priority order.
+ * The index resource and SKILL.md template come first; the generic file
+ * template is last so SKILL.md is matched by its dedicated route.
+ */
+export declare function getSep2640Resources(): Sep2640ResourceCtor[];
+//# sourceMappingURL=index.d.ts.map

package/skill/sep-2640/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/skill/sep-2640/resources/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,yBAAyB,GAChC,OAAO,sBAAsB,GAC7B,OAAO,wBAAwB,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,EAAE,CAE3D"}

package/skill/sep-2640/resources/skill-file.resource.d.ts

@@ -0,0 +1,25 @@
+import { type ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, type ResourceCompletionResult } from '../../../common/interfaces';
+type Params = {
+    skillPath: string;
+    filePath: string;
+};
+/**
+ * `skill://{+skillPath}/{+filePath}` — generic sub-file resource per SEP-2640.
+ *
+ * Exposes any file inside a skill directory: references, examples, scripts,
+ * assets, top-level files like `LICENSE`, etc. The SKILL.md route is matched
+ * by a more specific template (`Sep2640SkillMdResource`) and handled there;
+ * this template covers everything else.
+ *
+ * Path traversal is blocked at the resolver layer
+ * (`readSkillFileByPath`), and `..` / `.` segments in `filePath` are
+ * rejected outright.
+ */
+export declare class Sep2640SkillFileResource extends ResourceContext<Params> {
+    skillPathCompleter(partial: string): Promise<ResourceCompletionResult>;
+    filePathCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: Params): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-file.resource.d.ts.map

package/skill/sep-2640/resources/skill-file.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file.resource.d.ts","sourceRoot":"","sources":["../../../../src/skill/sep-2640/resources/skill-file.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAU5F,KAAK,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,qBAOa,wBAAyB,SAAQ,eAAe,CAAC,MAAM,CAAC;IAC7D,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAwBrE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA+BxE"}

package/skill/sep-2640/resources/skill-index.resource.d.ts

@@ -0,0 +1,29 @@
+import { type ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext } from '../../../common/interfaces';
+/**
+ * `skill://index.json` — the SEP-2640 well-known discovery resource.
+ *
+ * Mirrors the agentskills.io discovery RFC v0.2.0 shape:
+ *
+ * ```json
+ * {
+ *   "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+ *   "skills": [
+ *     {
+ *       "name": "git-workflow",
+ *       "type": "skill-md",
+ *       "description": "...",
+ *       "url": "skill://git-workflow/SKILL.md"
+ *     }
+ *   ]
+ * }
+ * ```
+ *
+ * Per SEP-2640 §Discovery, hosts MUST NOT treat an absent or empty index
+ * as proof that a server has no skills — direct readability via
+ * `resources/read` is the baseline.
+ */
+export declare class Sep2640SkillIndexResource extends ResourceContext {
+    execute(uri: string): Promise<ReadResourceResult>;
+}
+//# sourceMappingURL=skill-index.resource.d.ts.map

package/skill/sep-2640/resources/skill-index.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-index.resource.d.ts","sourceRoot":"","sources":["../../../../src/skill/sep-2640/resources/skill-index.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAK7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBASa,yBAA0B,SAAQ,eAAe;IACtD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkDxD"}

package/skill/sep-2640/resources/skill-md.resource.d.ts

@@ -0,0 +1,23 @@
+import { type ReadResourceResult } from '@frontmcp/protocol';
+import { ResourceContext, type ResourceCompletionResult } from '../../../common/interfaces';
+type Params = {
+    skillPath: string;
+};
+/**
+ * `skill://{+skillPath}/SKILL.md` — SEP-2640 conformant SKILL.md endpoint.
+ *
+ * Returns the **raw** SKILL.md content (YAML frontmatter + markdown body)
+ * so hosts can parse the result identically to a filesystem-sourced skill,
+ * fulfilling the SEP's "Hosts: Unified Treatment" guidance.
+ *
+ * The `{+skillPath}` template variable matches one or more `/`-separated
+ * path segments (RFC 6570 reserved expansion), supporting both flat
+ * (`skill://git-workflow/SKILL.md`) and nested
+ * (`skill://acme/billing/refunds/SKILL.md`) URI shapes.
+ */
+export declare class Sep2640SkillMdResource extends ResourceContext<Params> {
+    skillPathCompleter(partial: string): Promise<ResourceCompletionResult>;
+    execute(uri: string, params: Params): Promise<ReadResourceResult>;
+}
+export {};
+//# sourceMappingURL=skill-md.resource.d.ts.map

package/skill/sep-2640/resources/skill-md.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.resource.d.ts","sourceRoot":"","sources":["../../../../src/skill/sep-2640/resources/skill-md.resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAK5F,KAAK,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,qBAQa,sBAAuB,SAAQ,eAAe,CAAC,MAAM,CAAC;IAC3D,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAcxE"}

package/skill/sep-2640/sep-2640.builders.d.ts

@@ -0,0 +1,55 @@
+import type { SkillContent } from '../../common/interfaces';
+import type { SkillMetadata } from '../../common/metadata';
+import { type SkillIndexDocument, type SkillIndexEntry } from './sep-2640.constants';
+/**
+ * Input for building an index entry from a registered skill.
+ */
+export interface IndexEntryInput {
+    name: string;
+    description: string;
+    /**
+     * Multi-segment skill path. The final segment MUST equal `name`. Defaults
+     * to `[name]` for flat skills.
+     */
+    skillPathSegments?: string[];
+}
+/**
+ * Build a single `type: "skill-md"` entry. The `url` is always
+ * `skill://<skill-path>/SKILL.md`.
+ */
+export declare function buildSkillMdIndexEntry(input: IndexEntryInput): SkillIndexEntry;
+/**
+ * Build a `type: "mcp-resource-template"` entry for a parameterised skill
+ * namespace. Per SEP-2640, the `url` is an RFC 6570 URI template that
+ * resolves to `SKILL.md` resource URIs.
+ */
+export declare function buildResourceTemplateIndexEntry(description: string, uriTemplate: string): SkillIndexEntry;
+/**
+ * Build a `type: "archive"` entry. The `url` is the resource URI of the
+ * packed archive (`application/zip` or `application/x-tar`).
+ */
+export declare function buildArchiveIndexEntry(description: string, archiveUri: string, name?: string): SkillIndexEntry;
+/**
+ * Wrap a list of entries in the SEP-2640 index document shape.
+ */
+export declare function buildSkillIndex(entries: SkillIndexEntry[]): SkillIndexDocument;
+/**
+ * Serialise a SkillContent back to SKILL.md form (YAML frontmatter + body).
+ *
+ * This is what `resources/read` returns for `skill://<name>/SKILL.md` so
+ * hosts can parse the result identically to a filesystem skill — fulfilling
+ * SEP-2640's "Unified Treatment of Filesystem and MCP Skills" guidance.
+ *
+ * Note: instructions may contain references / examples tables that the
+ * SDK auto-appends when loading; for the SEP route we restore the *raw*
+ * body. Callers that already have raw instructions (e.g. parsed from a
+ * SKILL.md file) should pass `rawInstructions` to bypass any reconstructed
+ * content.
+ */
+export declare function serializeSkillMd(skill: SkillContent, rawInstructions?: string): string;
+/**
+ * Synthesize a SkillContent from raw SkillMetadata for cases where the
+ * index needs metadata-only access (no instructions loaded yet).
+ */
+export declare function metadataToContentStub(metadata: SkillMetadata): IndexEntryInput;
+//# sourceMappingURL=sep-2640.builders.d.ts.map

package/skill/sep-2640/sep-2640.builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep-2640.builders.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/sep-2640.builders.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAA0B,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG7G;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAQ9E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAMzG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAQ9G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,kBAAkB,CAK9E;AAsCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAYtF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAS9E"}

package/skill/sep-2640/sep-2640.constants.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Constants for MCP SEP-2640 (Skills Extension) conformance.
+ *
+ * SEP-2640 defines a convention for serving Agent Skills over MCP using the
+ * existing Resources primitive under the `skill://` URI scheme. The extension
+ * adds no new protocol methods — only a capability declaration and URI shape.
+ *
+ * @see https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640
+ * @see https://github.com/modelcontextprotocol/experimental-ext-skills
+ */
+/**
+ * The extension identifier as declared in the server `initialize` response
+ * under `capabilities.extensions[<id>]`.
+ */
+export declare const SEP_2640_EXTENSION_ID: "io.modelcontextprotocol/skills";
+/**
+ * Reverse-DNS namespace prefix for `_meta` keys on skill resources.
+ * Per skill-meta-keys.md, MCP-transport-specific metadata SHOULD use this
+ * prefix; skill-level semantics belong in frontmatter, not `_meta`.
+ */
+export declare const SEP_2640_META_NAMESPACE: "io.modelcontextprotocol.skills/";
+/**
+ * Singular `skill://` URI scheme used by SEP-2640 and four converged
+ * implementations (FastMCP 3.0, NimbleBrain, skilljack-mcp, skillsdotnet).
+ *
+ * This is the only URI scheme FrontMCP serves skills under — there is no
+ * back-compat plural `skills://` scheme.
+ */
+export declare const SKILL_URI_SCHEME: "skill://";
+/**
+ * Well-known URI for the skill discovery index, modelled after the
+ * Agent Skills `/.well-known/agent-skills/index.json` shape.
+ */
+export declare const SKILL_INDEX_URI: "skill://index.json";
+/**
+ * Schema URI for the index document, matching the agentskills.io
+ * discovery RFC v0.2.0. Clients SHOULD verify this before parsing.
+ */
+export declare const SKILL_INDEX_SCHEMA_URI: "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
+/**
+ * Index entry types per SEP-2640 §Discovery.
+ */
+export type SkillIndexEntryType = 'skill-md' | 'mcp-resource-template' | 'archive';
+/**
+ * SEP-2640 index entry. Mirrors the agentskills.io well-known index
+ * format with two adjustments: `url` is a full MCP resource URI (any
+ * scheme the server serves), and `digest` is omitted (transport handles
+ * integrity over an authenticated MCP connection).
+ */
+export interface SkillIndexEntry {
+    /** Type of entry. */
+    type: SkillIndexEntryType;
+    /** Skill name — required for `skill-md`, omitted for `mcp-resource-template`. */
+    name?: string;
+    /** Description of the skill or addressable space. */
+    description: string;
+    /**
+     * For `skill-md`: full resource URI of the skill's `SKILL.md`.
+     * For `mcp-resource-template`: an RFC 6570 URI template.
+     * For `archive`: full resource URI of the archive resource.
+     */
+    url: string;
+}
+/**
+ * SEP-2640 index document shape.
+ */
+export interface SkillIndexDocument {
+    $schema: typeof SKILL_INDEX_SCHEMA_URI;
+    skills: SkillIndexEntry[];
+}
+/**
+ * Recommended MIME type for a `SKILL.md` resource.
+ */
+export declare const SKILL_MD_MIME_TYPE: "text/markdown";
+/**
+ * Recommended MIME type for the index resource.
+ */
+export declare const SKILL_INDEX_MIME_TYPE: "application/json";
+/**
+ * MIME types acceptable for archive distribution per SEP-2640 ADR
+ * 2026-04-19 (Archive Distribution).
+ */
+export declare const SKILL_ARCHIVE_MIME_TYPES: readonly ["application/zip", "application/x-tar"];
+/**
+ * Recommended `annotations.priority` for the primary `SKILL.md` resource.
+ * Hosts use this to decide what to load first under progressive disclosure.
+ */
+export declare const SKILL_MD_PRIORITY: 0.8;
+/**
+ * Recommended `annotations.priority` for supporting reference / example /
+ * script files.
+ */
+export declare const SKILL_SUPPORT_PRIORITY: 0.3;
+//# sourceMappingURL=sep-2640.constants.d.ts.map

package/skill/sep-2640/sep-2640.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep-2640.constants.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/sep-2640.constants.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAG,gCAAyC,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAG,iCAA0C,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAG,UAAmB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAG,oBAA6B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAG,4DAAqE,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,uBAAuB,GAAG,SAAS,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mDAAoD,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAG,GAAY,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAG,GAAY,CAAC"}

package/skill/sep-2640/sep-2640.last-modified.d.ts

@@ -0,0 +1,9 @@
+import { type SkillEntry } from '../../common';
+/**
+ * Best-effort `lastModified` resolver. Returns an ISO 8601 timestamp
+ * string when the skill is file-backed and the file is reachable; returns
+ * `undefined` otherwise (caller MUST treat absence as "unknown", not
+ * "never modified").
+ */
+export declare function resolveLastModifiedForSkill(skill: SkillEntry): Promise<string | undefined>;
+//# sourceMappingURL=sep-2640.last-modified.d.ts.map

package/skill/sep-2640/sep-2640.last-modified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep-2640.last-modified.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/sep-2640.last-modified.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahG"}

package/skill/sep-2640/sep-2640.per-skill.d.ts

@@ -0,0 +1,38 @@
+import { type FrontMcpLogger, type ResourceFunctionRecord, type ScopeEntry, type SkillEntry } from '../../common';
+import type ResourceRegistry from '../../resource/resource.registry';
+/**
+ * Build a `ResourceFunctionRecord` for a single skill. The function reads
+ * the skill via `findAndLoadSkillByPath` and emits raw SKILL.md.
+ *
+ * The record carries SEP-conformant metadata:
+ *   - `name` = skill's frontmatter name
+ *   - `description` = skill's frontmatter description
+ *   - `mimeType` = `text/markdown`
+ *   - `annotations.audience` = `["assistant"]`
+ *   - `annotations.priority` = 0.8 (the SEP-recommended SKILL.md priority)
+ *   - `annotations.lastModified` (when supplied — populated for file-backed skills)
+ *   - `_meta.io.modelcontextprotocol.skills/path` = the skill's `<skill-path>`
+ *
+ * The function is bound to the scope so `resources/read` invocation
+ * resolves through the active SkillRegistry.
+ */
+export declare function buildPerSkillResourceRecord(scope: ScopeEntry, skill: SkillEntry, opts?: {
+    lastModified?: string;
+}): ResourceFunctionRecord;
+/**
+ * Register one concrete `Resource` per MCP-visible skill so
+ * `resources/list` returns SEP-conformant entries (frontmatter-derived
+ * `name`/`description`, audience/priority annotations).
+ *
+ * This is in addition to — not a replacement for — the SKILL.md template
+ * (`Sep2640SkillMdResource`). Hosts may discover skills either via
+ * `resources/list` (concrete) or `skill://index.json` (discovery doc).
+ */
+export declare function registerPerSkillResources(options: {
+    scope: ScopeEntry;
+    resourceRegistry: ResourceRegistry;
+    skills: SkillEntry[];
+    logger: FrontMcpLogger;
+    resolveLastModified?: (skill: SkillEntry) => Promise<string | undefined>;
+}): Promise<void>;
+//# sourceMappingURL=sep-2640.per-skill.d.ts.map

package/skill/sep-2640/sep-2640.per-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep-2640.per-skill.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/sep-2640.per-skill.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE3B,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AAMrE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,sBAAsB,CAgDxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,KAAK,EAAE,UAAU,CAAC;IAClB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1E,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB"}

package/skill/sep-2640/sep-2640.resource-helpers.d.ts

@@ -0,0 +1,57 @@
+import type { ScopeEntry, SkillEntry } from '../../common';
+import type { SkillLoadResult } from '../../common/entries/skill.entry';
+import type { SkillInstance } from '../skill.instance';
+/**
+ * Get all skills visible under MCP that the SEP-2640 transport binding
+ * should surface (skills whose `visibility` allows MCP).
+ */
+export declare function getSepVisibleSkills(scope: ScopeEntry): SkillEntry[];
+/**
+ * Look up a skill by its effective `<skill-path>` (joined by `/`).
+ *
+ * Falls back to lookup-by-name when no skill matches the full path —
+ * supporting clients that pass `skill://my-skill/SKILL.md` for skills
+ * registered without an explicit `metadata.skillPath`.
+ */
+export declare function findSkillByPath(scope: ScopeEntry, skillPath: string): SkillEntry | undefined;
+/**
+ * Load a skill addressed by its `<skill-path>`, asserting MCP visibility.
+ */
+export declare function findAndLoadSkillByPath(scope: ScopeEntry, skillPath: string): Promise<{
+    loadResult: SkillLoadResult;
+    instance: SkillInstance;
+}>;
+/**
+ * Result of reading a skill sub-file. Mirrors the MCP
+ * `TextResourceContents` / `BlobResourceContents` split: text resources
+ * carry decoded UTF-8 string content, binary resources carry base64-
+ * encoded bytes that the resource handler emits via `blob`.
+ */
+export type SkillFileReadResult = {
+    kind: 'text';
+    content: string;
+    mimeType: string;
+} | {
+    kind: 'blob';
+    blob: string;
+    mimeType: string;
+};
+/**
+ * Read an arbitrary file inside a skill directory by URI-relative path.
+ *
+ * Resolution order:
+ *   1. **In-memory resolved references / examples** — for inline
+ *      (filesystem-agnostic) skills the SkillContent carries the bundled
+ *      body inline; we serve from there first. This satisfies SEP-2640's
+ *      "skills MUST function correctly without a local filesystem"
+ *      requirement.
+ *   2. **Filesystem under the skill's base directory** — for file-backed
+ *      skills with declared `resources.{references,examples,scripts,assets}`
+ *      directories or top-level files like `LICENSE`. Path-traversal is
+ *      blocked via prefix check + explicit `.` / `..` segment rejection.
+ *
+ * Returns either a text or blob result depending on the MIME type, so
+ * binary assets (images, archives) are not corrupted by UTF-8 decoding.
+ */
+export declare function readSkillFileByPath(instance: SkillInstance, filePath: string): Promise<SkillFileReadResult>;
+//# sourceMappingURL=sep-2640.resource-helpers.d.ts.map

package/skill/sep-2640/sep-2640.resource-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep-2640.resource-helpers.d.ts","sourceRoot":"","sources":["../../../src/skill/sep-2640/sep-2640.resource-helpers.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAInE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAe5F;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,UAAU,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CAiBnE;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAkBrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkIjH"}