/**
 * Skill setup manifest — the optional `setup` block of a skill's `skill.json`.
 *
 * It declares what a skill needs on the machine before it can run, so a
 * runner can install it without a human reading the README:
 *
 * - `command` — a program on PATH (or at a known path), installed per OS with
 *   Homebrew, apt-get, or a script shipped next to the skill.
 * - `file`    — a large file such as a model: URL + sha256 + size + where it goes.
 * - `python`  — packages installed into a Crewly-managed venv
 *   (`$CREWLY_HOME/venv/<name>`), probed by importing modules.
 *
 * The format is declarative on purpose: package names, paths and URLs are
 * validated here, so a registry entry cannot smuggle shell into a field that
 * is only meant to hold a package name. The two places that do run shell —
 * `check.shell` and `install.<os>.script` — are code shipped by the skill
 * itself, which is no more trusted than its `execute.sh` and goes through the
 * same trust rule (see skill-install-job.service).
 *
 * Spec: specs/skill-auto-install.md
 *
 * @module services/skill-setup/skill-setup-manifest
 */
/** Operating-system families a `command` step can carry install recipes for. */
export type OsFamily = 'darwin' | 'debian' | 'linux';
/** Every OS family, in manifest order. */
export declare const OS_FAMILIES: readonly OsFamily[];
/** How to install a command on one OS family. Exactly the listed methods run, in this order. */
export interface OsInstallRecipe {
    /** Homebrew formulae (`brew install …`) */
    brew?: string[];
    /** Homebrew casks (`brew install --cask …`) */
    brewCask?: string[];
    /** Debian/Ubuntu packages (`apt-get install -y …`, needs root or passwordless sudo) */
    apt?: string[];
    /** A bash script in the skill directory (file name only), run with `bash <skillDir>/<script>` */
    script?: string;
}
/** How to tell whether a command-type dependency is present. Any one match satisfies it. */
export interface CommandCheck {
    /** Bare command names looked up on PATH (plus Homebrew and `$CREWLY_HOME/bin`) */
    commands?: string[];
    /** Paths that satisfy the check when they exist and are executable (`~/` and `$CREWLY_HOME/` expand) */
    paths?: string[];
    /** A bash snippet; exit code 0 means satisfied */
    shell?: string;
}
/** Fields shared by every step. */
interface BaseStep {
    /** Unique id within the manifest (kebab-case), used in logs and progress */
    id: string;
    /** One line a person can read ("ffmpeg — decodes the audio") */
    description?: string;
    /** An optional step that fails does not fail the setup */
    optional?: boolean;
}
/** A program the skill runs. */
export interface CommandStep extends BaseStep {
    type: 'command';
    check: CommandCheck;
    install?: Partial<Record<OsFamily, OsInstallRecipe>>;
    /** Shown when there is no automatic install for this OS */
    manualHint?: string;
}
/** A file (typically a model) downloaded once and verified. */
export interface FileStep extends BaseStep {
    type: 'file';
    /** https URL */
    url: string;
    /** Lower-case hex sha256 of the file */
    sha256: string;
    /** Exact size in bytes */
    sizeBytes: number;
    /** Destination (`~/…` or `$CREWLY_HOME/…`) */
    dest: string;
    /** Other places where an existing copy also satisfies the step */
    alternatives?: string[];
}
/** Python packages in a Crewly-managed virtualenv. */
export interface PythonStep extends BaseStep {
    type: 'python';
    /** venv name under `$CREWLY_HOME/venv/` (defaults to the skill id) */
    venv?: string;
    /** pip requirement specifiers (`pypdf>=4`) */
    packages: string[];
    /** Module names whose import proves the packages are there */
    imports: string[];
}
/** One setup step. */
export type SkillSetupStep = CommandStep | FileStep | PythonStep;
/** The `setup` block of `skill.json`. */
export interface SkillSetupManifest {
    /** Rough minutes a first-time setup takes (quoted to the user) */
    estimatedMinutes?: number;
    /** Steps, performed in order */
    steps: SkillSetupStep[];
}
/** Outcome of {@link validateSetupManifest}. */
export interface SetupManifestValidation {
    valid: boolean;
    errors: string[];
    /** The manifest, typed, when valid */
    manifest?: SkillSetupManifest;
}
/** Prefixes a file destination may start with. */
export declare const DEST_PREFIXES: readonly ["~/", "$CREWLY_HOME/"];
/**
 * Validate a `setup` block.
 *
 * @param value - The parsed `setup` value from skill.json (or a registry entry)
 * @returns `{ valid, errors, manifest }`; `manifest` is set only when valid
 *
 * @example
 * ```ts
 * const { valid, errors } = validateSetupManifest(skillJson.setup);
 * if (!valid) throw new Error(errors.join('; '));
 * ```
 */
export declare function validateSetupManifest(value: unknown): SetupManifestValidation;
/**
 * The install recipes that apply to an OS family, most specific first.
 *
 * A Debian machine uses a `debian` recipe when there is one, else `linux`.
 *
 * @param family - Detected OS family
 * @returns Families to look up, in order
 */
export declare function recipeLookupOrder(family: OsFamily): OsFamily[];
/**
 * The recipe a command step uses on an OS family.
 *
 * @param step - Command step
 * @param family - Detected OS family
 * @returns The recipe, or undefined when the step has none for this OS
 */
export declare function recipeFor(step: CommandStep, family: OsFamily): OsInstallRecipe | undefined;
export {};
//# sourceMappingURL=skill-setup-manifest.d.ts.map