import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
import { AnalysisArtifactDetail, AnalysisArtifactMetadataUpdate, AnalysisArtifactStatusFilter, AnalysisArtifactSummary, AnalysisArtifactTarget } from '../types/analysisArtifactTypes';
export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from '../types/analysisArtifactTypes';
export interface UseAnalysisArtifactsOptions {
    /** Experiment id; defaults to platform injection or URL. Refetches when it changes. */
    experimentId?: MaybeRefOrGetter<number | undefined>;
    /** Override API base URL. */
    apiBaseUrl?: string;
    /** Scope to a single owning plugin; omit or null to keep all plugins. */
    pluginId?: MaybeRefOrGetter<string | null | undefined>;
    /** Always request archived artifacts alongside active ones. */
    includeArchived?: MaybeRefOrGetter<boolean | undefined>;
    /** Fetch as soon as an experiment id is available. */
    immediate?: boolean;
}
export interface UseAnalysisArtifactsReturn {
    /** Fetched artifacts, scoped to pluginId when set. */
    artifacts: ComputedRef<AnalysisArtifactSummary[]>;
    /** Artifacts after applying statusFilter, pluginFilter, and search. */
    visibleArtifacts: ComputedRef<AnalysisArtifactSummary[]>;
    /** Detail loaded by the last successful getDetail call, or null. */
    selectedDetail: Ref<AnalysisArtifactDetail | null>;
    /** Resolved experiment id from options, platform injection, or URL. */
    currentExperimentId: ComputedRef<number | undefined>;
    /** Whether an experiment id is available. */
    hasCurrentExperiment: ComputedRef<boolean>;
    /** Whether any list or detail fetch is in progress. */
    isLoading: ComputedRef<boolean>;
    /** Whether any archive/restore/metadata mutation is in progress. */
    isMutating: ComputedRef<boolean>;
    /** Error message from the last failed operation, or null. */
    error: Ref<string | null>;
    /** Timestamp of the last successful load, or null. */
    lastLoadedAt: Ref<Date | null>;
    /** Case-insensitive filter over display_name and artifact_key. */
    search: Ref<string>;
    /** Lifecycle filter; widening past "active" refetches with include_archived. */
    statusFilter: Ref<AnalysisArtifactStatusFilter>;
    /** Plugin filter applied to visibleArtifacts, or null for all plugins. */
    pluginFilter: Ref<string | null>;
    /** Fetch the artifact list for the current experiment. */
    list: () => Promise<AnalysisArtifactSummary[]>;
    /** Alias of list. */
    refresh: () => Promise<AnalysisArtifactSummary[]>;
    /** Fetch one artifact with its result payload; null when it fails or is superseded. */
    getDetail: (artifactId: number) => Promise<AnalysisArtifactDetail | null>;
    /** Resolve and fetch the exact stable artifact identity. */
    resolveTarget: (target: AnalysisArtifactTarget) => Promise<AnalysisArtifactDetail | null>;
    /** Update display_name and/or note; resolves to the updated summary or null. */
    updateMetadata: (artifactId: number, updates: AnalysisArtifactMetadataUpdate) => Promise<AnalysisArtifactSummary | null>;
    /** Archive an artifact; resolves to the updated summary or null. */
    archive: (artifactId: number) => Promise<AnalysisArtifactSummary | null>;
    /** Restore an archived artifact; resolves to the updated summary or null. */
    restore: (artifactId: number) => Promise<AnalysisArtifactSummary | null>;
    /** Whether a key exists in the loaded artifacts (no network call). */
    hasArtifactKey: (artifactKey: string) => boolean;
    /** Reset artifacts, selection, and error. */
    clear: () => void;
}
/**
 * Lists and manages analysis artifacts through the user-facing platform API.
 *
 * @example Recommended
 * ```ts
 * const artifacts = useAnalysisArtifacts({ pluginId: 'LEAF' })
 * await artifacts.list()
 * ```
 */
export declare function useAnalysisArtifacts(options?: UseAnalysisArtifactsOptions): UseAnalysisArtifactsReturn;