export declare const DEFAULT_API_BASE = "https://skills.agenticros.com/api";
export declare function apiBase(): string;
export interface MarketplaceSkill {
    slug: string;
    marketplaceRef?: string;
    ownerLogin?: string;
    skillSlug?: string;
    name: string;
    displayName: string;
    description: string;
    packageName: string;
    skillId: string;
    version: string;
    githubUrl: string;
    categories: string[];
    keywords: string[];
    maintainerLogin: string;
    starCount: number;
    viewCount: number;
    visibility?: string;
}
export interface InstallDescriptor {
    slug: string;
    marketplaceRef?: string;
    skillId: string;
    packageName: string;
    githubUrl: string;
    ref: string;
    buildCmd: string;
    npmPackage?: string;
    npmVersion?: string;
}
export declare function skillApiPath(ref: string): string;
export declare function displayRef(skill: MarketplaceSkill | InstallDescriptor): string;
export declare class MarketplaceError extends Error {
}
export declare function searchSkills(q: string, opts?: {
    limit?: number;
    category?: string;
    sort?: "recent" | "popular";
}): Promise<MarketplaceSkill[]>;
export declare function getSkill(ref: string): Promise<MarketplaceSkill>;
export declare function getInstallDescriptor(ref: string): Promise<InstallDescriptor>;
export interface ValidateResult {
    ok: boolean;
    errors: string[];
    warnings: string[];
}
export declare function validateSkillOnMarketplace(manifest: unknown): Promise<ValidateResult>;
export interface SubmitResult {
    marketplaceRef: string;
    ownerLogin: string;
    skillSlug: string;
    visibility: string;
    warnings?: string[];
}
export declare function submitSkillToMarketplace(opts: {
    githubUrl: string;
    githubAccessToken: string;
}): Promise<SubmitResult>;
/**
 * Pick a sensible parent directory for `git clone` — the parent of the
 * agenticros repo if we can find it, otherwise `~/Projects`, otherwise
 * `$HOME`. This keeps cloned skills next to the rest of the user's robot
 * source so the existing discovery roots find them too.
 */
export declare function pickCloneParent(): string;
export interface CloneAndBuildResult {
    cloneDir: string;
    alreadyExisted: boolean;
}
/**
 * `git clone` a skill from GitHub into a sibling of the agenticros repo,
 * then run its build command. Returns the absolute directory the skill
 * was cloned into so the caller can `addSkillByPath` it.
 */
export declare function cloneAndBuild(descriptor: InstallDescriptor, opts?: {
    intoDir?: string;
    force?: boolean;
    onLog?: (msg: string) => void;
}): Promise<CloneAndBuildResult>;
export declare const utilDirname: (path: string) => string;
//# sourceMappingURL=marketplace.d.ts.map