import { type CliTelemetry } from "./telemetry.js";
export type SkillClient = "codex" | "claude-code" | "cowork" | "pi" | "cursor" | "opencode" | "github-copilot";
export type SkillScope = "project" | "user";
export type PlanMode = "hosted" | "local-files" | "self-hosted";
export interface SkillEntry {
    name: string;
    dir: string;
    description?: string;
}
export interface InstallSkillsOptions {
    source?: string;
    skillNames?: string[];
    clients?: SkillClient[];
    scope?: SkillScope;
    baseDir?: string;
    yes?: boolean;
    dryRun?: boolean;
    updateInstructions?: boolean;
    instructionFiles?: string[];
    withGithubAction?: boolean;
    force?: boolean;
    connect?: boolean;
    quiet?: boolean;
    deviceFlowTimeoutMs?: number;
    log?: (message: string) => void;
    isInteractive?: () => boolean;
    telemetry?: CliTelemetry;
    promptSkills?: (context: SkillsPromptContext) => Promise<string[] | null>;
    promptClients?: (context: ClientsPromptContext) => Promise<SkillClient[] | null>;
    promptScope?: (context: ScopePromptContext) => Promise<SkillScope | null>;
    promptUpdateInstructions?: () => Promise<boolean | null>;
    promptGithubAction?: (context: GithubActionPromptContext) => Promise<boolean | null>;
    promptPlanMode?: (context: PlanModePromptContext) => Promise<PlanMode | null>;
    promptPlanMcpUrl?: () => Promise<string | null>;
    /**
     * Register the hosted MCP server for app-backed skills (e.g. visual-plan /
     * visual-recap → the Agent-Native Plan MCP). Defaults to `true`; pass
     * `false` (CLI `--no-mcp`) to install the skill files only.
     */
    mcp?: boolean;
    planMode?: PlanMode;
    mcpUrl?: string;
}
export interface InstalledMcpServer {
    serverName: string;
    mcpUrl: string;
    clients: SkillClient[];
    registeredClients: SkillClient[];
    files: string[];
    authenticated: boolean;
    guidance: string[];
}
export interface InstallSkillsResult {
    source: string;
    skills: string[];
    clients: SkillClient[];
    scope: SkillScope;
    written: string[];
    instructionFiles: string[];
    githubActionPath?: string;
    mcpServers: InstalledMcpServer[];
    planMode?: PlanMode;
    dryRun: boolean;
}
interface ParsedArgs {
    command: "add" | "list" | "status" | "update" | "help";
    source?: string;
    copySource: boolean;
    skillNames: string[];
    clients: SkillClient[];
    scope: SkillScope;
    scopeExplicit: boolean;
    yes: boolean;
    dryRun: boolean;
    printJson: boolean;
    updateInstructions?: boolean;
    instructionFiles: string[];
    withGithubAction: boolean;
    force: boolean;
    connect: boolean;
    baseDir?: string;
    mcp: boolean;
    planMode?: PlanMode;
    mcpUrl?: string;
    quiet: boolean;
}
interface PromptOption<T extends string> {
    value: T;
    label: string;
    hint: string;
}
export interface SkillsPromptContext {
    initialSkills: string[];
    options: Array<PromptOption<string>>;
}
export interface ClientsPromptContext {
    initialClients: SkillClient[];
    options: Array<PromptOption<SkillClient>>;
}
export interface ScopePromptContext {
    initialScope: SkillScope;
}
export interface GithubActionPromptContext {
    workflowPath: string;
    setupCommand: string;
    docsUrl: string;
}
export interface PlanModePromptContext {
    initialMode: PlanMode;
}
export declare function parseSkillsCliArgs(argv: string[]): ParsedArgs;
export declare function runSkillsCli(argv: string[], options?: Pick<InstallSkillsOptions, "log" | "isInteractive" | "baseDir" | "promptSkills" | "promptClients" | "promptScope" | "promptUpdateInstructions" | "promptGithubAction" | "promptPlanMode" | "promptPlanMcpUrl">): Promise<void>;
export declare function installSkills(options: InstallSkillsOptions): Promise<InstallSkillsResult>;
export declare function createInstallId(): string;
export {};
//# sourceMappingURL=index.d.ts.map