import { AgentExperienceJournal, type AgentContextCandidate, type AgentExperienceEvent } from '../agent-learning/index.js';
import type { PluginContextRequest, PluginDashboardPage, PluginDescriptor, PluginDiagnostic, PluginActionSource, PluginScope, PluginScopeContext, PluginState, PluginStateFile, PluginStateStore, PluginStorage, PluginStorageStore, PluginView } from './types.js';
type PluginScopeTarget = PluginScope | PluginScopeContext;
export declare class MemoryPluginStorageStore implements PluginStorageStore {
    private readonly values;
    open(pluginId: string, scope: PluginScope, projectId?: string): Promise<PluginStorage>;
}
export declare class MemoryPluginStateStore implements PluginStateStore {
    private state;
    constructor(initial?: PluginState);
    read(): Promise<PluginState>;
    write(state: PluginState): Promise<void>;
}
export declare class JsonPluginStateStore implements PluginStateStore {
    private readonly file;
    constructor(file: PluginStateFile);
    read(): Promise<PluginState>;
    write(state: PluginState): Promise<void>;
}
export interface PluginRuntimeOptions {
    readonly cometVersion: string;
    readonly store: PluginStateStore;
    readonly storage?: PluginStorageStore;
    readonly config?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
    readonly descriptors: readonly PluginDescriptor[];
    readonly journal?: AgentExperienceJournal;
    /** Scope-specific journals keep user learning recoverable across projects. */
    readonly journals?: {
        readonly user: AgentExperienceJournal;
        readonly project: AgentExperienceJournal;
    };
    readonly scheduleLearning?: (task: () => Promise<void>) => void | Promise<void>;
    readonly now?: () => Date;
}
export declare class PluginRuntime {
    private readonly cometVersion;
    private readonly store;
    private readonly storage;
    private readonly config;
    private readonly descriptors;
    private readonly now;
    private readonly learningByScope;
    private readonly learningCoordinators;
    private readonly active;
    private readonly diagnosticEntries;
    private state;
    constructor(options: PluginRuntimeOptions);
    reconcileFirstParty(): Promise<void>;
    list(scope?: PluginScope): Promise<PluginView[]>;
    get(id: string): Promise<PluginView | null>;
    install(id: string, source?: PluginActionSource): Promise<void>;
    enable(id: string, target?: PluginScopeContext): Promise<void>;
    disable(id: string, target?: PluginScopeContext): Promise<void>;
    uninstall(id: string): Promise<void>;
    update(id: string, source?: PluginActionSource): Promise<void>;
    getConfig(id: string): Readonly<Record<string, unknown>>;
    configure(id: string, config: Readonly<Record<string, unknown>>): Promise<void>;
    invoke(id: string, capability: string, input: unknown, scope?: PluginScopeTarget, options?: {
        readonly throwOnError?: boolean;
    }): Promise<unknown>;
    dispatch(value: AgentExperienceEvent): Promise<void>;
    private learningAdapters;
    collectContext(request: PluginContextRequest, scope: PluginScopeTarget): Promise<AgentContextCandidate[]>;
    private replayPendingLearning;
    resolveContext(id: string, request: PluginContextRequest, scope: PluginScopeTarget, owner?: string): Promise<AgentContextCandidate[]>;
    dashboardPages(scope: PluginScopeTarget): Promise<PluginDashboardPage[]>;
    diagnostics(): PluginDiagnostic[];
    private loadScope;
    private setRecord;
    private setProjectPause;
    private record;
    private view;
    private requireDescriptor;
    private requireInstalled;
    private assertCompatible;
    private assertUserInitiatedThirdParty;
    private isCompatible;
    private activeKey;
    private disposeActive;
    private recordExecutionFailure;
    private ensureState;
    private persist;
    private timestamp;
}
export declare class PluginRuntimeError extends Error {
    readonly code: 'missing' | 'incompatible' | 'user-action-required';
    constructor(message: string, code: 'missing' | 'incompatible' | 'user-action-required');
}
export {};
//# sourceMappingURL=plugin-runtime.d.ts.map