import { ErrorCode as AgentErrorCode } from "@opengeni/agent-proto";
import { type InteractionControlFailureCode } from "@opengeni/contracts";
import { ApiHttpError } from "./api-error.js";
export type InteractionControlSurface = "browser" | "computer";
/**
 * Projects an internal connected-machine control fault into the public API
 * vocabulary. This is deliberately an allowlist: the agent's free-form message
 * and detail map may contain paths, process output, or provider diagnostics and
 * never cross this boundary. The exact inner request id is safe opaque
 * correlation and links API logs back to the machine operation.
 */
export declare function interactionControlApiError(error: unknown, surface: InteractionControlSurface): ApiHttpError | null;
export declare function publicControlFailureCode(code: AgentErrorCode): InteractionControlFailureCode;