@frontmcp/sdk 0.7.2 → 0.8.0

package/builtin/config/providers/config.service.d.ts

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { DottedPath, PathValue } from '../../../common/providers/base-config.provider';
+/**
+ * Error thrown when a required config key is missing.
+ */
+export declare class ConfigMissingError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+/**
+ * Error thrown when config validation fails.
+ */
+export declare class ConfigValidationError extends Error {
+    readonly zodError: z.ZodError;
+    constructor(message: string, zodError: z.ZodError);
+}
+/**
+ * Type-safe configuration service with convict-like nested path access.
+ *
+ * Provides typed access to configuration values using dot notation paths.
+ * When used with a Zod schema, provides full type inference and autocomplete.
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   database: z.object({
+ *     url: z.string(),
+ *     port: z.number().default(5432),
+ *   }),
+ *   debug: z.boolean().default(false),
+ * });
+ *
+ * type Config = z.infer<typeof schema>;
+ * const config = new ConfigService<Config>(loadedConfig);
+ *
+ * // Full autocomplete and type inference
+ * config.get('database.url');     // string | undefined
+ * config.get('database.port');    // number | undefined
+ * config.getOrThrow('debug');     // boolean
+ * ```
+ */
+export declare class ConfigService<TConfig extends object = Record<string, string>> {
+    private readonly config;
+    constructor(config: TConfig);
+    /**
+     * Get a configuration value using dot notation path.
+     * Returns undefined if not found.
+     *
+     * @param path - Dot notation path (e.g., 'database.url')
+     * @returns Value at path or undefined
+     *
+     * @example
+     * config.get('database.url')     // string | undefined
+     * config.get('server.port', 3000) // number
+     */
+    get<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P> | undefined;
+    get<P extends DottedPath<TConfig>>(path: P, defaultValue: PathValue<TConfig, P>): PathValue<TConfig, P>;
+    /**
+     * Get a required configuration value. Throws if not found.
+     *
+     * @param path - Dot notation path (e.g., 'database.url')
+     * @returns Value at path
+     * @throws ConfigMissingError if not defined
+     *
+     * @example
+     * config.getOrThrow('database.url') // string (throws if missing)
+     */
+    getOrThrow<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P>;
+    /**
+     * Alias for getOrThrow.
+     */
+    getRequired<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P>;
+    /**
+     * Check if a configuration path exists and has a value.
+     *
+     * @param path - Dot notation path (e.g., 'database.url')
+     * @returns True if path exists and has a defined value
+     */
+    has(path: string): boolean;
+    /**
+     * Get the entire configuration object.
+     */
+    getAll(): TConfig;
+    /**
+     * Get the parsed configuration with a specific type.
+     * Useful when you need to cast to a known type.
+     */
+    getParsed<T = TConfig>(): T;
+    /**
+     * Get a number value from configuration.
+     * Parses string values to numbers if needed.
+     *
+     * @param path - Dot notation path
+     * @param defaultValue - Default value if not found or not a number
+     * @returns Number value or NaN
+     */
+    getNumber(path: string, defaultValue?: number): number;
+    /**
+     * Get a boolean value from configuration.
+     * Parses string values: 'true', '1', 'yes', 'on' -> true (case-insensitive)
+     *
+     * @param path - Dot notation path
+     * @param defaultValue - Default value if not found
+     * @returns Boolean value
+     */
+    getBoolean(path: string, defaultValue?: boolean): boolean;
+}
+//# sourceMappingURL=config.service.d.ts.map

package/builtin/config/providers/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../../src/builtin/config/providers/config.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAEvF;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAKxB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;CAMlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAKa,aAAa,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,MAAM,EAAE,OAAO;IAI3B;;;;;;;;;;OAUG;IACH,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,SAAS;IAC9E,GAAG,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAgBvG;;;;;;;;;OASG;IACH,UAAU,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAQzE;;OAEG;IACH,WAAW,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAI1E;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAe1B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;IAI3B;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAYtD;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;CAW1D"}

