1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
// Copyright 2025 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_RENDERER_ACTOR_TOOL_BASE_H_
#define CHROME_RENDERER_ACTOR_TOOL_BASE_H_
#include <cstdint>
#include <string>
#include "base/functional/callback_forward.h"
#include "base/memory/raw_ref.h"
#include "base/time/time.h"
#include "chrome/common/actor.mojom-forward.h"
#include "chrome/renderer/actor/journal.h"
namespace content {
class RenderFrame;
}
namespace actor {
class ToolBase {
public:
ToolBase(content::RenderFrame& frame,
Journal::TaskId task_id,
Journal& journal)
: frame_(frame), task_id_(task_id), journal_(journal) {}
virtual ~ToolBase() = default;
// Executes the tool and returns the result code.
virtual mojom::ActionResultPtr Execute() = 0;
// Returns a human readable string representing this tool and its parameters.
// Used primarily for logging and debugging.
virtual std::string DebugString() const = 0;
// The minimum amount of time to wait before allowing an observation. 0 by
// default, meaning no delay, but tools can override this on a case-by-case
// basis when needed to ensure an observation isn't captured before this time.
virtual base::TimeDelta MinimumObservationDelay() const;
protected:
// Raw ref since this is owned by ToolExecutor whose lifetime is tied to
// RenderFrame.
base::raw_ref<content::RenderFrame> frame_;
Journal::TaskId task_id_;
base::raw_ref<Journal> journal_;
};
} // namespace actor
#endif // CHROME_RENDERER_ACTOR_TOOL_BASE_H_
|
