interface AgentUtils {
  // Gesture helpers
  randomClick(x1: number, y1: number, x2: number, y2: number): void;
  randomSwipe(x1: number, y1: number, x2: number, y2: number, direction: Direction): void;

  // Server connectivity
  isServerReachable(): Promise<{ reachable: true } | { reachable: false; error: string }>;

  // Event callbacks (for notifications, see agent.notifications)
  setNetworkCallback(callback: NetworkCallback | null): void;
  toastCallback: ToastCallback | null;

  // Step tracking & debugging
  outOfSteps: {
    storeScreen(screen: AndroidNode, stage: string, screenState: string, remainingSteps: number, screenshotRecord: ScreenshotRecord): Promise<void>;
    submit(type: "outOfSteps" | "timeout" | "debug"): Promise<SubmitResult>;
  };

  // Job task management
  job: {
    submitTask(status: AutomationStatus, data: Record<string, any>, finish: boolean, files: File[]): Promise<TaskResult>;
    useAnotherTask(): Promise<TaskInfo | null>;
    getCurrentTask(): Promise<CurrentTaskResult>;
  };

  // File operations
  files: AgentFiles;
}

// Random tap within a button area (more human-like)
const button = screen.findTextOne("Submit");
if (button) {
  button.randomClick();
}

// Get current task and submit results
const task = await agent.utils.job.getCurrentTask();
if (task.success) {
  const proof = task.job_proof;

  // ... perform automation ...

  await agent.utils.job.submitTask(
    "success",
    { orderId: "12345", completed: true },
    true, // Final submission
    []
  );
}

// Read and process files
const files = agent.utils.files.list("/sdcard/Download");
for (const file of files) {
  if (file.name.endsWith(".json")) {
    const content = agent.utils.files.readFullFile(file.path);
    const data = JSON.parse(content);
    console.log(data);
  }
}