// Copyright 2026 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_SKILLS_SKILLS_UI_TAB_CONTROLLER_INTERFACE_H_
#define CHROME_BROWSER_SKILLS_SKILLS_UI_TAB_CONTROLLER_INTERFACE_H_

#include <memory>
#include <optional>
#include <string>

namespace glic {
struct Target;
}

#include "base/memory/weak_ptr.h"
#include "components/skills/public/skill.mojom-forward.h"
#include "components/skills/public/skills_metrics.h"
#include "ui/base/unowned_user_data/scoped_unowned_user_data.h"

namespace tabs {
class TabInterface;
}

namespace skills {

struct Skill;

class SkillsUiTabControllerInterface {
 public:
  DECLARE_USER_DATA(SkillsUiTabControllerInterface);
  explicit SkillsUiTabControllerInterface(tabs::TabInterface& tab);
  virtual ~SkillsUiTabControllerInterface();

  // Retrieves an SkillsUiTabController from the provided tab, or
  // nullptr if it does not exist.
  static SkillsUiTabControllerInterface* From(tabs::TabInterface* tab);

  // Opens the skills dialog.
  virtual void ShowDialog(Skill skill,
                          SkillsDialogEntryPoint entrypoint,
                          skills::mojom::SkillsDialogType dialog_type,
                          std::unique_ptr<glic::Target> target) = 0;

  // Closes the skills dialog if open.
  virtual void CloseDialog() = 0;

  // Returns true if the skills dialog is currently being shown.
  virtual bool IsShowing() const = 0;

  // Invokes the skill with skill_id in sidepanel.
  virtual void InvokeSkill(std::string_view skill_id,
                           std::string_view skill_name,
                           std::string_view skill_icon,
                           bool auto_submit) = 0;

  // Sends a prompt to the side panel.
  virtual void SendPrompt(std::string_view prompt) = 0;

 private:
  ::ui::ScopedUnownedUserData<SkillsUiTabControllerInterface>
      scoped_unowned_user_data_;
};

}  // namespace skills

#endif  // CHROME_BROWSER_SKILLS_SKILLS_UI_TAB_CONTROLLER_INTERFACE_H_