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

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

command "login" {
  title       = "Login"
  summary     = "Log into a site using a form"
  description = "Fills email and password fields and submits the login form."

  annotations {
    mode    = "write"
    secrets = ["site.password"]
  }

  param "url" {
    type        = "string"
    required    = true
    description = "Login page URL"
  }

  param "email" {
    type        = "string"
    required    = true
    description = "Email address"
  }

  param "email_selector" {
    type        = "string"
    required    = false
    default     = "input[type=email]"
    description = "CSS selector for email field"
  }

  param "password_selector" {
    type        = "string"
    required    = false
    default     = "input[type=password]"
    description = "CSS selector for password field"
  }

  param "submit_selector" {
    type        = "string"
    required    = false
    default     = "button[type=submit]"
    description = "CSS selector for submit button"
  }

  param "session_id" {
    type        = "string"
    required    = false
    description = "Session ID to persist the logged-in browser"
  }

  operation {
    protocol = "browser"
    browser {
      session_id = "{{ args.session_id }}"
      headless   = true
      steps = [
        { action = "navigate",   url      = "{{ args.url }}" },
        { action = "fill",       selector = "{{ args.email_selector }}",    text = "{{ args.email }}" },
        { action = "fill",       selector = "{{ args.password_selector }}", text = "{{ secrets['site.password'] }}" },
        { action = "click",      selector = "{{ args.submit_selector }}" },
        { action = "wait_for",   timeout_ms = 5000, text = "" },
        { action = "snapshot" },
      ]
    }
  }

  result {
    decode = "json"
    output = "Logged in. Page state:\n{{ result.text | truncate(500) }}"
  }
}