export type CursorLocateBoundary = "input" | "contract" | "governance" | "scope" | "provider";
export type CursorLocateGate = {
    accepted?: boolean;
    allowed?: boolean;
    reason?: string;
};
export type CursorLocateContext = {
    runtimeId?: string;
    sessionId?: string;
    invocationId?: string;
    dryRun?: boolean;
    guard?: CursorLocateGate;
    contract?: CursorLocateGate;
    governance?: CursorLocateGate;
    requestedScopes?: readonly string[];
    allowedScopes?: readonly string[];
    auditMetadata?: Readonly<Record<string, unknown>>;
};
export type CursorLocateCoordinateSpace = "screen" | "window" | "normalized";
export type CursorLocateTarget = {
    coordinateSpace: CursorLocateCoordinateSpace;
    displayId?: string;
};
export type CursorPosition = {
    x: number;
    y: number;
    coordinateSpace: CursorLocateCoordinateSpace;
    displayId?: string;
};
export type CursorLocateProviderRequest = {
    operation: "computeruse.cursorLocate.locateCursor";
    target: CursorLocateTarget;
    context: {
        runtimeId?: string;
        sessionId?: string;
        invocationId?: string;
        auditMetadata?: Readonly<Record<string, unknown>>;
    };
    purpose: string;
};
export type CursorLocateProviderResult = {
    position: CursorPosition;
    capturedAt?: string;
    metadata?: Readonly<Record<string, unknown>>;
};
export type CursorLocateProvider = (request: CursorLocateProviderRequest) => Promise<CursorLocateProviderResult> | CursorLocateProviderResult;
export type CursorLocateRequest = {
    target?: unknown;
    context?: unknown;
    coordinateSpace?: unknown;
    displayId?: unknown;
    purpose?: unknown;
    metadata?: unknown;
    provider?: CursorLocateProvider;
};
export type CursorLocateErrorCode = "INVALID_REQUEST" | "INVALID_TARGET" | "INVALID_CONTEXT" | "MISSING_RUNTIME_ID" | "MISSING_PURPOSE" | "INVALID_COORDINATE_SPACE" | "INVALID_DISPLAY_ID" | "SCOPE_DENIED" | "CONTRACT_REJECTED" | "GOVERNANCE_REJECTED" | "PROVIDER_UNAVAILABLE" | "PROVIDER_FAILURE" | "INVALID_CURSOR_POSITION";
export type CursorLocateError = {
    code: CursorLocateErrorCode;
    message: string;
    boundary: CursorLocateBoundary;
    publicSafe: true;
    safeForRuntimeInspection: true;
    internalDetailExposed: false;
};
export type CursorLocateAuditEvent = {
    type: string;
    toolId: "computeruse.cursorLocate";
    invocationId: string;
    dryRun: boolean;
    metadata: Readonly<Record<string, unknown>>;
};
export type CursorLocateOutput = {
    kind: "agentCore.basicTool.computeruse.cursorLocate";
    target: CursorLocateTarget;
    purpose: string;
    dispatch: "dry-run" | "runtime-computeruse";
    dryRun: boolean;
    providerCalled: boolean;
    executionBlocked: boolean;
    unsafeSideEffects: false;
    permissionsRequired: readonly ["pointer:read", "ui:observe"];
    requiresTapApproval: true;
    acceptedScopes: readonly string[];
    runtimeEntry: {
        port: "BaseToolExecutorPort.computeruse.locateCursor";
        operation: "computeruse.cursorLocate.locateCursor";
        runtimeOwnsCursorRead: true;
        runtimeOwnsInputPolicy: true;
        baseToolOwnsTapStrategy: false;
    };
    observationEnvelope: {
        resource: "pointer";
        action: "locate";
        observed: boolean;
        metadataOnly: boolean;
        capturedAt?: string;
    };
    position?: CursorPosition;
    providerMetadata?: Readonly<Record<string, unknown>>;
};
export type CursorLocateResult = {
    ok: true;
    toolId: "computeruse.cursorLocate";
    output: CursorLocateOutput;
    audit: readonly CursorLocateAuditEvent[];
    events: readonly string[];
} | {
    ok: false;
    toolId: "computeruse.cursorLocate";
    error: CursorLocateError;
    audit: readonly CursorLocateAuditEvent[];
    events: readonly string[];
};
export declare const cursorLocateDescriptor: {
    readonly toolId: "computeruse.cursorLocate";
    readonly capability: "locate-cursor";
    readonly route: "agent_executionEngine.basic_toolLayer.baseTools.computeruseBase.mouseEmulation";
    readonly defaultDryRun: true;
    readonly defaultCoordinateSpace: "screen";
    readonly maxCoordinate: 100000;
    readonly tapOwnsApproval: true;
    readonly runtimeEntry: "BaseToolExecutorPort.computeruse.locateCursor";
    readonly permissionsRequired: readonly ["pointer:read", "ui:observe"];
    readonly unsafeSideEffects: false;
};
export declare function executeCursorLocate(request?: unknown): Promise<CursorLocateResult>;
export declare function planCursorLocate(request?: unknown): Promise<CursorLocateResult>;
