import { SkillsConfig } from "./contracts/skills-config.type.mjs";
import { SkillsContract } from "./contracts/skills.contract.mjs";

//#region ../ai/src/skills/skills.d.ts
/**
 * Create a runtime skills library — the **mechanism** behind the
 * first-class `skills` agent option.
 *
 * The returned {@link SkillsContract} produces the agent-facing wiring:
 * - `catalog` / `catalogPrompt` — the always-injected cheap metadata block
 *   (one line per in-scope, non-candidate skill).
 * - `preload` — the bodies to inject up front per `inject` (`[]` when
 *   `inject` is omitted — the default catalog-only progressive disclosure).
 * - `tools(runId)` — the `loadSkill` tool always; plus `saveSkill` ONLY
 *   when a `review` gate is configured (otherwise self-authoring is inert).
 *
 * Sources are merged in order; a later source wins on a name collision.
 * `maxLoadsPerRun` (default 5) caps `loadSkill` calls per run; exhaustion
 * is an error RESULT the model self-corrects from, never a throw.
 *
 * @example
 * const lib = skills({
 *   name: "build-skills",
 *   sources: [{ type: "directory", path: "./agent-skills" }],
 *   inject: { select: "semantic", topK: 2, embedder },
 *   maxLoadsPerRun: 4,
 *   scope: { tags: ["frontend"] },
 * });
 */
declare function skills(config: SkillsConfig): SkillsContract;
//#endregion
export { skills };
//# sourceMappingURL=skills.d.mts.map