export type SearchInvocationBoundary = "input" | "contract" | "governance" | "scope" | "runtime-state";
export type SearchInvocationSource = "mainLoop" | "stateEngine" | "basicToolLayer" | "officialModuleBridge" | "runtime";
export type SearchInvocationGate = {
    accepted: boolean;
    reason?: string;
};
export type SearchInvocationTrace = {
    correlationId?: string;
    callerId?: string;
};
export type SearchInvocationRequest = {
    runtimeId?: string;
    sessionId?: string;
    invocationId?: string;
    source?: SearchInvocationSource;
    query?: string;
    providerHint?: string;
    requestedScopes?: readonly string[];
    allowedScopes?: readonly string[];
    runtimeReady?: boolean;
    contract?: SearchInvocationGate;
    governance?: SearchInvocationGate;
    trace?: SearchInvocationTrace;
    emittedAt?: string;
    metadata?: Readonly<Record<string, unknown>>;
};
export type SearchInvocationErrorCode = "MISSING_RUNTIME_ID" | "MISSING_SESSION_ID" | "MISSING_INVOCATION_ID" | "MISSING_EVENT_SOURCE" | "MISSING_SEARCH_QUERY" | "RUNTIME_NOT_READY" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "SCOPE_DENIED";
export type SearchInvocationError = {
    code: SearchInvocationErrorCode;
    message: string;
    boundary: SearchInvocationBoundary;
    safeForRuntimeInspection: true;
};
export type SearchInvocationEvent = {
    eventId: string;
    kind: "basicToolInvocation.search";
    runtimeId: string;
    sessionId: string;
    invocationId: string;
    source: SearchInvocationSource;
    search: {
        query: string;
        providerHint?: string;
        resultEnvelope: "not-executed";
    };
    requestedScopes: readonly string[];
    grantedScopes: readonly string[];
    trace: SearchInvocationTrace;
    emittedAt: string;
    route: "runtime.execEngine.eventExposurePlane";
    dispatch: "dry-run";
    unsafeSideEffects: false;
    metadata: Readonly<Record<string, unknown>>;
};
export type SearchInvocationResult = {
    ok: true;
    event: SearchInvocationEvent;
    events: readonly string[];
} | {
    ok: false;
    error: SearchInvocationError;
    events: readonly string[];
};
export declare const searchInvocationDescriptor: {
    readonly kind: "basicToolInvocation.search";
    readonly route: "runtime.execEngine.eventExposurePlane";
    readonly purpose: "expose search basic tool invocation events without making network calls";
    readonly dispatch: "dry-run";
    readonly unsafeSideEffects: false;
};
export declare function exposeSearchInvocationEvent(request?: SearchInvocationRequest): SearchInvocationResult;
