import type { SpotlightResourceRef, SpotlightResourceSearchInput, SpotlightResourceSearchResult, SpotlightSkill } from "@inupedia/spotlight-protocol";
import { type ClientTool } from "./clientTool.js";
export interface SpotlightResourceAction<TResource extends SpotlightResourceRef> {
    /** Public Tool name. Defaults to `${namespace}_${action}`. */
    toolName?: string;
    description: string;
    handler: (resource: TResource) => unknown | Promise<unknown>;
    tier?: "observe" | "query" | "navigate";
}
export interface SpotlightResourceProviderOptions<TResource extends SpotlightResourceRef> {
    namespace: string;
    description: string;
    search(input: SpotlightResourceSearchInput): Promise<SpotlightResourceSearchResult<TResource>>;
    get?(id: string): Promise<TResource | null>;
    actions?: Record<string, SpotlightResourceAction<TResource>>;
    /** Defaults to a generated resource Skill. Set false when a richer consumer Skill already exists. */
    skill?: false | {
        name?: string;
        displayName?: string;
        description?: string;
        whenToUse?: string;
        capabilityExamples?: string[];
    };
}
export interface SpotlightResourceProvider<TResource extends SpotlightResourceRef = SpotlightResourceRef> {
    namespace: string;
    description: string;
    tools: ClientTool[];
    skill?: SpotlightSkill;
    search(input: SpotlightResourceSearchInput): Promise<SpotlightResourceSearchResult<TResource>>;
    resolve(query: string): Promise<TResource>;
}
export declare function defineResourceProvider<TResource extends SpotlightResourceRef>(options: SpotlightResourceProviderOptions<TResource>): SpotlightResourceProvider<TResource>;
//# sourceMappingURL=resourceProvider.d.ts.map