import { type AppSkillManifest } from "./app-skill.js";
import { type ClientId } from "./mcp-config-writers.js";
import { installScreenMemoryForClient } from "./mcp.js";
import { CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD } from "./skills-content/index.js";
import { type CliTelemetry } from "./telemetry.js";
export { CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD, };
export declare const BUILT_IN_APP_SKILLS: {
    "agent-native": {
        skillName: string;
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    assets: {
        skillName: string;
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    content: {
        skillName: string;
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    rewind: {
        skillName: string;
        screenMemoryMcp: true;
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    design: {
        skillName: string;
        extraSkills: {
            "visual-edit": string;
        };
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    "visual-plans": {
        skillName: string;
        extraSkills: {
            "visual-recap": string;
            "visualize-repo": string;
        };
        extraFiles: {
            "visual-plan": {
                "references/wireframe.md": string;
                "references/canvas.md": string;
                "references/document-quality.md": string;
                "references/exemplar.md": string;
                "references/connection.md": string;
                "references/local-files.md": string;
            };
            "visual-recap": {
                "references/wireframe.md": string;
                "references/connection.md": string;
                "references/local-files.md": string;
            };
        };
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    "context-xray": {
        skillName: string;
        localOnly: true;
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
    "turn-into-app": {
        skillName: string;
        extraFiles: {
            "turn-into-app": {
                "references/attachments.md": string;
                "references/fresh-project.md": string;
                "references/spreadsheet-source.md": string;
                "references/local-run-and-deploy.md": string;
                "references/review-loop.md": string;
                "references/source-brief.md": string;
                "references/ui-archetypes.md": string;
                "references/ui-direction.md": string;
                "references/ui-palettes.md": string;
                "references/where-it-runs.md": string;
                "agents/openai.yaml": string;
            };
        };
        manifest: AppSkillManifest;
        skillMarkdown: string;
    };
};
export declare const AGENT_NATIVE_SKILL_METADATA_FILE = "agent-native-skill.json";
type SkillInstructionClientId = ClientId | "pi";
type SkillsCommand = "list" | "add" | "status" | "update" | "help";
type PlanInstallMode = "hosted" | "local-files" | "self-hosted";
export interface ParsedSkillsArgs {
    command: SkillsCommand;
    target?: string;
    baseDir?: string;
    client: string;
    clientExplicit: boolean;
    clients?: SkillInstructionClientId[];
    plainSkillNames?: string[];
    scope: string;
    scopeExplicit: boolean;
    yes: boolean;
    dryRun: boolean;
    printJson: boolean;
    instructions: boolean;
    mcp: boolean;
    connect: boolean;
    mcpUrl?: string;
    planMode?: PlanInstallMode;
    withGithubAction?: boolean;
    githubActionResolved?: boolean;
    updateInstructions?: boolean;
    force?: boolean;
}
export interface SkillsAddResult {
    id: string;
    displayName: string;
    instructionSource?: string;
    skillNames: string[];
    skillsAgents: string[];
    mcpUrl: string;
    mcpClients: ClientId[];
    dryRun: boolean;
    commands: string[];
    local?: boolean;
    scriptPath?: string;
    written?: string[];
    connected?: boolean;
    connectCommand?: string;
    githubActionPath?: string;
    githubActionExisted?: boolean;
    githubActionSuggestedCommand?: string;
    localManifestPath?: string;
    planMode?: PlanInstallMode;
}
interface RunCommandOptions {
    stdio?: "inherit" | "stderr" | "silent";
}
export type SkillsCatalogMode = "agent-native" | "all";
export interface PublicSkillCatalogEntry {
    name: string;
    description?: string;
    installerGroup?: string;
}
interface ConnectSpinner {
    start(message?: string): void;
    clear(): void;
}
export interface RunSkillsOptions {
    baseDir?: string;
    catalogMode?: SkillsCatalogMode;
    publicSkillSource?: string;
    publicSkillEntries?: PublicSkillCatalogEntry[];
    hiddenBuiltInSkillTargets?: string[];
    isInteractive?: () => boolean;
    log?: (message: string) => void;
    connectLog?: (message: string) => void;
    createConnectSpinner?: () => ConnectSpinner | undefined;
    promptClients?: (context: SkillsClientPromptContext) => Promise<SkillInstructionClientId[] | null>;
    promptSkills?: (context: SkillsTargetPromptContext) => Promise<string[] | null>;
    promptGithubAction?: (context: SkillsGithubActionPromptContext) => Promise<boolean | null>;
    promptScope?: (context: SkillsScopePromptContext) => Promise<"project" | "user" | null>;
    promptPlanMode?: (context: SkillsPlanModePromptContext) => Promise<PlanInstallMode | null>;
    promptPlanMcpUrl?: () => Promise<string | null>;
    promptUpdateInstructions?: () => Promise<boolean | null>;
    runCommand?: (cmd: string, args: string[], options?: RunCommandOptions) => Promise<number>;
    runConnect?: (args: string[]) => Promise<void>;
    listenForSignInSkip?: (skip: () => void) => () => void;
    detectInstalledClients?: (candidates: readonly ClientId[]) => ClientId[];
    installScreenMemory?: typeof installScreenMemoryForClient;
    telemetry?: CliTelemetry;
}
interface SkillsClientPromptContext {
    initialClients: SkillInstructionClientId[];
    options: Array<{
        value: SkillInstructionClientId;
        label: string;
        hint: string;
    }>;
    installsMcp: boolean;
}
interface SkillsTargetPromptContext {
    message?: string;
    initialTargets: string[];
    required?: boolean;
    options: Array<{
        value: string;
        label: string;
        hint: string;
    }>;
}
interface SkillsGithubActionPromptContext {
    workflowPath: string;
    setupCommand: string;
    docsUrl: string;
}
interface SkillsScopePromptContext {
    initialScope: "project" | "user";
}
interface SkillsPlanModePromptContext {
    initialMode: PlanInstallMode;
}
export declare function builtInCommandsRootForAgent(agent: string, scope: "project" | "user", baseDir: string): string;
declare function copyScaffoldGuidanceSkills(sourceRoots: readonly string[], targetRoot: string, allowedSkills: readonly string[], onlyExistingTargetSkills?: boolean): void;
export { copyScaffoldGuidanceSkills as _copyScaffoldGuidanceSkills };
export declare function parseSkillsArgs(argv: string[]): ParsedSkillsArgs;
export declare function addAgentNativeSkill(parsed: ParsedSkillsArgs, options?: RunSkillsOptions): Promise<SkillsAddResult>;
export declare function runSkills(argv: string[], options?: RunSkillsOptions): Promise<void>;