import { type AiAuthoringContextLockV2, type AiAuthoringContextManifestV2, type AiAuthoringContextSnapshotV2, type AiContextSurface, type VerifyAiAuthoringContextFreshnessRequestV2 } from '@nexusclaw/shared';
import { ApiClient } from './api-client';
import { AiContextSigningKeyCache } from './ai-context-signing-key-cache';
export interface ContextTargetOptions {
    readonly surface: AiContextSurface;
    readonly targetOrg?: string;
    readonly offline?: boolean;
    readonly callerPreview?: boolean;
    readonly agentApiName?: string;
    readonly candidateReleaseSetId?: string;
}
export interface ExportContextOptions extends ContextTargetOptions {
    readonly outDir: string;
    readonly workspaceDir: string;
}
export interface VerifyContextOptions {
    readonly manifestPath: string;
    readonly targetOrg?: string;
}
export declare function describeAuthoringContext(options: ContextTargetOptions, clientFactory?: (alias: string) => ApiClient, keyCache?: AiContextSigningKeyCache): Promise<AiAuthoringContextSnapshotV2 | Record<string, unknown>>;
export declare function exportAuthoringContextV2(options: ExportContextOptions, clientFactory?: (alias: string) => ApiClient): Promise<{
    readonly manifest: AiAuthoringContextManifestV2;
    readonly lock: AiAuthoringContextLockV2;
    readonly writtenFiles: readonly string[];
}>;
export declare function verifyAuthoringContextV2(options: VerifyContextOptions, clientFactory?: (alias: string) => ApiClient, keyCache?: AiContextSigningKeyCache): Promise<{
    readonly valid: true;
    readonly mode: 'online' | 'offline';
}>;
export declare function loadAuthoringContextFreshnessInput(manifestPathInput: string): VerifyAiAuthoringContextFreshnessRequestV2;