package/builtin/config/providers/env-loader.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+/**
+ * Parse a .env file content into key-value pairs.
+ * Follows dotenv parsing rules:
+ * - Supports KEY=value format
+ * - Supports quoted values (single and double quotes)
+ * - Supports # comments
+ * - Trims whitespace
+ * - Expands escape sequences in double-quoted values (\n, \r, \t)
+ *
+ * @param content - Raw content of a .env file
+ * @returns Record of key-value pairs
+ */
+export declare function parseEnvContent(content: string): Record<string, string>;
+/**
+ * Load environment variables from .env files.
+ * Follows NestJS-style priority: .env.local overrides .env
+ *
+ * @param basePath - Base directory to resolve files from
+ * @param envPath - Path to base .env file (relative to basePath)
+ * @param localEnvPath - Path to local override file (relative to basePath)
+ * @returns Record of merged environment variables
+ */
+export declare function loadEnvFiles(basePath?: string, envPath?: string, localEnvPath?: string): Promise<Record<string, string>>;
+/**
+ * Synchronously parse environment content.
+ * Use this for CLI where async is not needed.
+ */
+export declare function parseEnvContentSync(content: string): Record<string, string>;
+/**
+ * Populate process.env with loaded values.
+ * By default, does not override existing values.
+ *
+ * @param env - Environment variables to populate
+ * @param override - Whether to override existing values (default: false)
+ */
+export declare function populateProcessEnv(env: Record<string, string>, override?: boolean): void;
+/**
+ * Convert a schema path to environment variable name.
+ * Example: 'database.url' -> 'DATABASE_URL'
+ */
+export declare function pathToEnvKey(path: string): string;
+/**
+ * Set a value at a nested path in an object.
+ * Example: setNestedValue({}, 'database.url', 'x') -> { database: { url: 'x' } }
+ *
+ * @security Validates keys to prevent prototype pollution attacks.
+ * Paths containing __proto__, constructor, or prototype are silently ignored.
+ * Uses Object.create(null) for new nested objects to avoid prototype chain.
+ */
+export declare function setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Get a value from a nested path in an object.
+ * Example: getNestedValue({ database: { url: 'x' } }, 'database.url') -> 'x'
+ *
+ * @security Validates keys to prevent prototype pollution attacks.
+ * Paths containing __proto__, constructor, or prototype return undefined.
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Extract all leaf paths from a Zod schema.
+ * Handles ZodDefault, ZodOptional, and other wrapper types.
+ *
+ * Example: z.object({ database: z.object({ url: z.string() }) }) -> ['database.url']
+ */
+export declare function extractSchemaPaths(schema: z.ZodType, prefix?: string): string[];
+/**
+ * Map flat environment variables to nested config object.
+ * Uses schema paths to determine which env vars to look for.
+ *
+ * @param env - Flat environment variables (e.g., { DATABASE_URL: '...' })
+ * @param paths - Schema paths to look for (e.g., ['database.url', 'database.port'])
+ * @returns Nested config object
+ */
+export declare function mapEnvToNestedConfig(env: Record<string, string | undefined>, paths: string[]): Record<string, unknown>;
+//# sourceMappingURL=env-loader.d.ts.map

package/builtin/config/providers/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../../../src/builtin/config/providers/env-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2CvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,SAAgB,EACxB,OAAO,SAAS,EAChB,YAAY,SAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkBjC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAMtF;AAoBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA+B/F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAoC3E;AAyBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/builtin/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Built-in plugins and features for FrontMCP SDK.
+ *
+ * @packageDocumentation
+ */
+export * from './config';
+//# sourceMappingURL=index.d.ts.map

package/builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builtin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC"}

