export type McpInvocationBoundary = "input" | "contract" | "governance" | "scope" | "runtime-state";
export type McpInvocationSource = "mainLoop" | "stateEngine" | "basicToolLayer" | "officialModuleBridge" | "runtime";
export type McpInvocationGate = {
    accepted: boolean;
    reason?: string;
};
export type McpInvocationTrace = {
    correlationId?: string;
    callerId?: string;
};
export type McpInvocationRequest = {
    runtimeId?: string;
    sessionId?: string;
    invocationId?: string;
    source?: McpInvocationSource;
    serverId?: string;
    toolName?: string;
    requestedScopes?: readonly string[];
    allowedScopes?: readonly string[];
    runtimeReady?: boolean;
    contract?: McpInvocationGate;
    governance?: McpInvocationGate;
    trace?: McpInvocationTrace;
    emittedAt?: string;
    metadata?: Readonly<Record<string, unknown>>;
};
export type McpInvocationErrorCode = "MISSING_RUNTIME_ID" | "MISSING_SESSION_ID" | "MISSING_INVOCATION_ID" | "MISSING_EVENT_SOURCE" | "MISSING_MCP_TARGET" | "RUNTIME_NOT_READY" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "SCOPE_DENIED";
export type McpInvocationError = {
    code: McpInvocationErrorCode;
    message: string;
    boundary: McpInvocationBoundary;
    safeForRuntimeInspection: true;
};
export type McpInvocationEvent = {
    eventId: string;
    kind: "basicToolInvocation.mcp";
    runtimeId: string;
    sessionId: string;
    invocationId: string;
    source: McpInvocationSource;
    mcp: {
        serverId: string;
        toolName: string;
    };
    requestedScopes: readonly string[];
    grantedScopes: readonly string[];
    trace: McpInvocationTrace;
    emittedAt: string;
    route: "runtime.execEngine.eventExposurePlane";
    dispatch: "dry-run";
    unsafeSideEffects: false;
    metadata: Readonly<Record<string, unknown>>;
};
export type McpInvocationResult = {
    ok: true;
    event: McpInvocationEvent;
    events: readonly string[];
} | {
    ok: false;
    error: McpInvocationError;
    events: readonly string[];
};
export declare const mcpInvocationDescriptor: {
    readonly kind: "basicToolInvocation.mcp";
    readonly route: "runtime.execEngine.eventExposurePlane";
    readonly purpose: "expose MCP basic tool invocation events without executing MCP tools";
    readonly dispatch: "dry-run";
    readonly unsafeSideEffects: false;
};
export declare function exposeMcpInvocationEvent(request?: McpInvocationRequest): McpInvocationResult;
