import { type ServiceAdapterContext, type ServiceAdapterDeclaration, type ServiceAdapterLaunch, type ServiceAdapterReadiness, type ServiceAdapterHooks } from "@cotal-ai/workspace";
export interface ServiceAdapterPin {
    name: string;
    package: string | null;
    version: string;
    declarationSha256: string;
}
export interface ResolvedServiceAdapter {
    pin: ServiceAdapterPin;
    declaration: ServiceAdapterDeclaration;
}
export interface LoadedServiceAdapter extends ResolvedServiceAdapter {
    prepareStop?: ServiceAdapterHooks["prepareServiceStop"];
    stop?: ServiceAdapterHooks["stopService"];
    settleStop?: ServiceAdapterHooks["settleServiceStop"];
    abandonStop?: ServiceAdapterHooks["abandonServiceStop"];
    prepareKernelStop?: ServiceAdapterHooks["prepareKernelStop"];
    observeKernelStop?: ServiceAdapterHooks["observeKernelStop"];
    build: (context: ServiceAdapterContext) => ServiceAdapterLaunch | Promise<ServiceAdapterLaunch>;
    readiness: (context: ServiceAdapterContext & {
        process: {
            pid: number;
            token: string;
        };
        signal: AbortSignal;
    }) => Promise<ServiceAdapterReadiness>;
}
/** Resolve only cached data during add, previews and semantic validation. Executable hooks are
 *  materialized separately, under the ordinary version-locked extension import path. */
export declare function resolveServiceAdapter(name: string, options: Readonly<Record<string, unknown>>, checkOptions?: boolean): ResolvedServiceAdapter;
/** Whether two pins name the same provider and declaration. A built-in or `@cotal-ai/*` adapter is
 *  version-locked to this CLI, so its recorded version only says which release wrote the record:
 *  after an upgrade that left the declaration unchanged, instances an earlier release recorded stay
 *  controllable. Any other package keeps its version in the pin. */
export declare function sameServiceAdapterPin(a: ServiceAdapterPin | undefined, b: ServiceAdapterPin | undefined): boolean;
/** Call only after an explicitly authorized operation has reserved its definition and launch. */
export declare function loadServiceAdapter(expected: ResolvedServiceAdapter, options: Readonly<Record<string, unknown>>): Promise<LoadedServiceAdapter>;
//# sourceMappingURL=service-adapters.d.ts.map