import type { CapabilityEffect, CapabilityManifest, JsonValue } from "./types.js";
export declare const CAPABILITY_PYPI_BINDER_VERSION: "0.2";
export type PyPiFile = {
    filename: string;
    url: string;
    packagetype: string;
    python_version?: string;
    requires_python?: string;
    digests?: {
        sha256?: string;
    };
    yanked?: boolean;
    size?: number;
};
export type PyPiInspection = {
    name: string;
    version: string;
    summary?: string;
    requiresPython?: string;
    projectUrls: Record<string, string>;
    wheel: {
        filename: string;
        url: string;
        sha256: string;
        size?: number;
    };
    vulnerabilities: unknown[];
};
export type PythonCandidate = {
    module: string;
    symbol: string;
    kind: "function" | "console-script";
    score: number;
    evidence: string[];
};
export type PythonMiningReport = {
    artifact: PyPiInspection;
    candidates: PythonCandidate[];
    filesAnalyzed: number;
    notes: string[];
};
export type PythonForge = {
    substrate: "pypi";
    artifact: PyPiInspection;
    candidate: PythonCandidate;
    directory: string;
    wheelPath: string;
    capabilityId: string;
    manifest: CapabilityManifest;
    authority: {
        complete: false;
        effects: CapabilityEffect[];
    };
};
export type PythonExecutionReceipt = {
    substrate: "pypi";
    binderVersion: typeof CAPABILITY_PYPI_BINDER_VERSION;
    package: string;
    version: string;
    wheel: string;
    artifactSha256: string;
    artifactVerified: true;
    baseImage: string;
    baseImageDigest: string;
    module: string;
    symbol: string;
    kind: PythonCandidate["kind"];
    isolation: "docker";
    network: "none";
    dependencyPolicy: "no-deps";
    status: "succeeded" | "failed";
    result?: JsonValue;
    stderr?: string;
    startedAt: string;
    finishedAt: string;
};
export declare function inspectPyPiPackage(name: string, version?: string, fetchImpl?: typeof fetch): Promise<PyPiInspection>;
export declare function downloadVerifiedPyPiWheel(artifact: PyPiInspection, fetchImpl?: typeof fetch): Promise<Uint8Array>;
export declare function minePyPiArtifact(name: string, options?: {
    version?: string;
    query?: string;
    fetch?: typeof fetch;
    maxFiles?: number;
}): Promise<PythonMiningReport>;
export declare function forgePyPiAbility(name: string, options?: {
    version?: string;
    query?: string;
    module?: string;
    symbol?: string;
    directory?: string;
    fetch?: typeof fetch;
}): Promise<PythonForge>;
export declare function executePyPiAbility(forged: PythonForge, input: {
    args?: unknown[];
    kwargs?: Record<string, unknown>;
}, options?: {
    approved?: boolean;
    dockerCommand?: string;
    timeoutMs?: number;
}): Promise<PythonExecutionReceipt>;
//# sourceMappingURL=pypi.d.ts.map