earl 0.5.2

AI-safe CLI for AI agents
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

version  = 1
provider = "browser"
categories = ["browser", "navigation"]

command "snapshot" {
  title       = "Snapshot"
  summary     = "Get an accessibility tree snapshot of the current browser session"
  description = "Returns the accessibility tree of the current page in a persistent browser session. Use the returned refs to click, fill, or interact with elements in subsequent commands."

  annotations {
    mode = "read"
  }

  param "session_id" {
    type        = "string"
    required    = true
    description = "Browser session ID"
  }

  operation {
    protocol = "browser"
    browser {
      session_id = "{{ args.session_id }}"
      steps = [{ action = "snapshot" }]
    }
  }

  result {
    decode = "json"
    output = "{{ result.text }}"
  }
}

command "click" {
  title       = "Click element"
  summary     = "Click an element in a persistent browser session by ref or CSS selector"
  description = "Click an element identified by a ref (from a snapshot) or a CSS selector."

  annotations {
    mode = "write"
  }

  param "session_id" {
    type        = "string"
    required    = true
    description = "Browser session ID"
  }

  param "ref" {
    type        = "string"
    required    = false
    description = "Accessibility ref from a prior snapshot (e.g. e8)"
  }

  param "selector" {
    type        = "string"
    required    = false
    description = "CSS selector (alternative to ref)"
  }

  operation {
    protocol = "browser"
    browser {
      session_id = "{{ args.session_id }}"
      steps = [
        { action = "click", ref = "{{ args.ref }}", selector = "{{ args.selector }}" },
        { action = "snapshot" },
      ]
    }
  }

  result {
    decode = "json"
    output = "Clicked. Updated page state:\n{{ result.text | truncate(500) }}"
  }
}

command "navigate" {
  title       = "Navigate"
  summary     = "Navigate to a URL in a persistent browser session"
  description = "Navigate the browser session to a URL and return the page snapshot."

  annotations {
    mode = "write"
  }

  param "session_id" {
    type        = "string"
    required    = true
    description = "Browser session ID"
  }

  param "url" {
    type        = "string"
    required    = true
    description = "URL to navigate to"
  }

  operation {
    protocol = "browser"
    browser {
      session_id = "{{ args.session_id }}"
      steps = [
        { action = "navigate", url = "{{ args.url }}" },
        { action = "snapshot" },
      ]
    }
  }

  result {
    decode = "json"
    output = "Navigated to {{ args.url }}. Page state:\n{{ result.text | truncate(500) }}"
  }
}