export type TapInvocationBoundary = "input" | "contract" | "governance" | "scope" | "runtime-state";
export type TapInvocationSource = "mainLoop" | "stateEngine" | "officialModuleBridge" | "runtime.execEngine" | "runtime.officialModuleSurface";
export type TapInvocationGate = {
    accepted: boolean;
    reason?: string;
};
export type TapInvocationTrace = {
    correlationId?: string;
    callerId?: string;
};
export type TapInvocationRequest = {
    runtimeId?: string;
    sessionId?: string;
    invocationId?: string;
    source?: TapInvocationSource;
    operation?: string;
    callContext?: Readonly<Record<string, unknown>>;
    governanceContext?: readonly string[];
    requestedSubscribers?: readonly string[];
    allowedSubscribers?: readonly string[];
    runtimeReady?: boolean;
    contract?: TapInvocationGate;
    governance?: TapInvocationGate;
    trace?: TapInvocationTrace;
    emittedAt?: string;
    metadata?: Readonly<Record<string, unknown>>;
};
export type TapInvocationErrorCode = "MISSING_RUNTIME_ID" | "MISSING_SESSION_ID" | "MISSING_INVOCATION_ID" | "MISSING_EVENT_SOURCE" | "MISSING_OPERATION" | "RUNTIME_NOT_READY" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "SUBSCRIBER_SCOPE_DENIED";
export type TapInvocationError = {
    code: TapInvocationErrorCode;
    message: string;
    boundary: TapInvocationBoundary;
    safeForRuntimeInspection: true;
    internalDetailExposed: false;
};
export type TapInvocationEvent = {
    type: "officialPoolInvocation.tap.requested";
    runtimeId: string;
    sessionId: string;
    invocationId: string;
    route: "agent_executionEngine.coreLogic.eventExposurePlane.officialPoolInvocation";
    source: TapInvocationSource;
    officialModule: {
        name: "TAP";
        operation: string;
        resultEnvelope: "not-executed";
    };
    payload: {
        callContextKeys: readonly string[];
        governanceContext: readonly string[];
    };
    trace: TapInvocationTrace;
    emittedAt: string;
    contractSurface: "runtime.contractSurface";
    governanceRequired: true;
    dryRun: true;
    unsafeSideEffects: false;
    metadata: Readonly<Record<string, unknown>>;
};
export type TapInvocationDispatch = {
    mode: "dry-run";
    requestedSubscribers: readonly string[];
    deliverableSubscribers: readonly string[];
    actualModuleCallStarted: false;
};
export type TapInvocationResult = {
    ok: true;
    event: TapInvocationEvent;
    dispatch: TapInvocationDispatch;
    events: readonly string[];
} | {
    ok: false;
    error: TapInvocationError;
    events: readonly string[];
};
export declare const tapInvocationDescriptor: {
    readonly type: "officialPoolInvocation.tap.requested";
    readonly route: "agent_executionEngine.coreLogic.eventExposurePlane.officialPoolInvocation";
    readonly purpose: "expose TAP official module invocation events without executing TAP behavior";
    readonly dispatch: "dry-run";
    readonly unsafeSideEffects: false;
};
export declare function exposeTapInvocationEvent(request?: TapInvocationRequest): TapInvocationResult;