package/common/decorators/front-mcp.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAA0B,MAAM,aAAa,CAAC;AAqCvE;;GAEG;AACH,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CA6D3E"}
+{"version":3,"file":"front-mcp.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAA0B,MAAM,aAAa,CAAC;AAoCvE;;GAEG;AACH,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CA2D3E"}

package/common/decorators/hook.decorator.d.ts

@@ -10,16 +10,6 @@ import { HookOptions, FlowName, HookMetadata } from '../metadata';
  * This is called by collectFlowHookMap during flow registration
  */
 export declare function resolvePendingTC39HooksForClass(ctor: Function): HookMetadata[];
-/**
- * Store a pending hook for TC39 mode
- * @internal
- */
-export declare function registerPendingTC39Hook(method: Function, meta: HookMetadata): void;
-/**
- * Get and clear pending hooks for a method (TC39 mode)
- * @internal
- */
-export declare function consumePendingTC39Hooks(method: Function): HookMetadata[];
 /**
  * Creates a typed Stage hook decorator for a specific flow
  * @example

package/common/decorators/hook.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/hook.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBjF;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,EAAE,CAE9E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAElF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,EAAE,CAExE;AAkED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAI1C,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAIzC,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAIxC,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAI3C,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI;;;;;EAO5D"}
+{"version":3,"file":"hook.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/hook.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBjF;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,EAAE,CAE9E;AAkFD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAI1C,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAIzC,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAIxC,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IAI3C,iCAAQ,EAAE,OAAM,WAAW,0BAAU,qBAGvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI;;;;;EAO5D"}

package/common/decorators/index.d.ts

@@ -11,4 +11,5 @@ export * from './resource.decorator';
 export * from './prompt.decorator';
 export * from './logger.decorator';
 export * from './agent.decorator';
+export * from './skill.decorator';
 //# sourceMappingURL=index.d.ts.map

package/common/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/common/decorators/skill.decorator.d.ts

@@ -0,0 +1,105 @@
+import 'reflect-metadata';
+import { SkillMetadata } from '../metadata';
+import { SkillValueRecord } from '../records';
+/**
+ * Class decorator that marks a class as a Skill and provides metadata.
+ *
+ * Skills are knowledge/workflow packages that teach AI how to perform
+ * multi-step tasks using tools. Unlike tools, skills don't execute
+ * directly - they provide instructions and context for LLMs.
+ *
+ * @param providedMetadata - Skill metadata including name, description, and instructions
+ * @returns Class decorator
+ *
+ * @example Basic skill
+ * ```typescript
+ * @Skill({
+ *   name: 'review-pr',
+ *   description: 'Review a GitHub pull request',
+ *   instructions: 'Step 1: Fetch PR details...',
+ *   tools: ['github_get_pr', 'github_add_comment'],
+ * })
+ * class ReviewPRSkill extends SkillContext {
+ *   async loadInstructions() { return this.metadata.instructions as string; }
+ *   async build() { ... }
+ * }
+ * ```
+ *
+ * @example Skill with file-based instructions
+ * ```typescript
+ * @Skill({
+ *   name: 'deploy-app',
+ *   description: 'Deploy application to production',
+ *   instructions: { file: './skills/deploy.md' },
+ *   tools: ['docker_build', 'k8s_apply'],
+ *   tags: ['devops', 'deployment'],
+ * })
+ * class DeploySkill extends SkillContext { ... }
+ * ```
+ *
+ * @example Skill with URL-based instructions
+ * ```typescript
+ * @Skill({
+ *   name: 'security-audit',
+ *   description: 'Perform security audit on codebase',
+ *   instructions: { url: 'https://example.com/skills/security-audit.md' },
+ *   tools: ['code_search', 'file_read'],
+ * })
+ * class SecurityAuditSkill extends SkillContext { ... }
+ * ```
+ */
+declare function FrontMcpSkill(providedMetadata: SkillMetadata): ClassDecorator;
+/**
+ * Function helper that creates an inline skill record.
+ *
+ * Use this when you want to define a skill without creating a class.
+ * The skill is registered as a value record with a unique symbol token.
+ *
+ * @param providedMetadata - Skill metadata including name, description, and instructions
+ * @returns A skill value record that can be passed to app/plugin skills array
+ *
+ * @example Inline skill
+ * ```typescript
+ * const reviewPRSkill = skill({
+ *   name: 'review-pr',
+ *   description: 'Review a GitHub pull request',
+ *   instructions: `
+ *     ## PR Review Process
+ *     1. Fetch the PR details using github_get_pr
+ *     2. Review each changed file...
+ *   `,
+ *   tools: [
+ *     { name: 'github_get_pr', purpose: 'Fetch PR details', required: true },
+ *     { name: 'github_add_comment', purpose: 'Add review comments' },
+ *   ],
+ *   tags: ['github', 'code-review'],
+ * });
+ *
+ * @FrontMcp({
+ *   name: 'my-app',
+ *   skills: [reviewPRSkill],
+ * })
+ * class MyApp {}
+ * ```
+ *
+ * @example Skill with file-based instructions
+ * ```typescript
+ * const deploySkill = skill({
+ *   name: 'deploy-app',
+ *   description: 'Deploy application to production',
+ *   instructions: { file: './skills/deploy.md' },
+ *   tools: ['docker_build', 'docker_push', 'k8s_apply'],
+ * });
+ * ```
+ */
+declare function frontMcpSkill(providedMetadata: SkillMetadata): SkillValueRecord;
+export { FrontMcpSkill, FrontMcpSkill as Skill, frontMcpSkill, frontMcpSkill as skill };
+/**
+ * Check if a class has the @Skill decorator.
+ */
+export declare function isSkillDecorated(target: object): boolean;
+/**
+ * Get skill metadata from a decorated class.
+ */
+export declare function getSkillMetadata(target: object): SkillMetadata | undefined;
+//# sourceMappingURL=skill.decorator.d.ts.map

