import type { AssetExactResult, AssetInstallMetadata, AssetSearchResult, AssetVersion, GenerateAssetResult, PaginatedList } from './contract.js';
import type { AssetAccess, AssetDependencies, AssetType, GenerateJobStatus } from './schemas.js';
export declare const ASSET_RELEVANCE_SCORE: unique symbol;
export interface RankedAssetSearchResult extends AssetSearchResult {
    [ASSET_RELEVANCE_SCORE]?: number;
}
export interface AssetSearchInput {
    page: number;
    limit: number;
    type?: AssetType;
    query?: string;
    includeUnapproved: boolean;
}
export interface AssetExactInput {
    name: string;
    type?: AssetType;
    version?: string;
    includeUnapproved: boolean;
    /** The asset's capability key, an alternative credential to identity for private/unapproved assets. */
    key?: string;
}
export interface AssetUploadZipInput {
    name: string;
    type: AssetType;
    version: string;
    description?: string;
    npmDependencies: Record<string, string>;
    assetDependencies: AssetDependencies;
    skillDependencies: Record<string, string>;
    tags: string[];
    zip: File;
    /** Requested visibility; the worker resolves the effective access (see `AssetAccess`). */
    access?: AssetAccess;
}
export interface AssetVersionRef {
    name: string;
    version: string;
    /** The asset's capability key, an alternative credential to identity for private/unapproved assets. */
    key?: string;
}
export interface AssetGenerateInput {
    description: string;
    type?: AssetType;
    /** Reference images (https URL or data URI) the result should match; see `referenceImagesSchema`. */
    referenceImages?: string[];
    /** Requested visibility of the generated asset; the worker resolves the effective access. */
    access?: AssetAccess;
}
export interface AssetOwner {
    id: string;
    role: string;
}
export interface GenerationReceipt {
    assetId: string;
    type: AssetType;
    providerJobId: string;
    description: string;
    assetName: string;
    ownerId: string;
    access: AssetAccess;
}
export interface AssetProvider {
    type: AssetType;
    /** Shown when an agent asks how to search this asset type. */
    searchMessage?: string;
    /** Shown to the user after an asset of this type is installed. */
    installMessage?: string;
    /** Whether a top-level install should save this asset to package.json assetDependencies. */
    saveOnInstall?: boolean;
    /** Whether upload should read package.json assetDependencies from the source zip. */
    readAssetDependenciesFromPackageJson?: boolean;
    /** Whether upload should omit unchanged installed dependency files from the source zip. */
    omitUnchangedInstalledFilesOnUpload?: boolean;
    /**
     * Whether generation takes `AssetGenerateInput.referenceImages`. The worker rejects reference
     * images for providers without this, so they fail loudly instead of being silently ignored.
     */
    acceptsReferenceImages?: boolean;
    search(input: AssetSearchInput): Promise<PaginatedList<AssetSearchResult>>;
    exact(input: AssetExactInput): Promise<AssetExactResult | null>;
    uploadZip(input: AssetUploadZipInput, owner: AssetOwner): Promise<AssetVersion>;
    generate?(input: AssetGenerateInput, owner: AssetOwner): Promise<GenerateAssetResult>;
    /**
     * Job-based generation for providers whose upstream work runs for minutes.
     */
    startGeneration?(input: AssetGenerateInput, owner: AssetOwner): Promise<GenerationReceipt>;
    generationStatus?(receipt: GenerationReceipt): Promise<GenerateJobStatus>;
}
export type AssetImplementation = AssetProvider;
export declare function assetRelevanceScore(asset: AssetSearchResult): number | undefined;
export declare function installMetadataForProvider(provider: AssetProvider): AssetInstallMetadata;
export declare function withAssetRelevanceScore(asset: AssetSearchResult, score: number): RankedAssetSearchResult;
//# sourceMappingURL=asset-implementation.d.ts.map