import { Context, Effect, Layer, Schema } from "effect";
import { Tool } from "effect/unstable/ai";
/** @experimental Per-entry description character cap. */
export declare const DESCRIPTION_CAP = 1024;
/** @experimental Parsed SKILL.md frontmatter. */
export declare const Frontmatter: Schema.Struct<{
    readonly name: Schema.String;
    readonly description: Schema.String;
    readonly whenToUse: Schema.optionalKey<Schema.String>;
    readonly allowedTools: Schema.optionalKey<Schema.$Array<Schema.String>>;
    readonly disableModelInvocation: Schema.optionalKey<Schema.Boolean>;
    readonly userInvocable: Schema.optionalKey<Schema.Boolean>;
    readonly contextFork: Schema.optionalKey<Schema.Boolean>;
    readonly agent: Schema.optionalKey<Schema.String>;
    readonly model: Schema.optionalKey<Schema.String>;
    readonly paths: Schema.optionalKey<Schema.$Array<Schema.String>>;
}>;
/** @experimental Parsed SKILL.md frontmatter. */
export type Frontmatter = typeof Frontmatter.Type;
declare const SkillSourceError_base: Schema.Class<SkillSourceError, Schema.TaggedStruct<"@batonfx/core/SkillSourceError", {
    readonly source: Schema.String;
    readonly message: Schema.String;
    readonly cause: Schema.optionalKey<Schema.Defect>;
}>, import("effect/Cause").YieldableError>;
/** @experimental Skill source operation failed. */
export declare class SkillSourceError extends SkillSourceError_base {
}
/** @experimental A discovered skill. */
export interface Skill {
    readonly frontmatter: Frontmatter;
    readonly listing: string;
    readonly body: Effect.Effect<string, SkillSourceError>;
    readonly tools: ReadonlyArray<Tool.Any>;
    /**
     * Where the skill was found, for a source that reads a filesystem. A host that resolves resources
     * beside a skill needs the directory it came from rather than one derived from its name, because
     * a source may find a skill anywhere beneath its root.
     */
    readonly directory?: string;
}
/** @experimental Skill registry seam. */
export interface Interface {
    readonly all: Effect.Effect<ReadonlyArray<Skill>, SkillSourceError>;
    readonly get: (name: string) => Effect.Effect<Skill | undefined, SkillSourceError>;
}
/** @experimental Effect that builds one skill source implementation. */
export type Source<R = never> = Effect.Effect<Interface, SkillSourceError, R>;
declare const SkillSource_base: Context.ServiceClass<SkillSource, "@batonfx/core/context/skill-source/SkillSource", Interface>;
/** @experimental */
export declare class SkillSource extends SkillSource_base {
}
/** @experimental Build a startup listing line from skill frontmatter. */
export declare const makeListing: {
    (descriptionCap?: number): (frontmatter: Frontmatter) => string;
    (frontmatter: Frontmatter, descriptionCap?: number): string;
};
/** @experimental A source built from in-memory skills. */
export declare const layerSkills: (skills: ReadonlyArray<Skill>) => Layer.Layer<SkillSource>;
/** @experimental Empty skill source. */
export declare const layerEmpty: Layer.Layer<SkillSource>;
/** @experimental */
export declare const layerTest: (implementation: Interface) => Layer.Layer<SkillSource>;
/** @experimental Merge two built sources with the second source winning duplicate names. */
export declare const merge: {
    (second: Interface): (first: Interface) => Interface;
    (first: Interface, second: Interface): Interface;
};
/** @experimental Build one layer from composable sources. */
export declare const layer: <R>(sources: ReadonlyArray<Source<R>>) => Layer.Layer<SkillSource, SkillSourceError, R>;
/** @experimental Select startup listings within a token budget. */
export declare const selectListings: {
    (budgetTokens: number, recentlyUsed: ReadonlyArray<string>): (skills: ReadonlyArray<Skill>) => ReadonlyArray<Skill>;
    (skills: ReadonlyArray<Skill>, budgetTokens: number, recentlyUsed: ReadonlyArray<string>): ReadonlyArray<Skill>;
};
export {};