package/common/decorators/skill.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/skill.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAa,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,cAAc,CAgBtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,CAYxE;AAGD,OAAO,EAAE,aAAa,EAAE,aAAa,IAAI,KAAK,EAAE,aAAa,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC;AAExF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAuB1E"}

package/common/dynamic/dynamic.adapter.d.ts

@@ -1,9 +1,9 @@
 import { Reference, FrontMcpAdapterResponse, AdapterType, AdapterInterface } from '../interfaces';
-type InitOptions<T> = ((T & {
+type InitOptions<T> = (T & {
     useFactory?: never;
     inject?: never;
     name: string;
-})) | {
+}) | {
     inject: () => readonly Reference<any>[];
     useFactory: (...args: any[]) => T;
     name: string;
@@ -24,8 +24,18 @@ export declare abstract class DynamicAdapter<TOptions extends object> implements
      */
     __options_brand: TOptions;
     /**
-     * Static init() method to create a plugin provider.
-     * @param options
+     * Static init() method to create an adapter provider.
+     *
+     * Each call to init() creates a unique adapter instance with its own token,
+     * keyed by `${ClassName}:${options.name}`. This allows multiple adapters
+     * of the same class with different configurations (e.g., multiple OpenAPI
+     * adapters for different APIs).
+     *
+     * **IMPORTANT:** The `name` option must be unique per adapter class.
+     * Registering two adapters with the same class and name will throw an error.
+     *
+     * @param options - Adapter options including required `name` field
+     * @throws Error if `name` is missing/empty or if a duplicate name is detected
      */
     static init<TThis extends AdapterClassWithOptions<any>>(this: TThis, options: InitOptions<TThis['prototype'] extends {
         __options_brand?: infer O;

package/common/dynamic/dynamic.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.adapter.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,KAAK,WAAW,CAAC,CAAC,IACd,CAAC,CAAC,CAAC,GAAG;IACN,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC,GACD;IACF,MAAM,EAAE,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,uBAAuB,CAAC,CAAC,IAAI;IAChC,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IACzB,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,IAAI,WAAW,CAAA;AAEnC,8BAAsB,cAAc,CAAC,QAAQ,SAAS,MAAM,CAAE,YAAW,gBAAgB;IACvF,QAAQ,CAAC,OAAO,EAAE;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,GAAG,QAAQ,CAAA;IAC1C;;OAEG;IACK,eAAe,EAAE,QAAQ,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,uBAAuB,CAAC,GAAG,CAAC,EACpD,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GACzF,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IAmBtF;;;;OAIG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB;CAC7E"}
+{"version":3,"file":"dynamic.adapter.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGlG,KAAK,WAAW,CAAC,CAAC,IACd,CAAC,CAAC,GAAG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,GACF;IACE,MAAM,EAAE,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,KAAK,uBAAuB,CAAC,CAAC,IAAI;IAChC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC1B,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,IAAI,WAAW,CAAC;AAKpC,8BAAsB,cAAc,CAAC,QAAQ,SAAS,MAAM,CAAE,YAAW,gBAAgB;IACvF,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC;IAC9C;;OAEG;IACK,eAAe,EAAE,QAAQ,CAAC;IAElC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,uBAAuB,CAAC,GAAG,CAAC,EACpD,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GACzF,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IAiDtF;;;;OAIG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB;CAC7E"}

package/common/entries/app.entry.d.ts

@@ -1,6 +1,7 @@
 import { BaseEntry } from './base.entry';
 import { AppRecord } from '../records';
 import { AdapterRegistryInterface, AppInterface, PluginRegistryInterface, PromptRegistryInterface, ProviderRegistryInterface, ResourceRegistryInterface, ToolRegistryInterface } from '../interfaces';
+import type { SkillRegistryInterface } from '../../skill/skill.registry';
 import { AppMetadata } from '../metadata';
 export declare abstract class AppEntry<Metadata = AppMetadata> extends BaseEntry<AppRecord, AppInterface, Metadata> {
     readonly id: string;
@@ -17,5 +18,6 @@ export declare abstract class AppEntry<Metadata = AppMetadata> extends BaseEntry
     abstract get tools(): ToolRegistryInterface;
     abstract get resources(): ResourceRegistryInterface;
     abstract get prompts(): PromptRegistryInterface;
+    abstract get skills(): SkillRegistryInterface;
 }
 //# sourceMappingURL=app.entry.d.ts.map

package/common/entries/app.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/app.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,8BAAsB,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAAE,SAAQ,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC;IACzG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,QAAQ,IAAI,wBAAwB,CAAC;IAElD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;IAEhD,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;CACjD"}
+{"version":3,"file":"app.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/app.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,8BAAsB,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAAE,SAAQ,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC;IACzG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,QAAQ,IAAI,wBAAwB,CAAC;IAElD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;IAEhD,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;IAEhD,QAAQ,KAAK,MAAM,IAAI,sBAAsB,CAAC;CAC/C"}

package/common/entries/index.d.ts

@@ -12,4 +12,5 @@ export * from './resource.entry';
 export * from './prompt.entry';
 export * from './logger.entry';
 export * from './agent.entry';
+export * from './skill.entry';
 //# sourceMappingURL=index.d.ts.map

package/common/entries/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/entries/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/entries/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/common/entries/prompt.entry.d.ts

@@ -5,15 +5,9 @@ import { PromptMetadata } from '../metadata';
 import { GetPromptResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';
 import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import { ProviderRegistryInterface } from '../interfaces/internal';
 import type ProviderRegistry from '../../provider/provider.registry';
 export type PromptGetExtra = RequestHandlerExtra<Request, Notification> & {
     authInfo: AuthInfo;
-    /**
-     * Optional context-aware providers from the flow.
-     * @internal
-     */
-    contextProviders?: ProviderRegistryInterface;
 };
 export type ParsedPromptResult = GetPromptResult;
 export type PromptSafeTransformResult<T> = {

package/common/entries/prompt.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/prompt.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG;IACxE,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;AACjD,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEzG,8BAAsB,WAAY,SAAQ,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,cAAc,CAAC;IAChG,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,KAAK,SAAS,IAAI,gBAAgB,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;IAEjF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9E;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB;IAEtD;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CAAC,kBAAkB,CAAC;CACtF"}
+{"version":3,"file":"prompt.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/prompt.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,OAAO,KAAK,gBAAgB,MAAM,kCAAkC,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG;IACxE,QAAQ,EAAE,QAAQ,CAAC;CAMpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;AACjD,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEzG,8BAAsB,WAAY,SAAQ,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,cAAc,CAAC;IAChG,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,KAAK,SAAS,IAAI,gBAAgB,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;IAEjF;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9E;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB;IAEtD;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CAAC,kBAAkB,CAAC;CACtF"}

package/common/entries/resource.entry.d.ts

@@ -5,14 +5,8 @@ import { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';
 import { ReadResourceResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';
 import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
-import { ProviderRegistryInterface } from '../interfaces/internal';
 export type ResourceReadExtra = RequestHandlerExtra<Request, Notification> & {
     authInfo: AuthInfo;
-    /**
-     * Optional context-aware providers from the flow.
-     * @internal
-     */
-    contextProviders?: ProviderRegistryInterface;
 };
 export type ParsedResourceResult = ReadResourceResult;
 export type ResourceSafeTransformResult<T> = {

package/common/entries/resource.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/resource.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG;IAC3E,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACtD,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3G;;;;GAIG;AACH,8BAAsB,aAAa,CACjC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9D,GAAG,GAAG,OAAO,CACb,SAAQ,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAAC;IACjH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC;IAElG;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,oBAAoB;IAEvD;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,2BAA2B,CAAC,oBAAoB,CAAC;IAErF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CACrE"}
+{"version":3,"file":"resource.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/resource.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAG1E,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG;IAC3E,QAAQ,EAAE,QAAQ,CAAC;CAMpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACtD,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3G;;;;GAIG;AACH,8BAAsB,aAAa,CACjC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9D,GAAG,GAAG,OAAO,CACb,SAAQ,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAAC;IACjH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC;IAElG;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,oBAAoB;IAEvD;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,2BAA2B,CAAC,oBAAoB,CAAC;IAErF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CACrE"}

package/common/entries/scope.entry.d.ts

@@ -4,6 +4,7 @@ import { ScopeRecord } from '../records';
 import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, FlowInputOf, FlowOutputOf, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface, ResourceRegistryInterface, PromptRegistryInterface } from '../interfaces';
 import { FlowName, ScopeMetadata } from '../metadata';
 import type { NotificationService } from '../../notification';
+import type { SkillRegistryInterface } from '../../skill/skill.registry';
 export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {
     abstract readonly id: string;
     abstract readonly entryPath: string;
@@ -18,6 +19,7 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInt
     abstract get tools(): ToolRegistryInterface;
     abstract get resources(): ResourceRegistryInterface;
     abstract get prompts(): PromptRegistryInterface;
+    abstract get skills(): SkillRegistryInterface;
     abstract get notifications(): NotificationService;
     abstract registryFlows(...flows: FlowType[]): Promise<void>;
     abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;

package/common/entries/scope.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,8BAAsB,UAAW,SAAQ,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,CAAC;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEzC,IAAI,QAAQ,IAAI,MAAM,CAIrB;IAED,QAAQ,KAAK,IAAI,IAAI,YAAY,CAAC;IAElC,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,aAAa,IAAI,qBAAqB,CAAC;IAEpD,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,IAAI,IAAI,oBAAoB,CAAC;IAE1C,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;IAEhD,QAAQ,KAAK,aAAa,IAAI,mBAAmB,CAAC;IAElD,QAAQ,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,QAAQ,EACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EACxB,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3C"}
+{"version":3,"file":"scope.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,8BAAsB,UAAW,SAAQ,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,CAAC;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEzC,IAAI,QAAQ,IAAI,MAAM,CAIrB;IAED,QAAQ,KAAK,IAAI,IAAI,YAAY,CAAC;IAElC,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,aAAa,IAAI,qBAAqB,CAAC;IAEpD,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,IAAI,IAAI,oBAAoB,CAAC;IAE1C,QAAQ,KAAK,KAAK,IAAI,qBAAqB,CAAC;IAE5C,QAAQ,KAAK,SAAS,IAAI,yBAAyB,CAAC;IAEpD,QAAQ,KAAK,OAAO,IAAI,uBAAuB,CAAC;IAEhD,QAAQ,KAAK,MAAM,IAAI,sBAAsB,CAAC;IAE9C,QAAQ,KAAK,aAAa,IAAI,mBAAmB,CAAC;IAElD,QAAQ,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3D,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,QAAQ,EACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EACxB,cAAc,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3C"}

package/common/entries/skill.entry.d.ts

@@ -0,0 +1,95 @@
+import { BaseEntry, EntryOwnerRef } from './base.entry';
+import { SkillRecord } from '../records';
+import { SkillContext, SkillContent } from '../interfaces';
+import { SkillMetadata, SkillToolRef } from '../metadata';
+/**
+ * Result of loading a skill with tool validation information.
+ */
+export type SkillLoadResult = {
+    /**
+     * The loaded skill content.
+     */
+    skill: SkillContent;
+    /**
+     * Tools that are available in the current scope.
+     */
+    availableTools: string[];
+    /**
+     * Tools that are referenced but not available.
+     */
+    missingTools: string[];
+    /**
+     * True if all required tools are available.
+     */
+    isComplete: boolean;
+    /**
+     * Warning message if tools are missing.
+     */
+    warning?: string;
+};
+/**
+ * Result returned from skill validation.
+ */
+export type SafeSkillLoadResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: Error;
+};
+/**
+ * Abstract base class for skill entries.
+ *
+ * Skills are knowledge/workflow packages that don't execute directly.
+ * Instead, they provide instructions and context for LLMs to perform tasks.
+ */
+export declare abstract class SkillEntry extends BaseEntry<SkillRecord, SkillContext, SkillMetadata> {
+    /**
+     * The owner of this skill (app, plugin, etc.).
+     */
+    owner: EntryOwnerRef;
+    /**
+     * The name of the skill, as declared in the metadata.
+     */
+    name: string;
+    /**
+     * The full qualified name of the skill, including the owner name as prefix.
+     */
+    fullName: string;
+    /**
+     * Get a short description of the skill.
+     */
+    abstract getDescription(): string;
+    /**
+     * Load the skill's detailed instructions.
+     * Resolves from inline string, file path, or URL based on metadata.
+     */
+    abstract loadInstructions(): Promise<string>;
+    /**
+     * Load the full skill content.
+     * Returns the complete skill with resolved instructions.
+     */
+    abstract load(): Promise<SkillContent>;
+    /**
+     * Get the tool references from the skill metadata.
+     * Returns normalized SkillToolRef objects.
+     */
+    getToolRefs(): SkillToolRef[];
+    /**
+     * Get tool names from the skill metadata.
+     */
+    getToolNames(): string[];
+    /**
+     * Get the skill's tags for categorization.
+     */
+    getTags(): string[];
+    /**
+     * Check if the skill should be hidden from discovery.
+     */
+    isHidden(): boolean;
+    /**
+     * Get the skill's priority for search ranking.
+     */
+    getPriority(): number;
+}
+//# sourceMappingURL=skill.entry.d.ts.map

package/common/entries/skill.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/skill.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnG;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;IAC1F;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAEjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAEtC;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE;IAM7B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}