← All ivy-agents
IVYXSTUDIO · IVY AGENT
W

Web Page Change Monitor

ivy.agent.page-change-materiality · v1.1.0

ivyx

Fetches a web page, compares its text with the last run's under the watch key, has Jev judge whether what changed matters to a customer, and mails the change when it does.

Steps

In the order the agent's file lists them, each with where its inputs come from and the values the file fixes. A branch or a loop is a step too.

  1. 01
    Fetch the page
    ivy.node.web-page-text

    Fetches a web page and returns its readable text and title, without scripts, styles or markup.

    takes
    url from the agent's input
    Ivy Node
  2. 02
    Compare with last time
    ivy.node.text-change-detect

    Compares a text with the one stored under the same key last time, stores the new one, and returns whether it changed with the lines added and removed.

    takes
    key from the agent's input, watch_key
    text from step 1
    returns
    changed, first_run, diff
    Ivy Node
  3. 03
    Only when the text changed

    Lets what follows run only when changed of step 2 is true.

    Branch
  4. 04
    Does the change matter?
    ivy.node.jev-noul

    Asks TypeSafe Jev a yes-or-no question about a text or JSON state and returns noul, the probability that the answer is yes, with answer true when it reaches the threshold.

    Runs only on the then branch of step 3.

    takes
    state from step 2, diff
    set
    instructions Answer yes or no whether this change to a web page matters to a customer (an outage, a price or a deadline, not wordi...
    secret
    jev_api_key the stored secret jev-api-key
    returns
    matters
    Ivy Node
  5. 05
    Only when it matters

    Lets what follows run only when answer of step 4 is true.

    Branch
  6. 06
    Mail the change
    ivy.node.email-send

    Sends a plain-text or HTML email through an SMTP server in one step and returns the recipients it went to.

    Runs only on the then branch of step 5.

    takes
    body from step 2, diff
    subject from the agent's input
    from_addr from the agent's input, username
    username from the agent's input
    to from the agent's input
    smtp_host from the agent's input
    smtp_port from the agent's input
    use_tls from the agent's input, smtp_tls
    set
    smtp_host smtp.gmail.com
    smtp_port 587
    use_tls true
    subject Web page change detected
    secret
    password the stored secret mail-password
    returns
    sent
    Ivy Node

Nodes it brings

Adding this agent in IVYX Studio adds these nodes with it. A node your workspace already has is kept as it is, even at another version.

What it touches

Collected from what each of its nodes declares and what the agent's own file declares, such as moving a robot, plus the model call when a step is a model turn. A declaration is the author's statement, and it is what policy rules select on.

Writes filesmessage-sendNetwork

What it needs

  • A stored secret named jev-api-key. The agent's file carries the name, never the value.
  • A stored secret named mail-password. The agent's file carries the name, never the value.

Inputs

FieldTypeDescription
urlrequiredstringThe page's address.
watch_keyrequiredstringA name for what is watched, such as the page's address; the last text is kept under it in .punica/ivy-state.
usernamerequiredstringThe sending address, which is the login name; its password is the stored secret mail-password.
torequiredstringWhere to send it.
subjectstringThe subject line.
smtp_hoststringThe SMTP server; smtp.gmail.com when left out.
smtp_portintegerThe SMTP port; 587 when left out.
smtp_tlsbooleanUpgrade SMTP with STARTTLS; on when left out.

Outputs

FieldTypeDescription
changedbooleanTrue when the text differs from last time.
first_runbooleanTrue when nothing had been stored under the watch key.
mattersbooleanTrue when Jev judged the change matters; absent when nothing changed.
diffstringThe added lines with '+ ' and the removed ones with '- '.
sentbooleanTrue once the server accepted the mail; absent when nothing was sent.

Tests

2 of 2 test cases passed on Oct 7, 2026, in the publisher's own environment, before this version was published. The registry keeps that record; it does not run the cases again.

Requires: python:3.9, the stored secret jev-api-key, an SMTP server (Gmail unless smtp_host says otherwise) with the sending account's password stored as the secret mail-password, for the cases, GreenMail on 127.0.0.1:3025 (mkdata-mail.py), the test pages served on 127.0.0.1:18900 (python3 -m http.server in data/site), nothing stored under the watch key before the first case (.punica/ivy-state removed)

  • first-sighting

    The first run stores the page and mails nothing.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    url http://127.0.0.1:18900/status.html
    watch_key acme-status
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    changed equals false
    first_run equals true
  • outage

    The page now reports an outage: the change matters and is mailed.

    given
    smtp_host 127.0.0.1
    smtp_port 3025
    smtp_tls false
    url http://127.0.0.1:18900/status-changed.html
    watch_key acme-status
    username agent@ivyx.test
    to agent@ivyx.test
    expects
    changed equals true
    first_run equals false
    matters equals true
    sent equals true
    diff matches outage