import { type Type } from '@frontmcp/di';
import { type ParsedPackageSpecifier } from '../../esm-loader/package-specifier';
import { type SkillContext } from '../interfaces';
import { type EsmOptions, type RemoteAuthConfig, type RemoteTransportOptions, type SkillMetadata } from '../metadata';
/**
 * Kinds of skill records supported by the framework.
 */
export declare enum SkillKind {
    /**
     * Class-based skill defined with @Skill decorator.
     */
    CLASS_TOKEN = "CLASS_TOKEN",
    /**
     * Inline skill object created with skill() helper.
     */
    VALUE = "VALUE",
    /**
     * File-based skill loaded from a .skill.md or similar file.
     */
    FILE = "FILE",
    /**
     * ESM-loaded skill from an npm package via esm.sh.
     */
    ESM = "ESM",
    /**
     * Skill proxied from a remote MCP server.
     */
    REMOTE = "REMOTE"
}
/**
 * Record for class-based skills using @Skill decorator.
 */
export type SkillClassTokenRecord = {
    kind: SkillKind.CLASS_TOKEN;
    provide: Type<SkillContext>;
    metadata: SkillMetadata;
    /** Directory of the file that declared the @Skill class. Used to resolve relative instruction file paths. */
    callerDir?: string;
};
/**
 * Record for inline skill objects created with skill() helper.
 * The token is a Symbol used for registration.
 */
export type SkillValueRecord = {
    kind: SkillKind.VALUE;
    provide: symbol;
    metadata: SkillMetadata;
    /** Directory of the file that called skill(). Used to resolve relative instruction file paths. */
    callerDir?: string;
};
/**
 * Record for file-based skills loaded from external files.
 * Used by loaders (e.g., markdown loader) to register skills.
 */
export type SkillFileRecord = {
    kind: SkillKind.FILE;
    provide: symbol;
    metadata: SkillMetadata;
    /**
     * Path to the source file (for reloading/hot-reload support).
     */
    filePath: string;
};
/**
 * Record for ESM-loaded skills from npm packages.
 */
export type SkillEsmRecord = {
    kind: SkillKind.ESM;
    provide: string;
    specifier: ParsedPackageSpecifier;
    metadata: SkillMetadata;
};
/** Single named skill loaded from an npm package at runtime */
export type SkillEsmTargetRecord = {
    kind: SkillKind.ESM;
    provide: symbol;
    specifier: ParsedPackageSpecifier;
    /** Which skill to load from the package */
    targetName: string;
    options?: EsmOptions;
    metadata: SkillMetadata;
};
/** Single named skill proxied from a remote MCP server */
export type SkillRemoteRecord = {
    kind: SkillKind.REMOTE;
    provide: symbol;
    /** Remote MCP server URL */
    url: string;
    /** Which skill to proxy */
    targetName: string;
    transportOptions?: RemoteTransportOptions;
    remoteAuth?: RemoteAuthConfig;
    metadata: SkillMetadata;
};
/**
 * Union of all skill record types.
 */
export type SkillRecord = SkillClassTokenRecord | SkillValueRecord | SkillFileRecord | SkillEsmRecord | SkillEsmTargetRecord | SkillRemoteRecord;
//# sourceMappingURL=skill.record.d.ts.map