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.
- 01Ivy NodeFetch the pageivy.node.web-page-text
Fetches a web page and returns its readable text and title, without scripts, styles or markup.
- takes
urlfrom the agent's input
- 02Ivy NodeCompare with last timeivy.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
keyfrom the agent's input,watch_keytextfrom step 1- returns
changed,first_run,diff
- 03BranchOnly when the text changed
Lets what follows run only when changed of step 2 is true.
- 04Ivy NodeDoes 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
statefrom step 2,diff- set
instructionsAnswer 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_keythe stored secret jev-api-key- returns
matters
- 05BranchOnly when it matters
Lets what follows run only when answer of step 4 is true.
- 06Ivy NodeMail the changeivy.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
bodyfrom step 2,diffsubjectfrom the agent's inputfrom_addrfrom the agent's input,usernameusernamefrom the agent's inputtofrom the agent's inputsmtp_hostfrom the agent's inputsmtp_portfrom the agent's inputuse_tlsfrom the agent's input,smtp_tls- set
smtp_hostsmtp.gmail.comsmtp_port587use_tlstruesubjectWeb page change detected- secret
passwordthe stored secret mail-password- returns
sent
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.
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
| Field | Type | Description |
|---|---|---|
| urlrequired | string | The page's address. |
| watch_keyrequired | string | A name for what is watched, such as the page's address; the last text is kept under it in .punica/ivy-state. |
| usernamerequired | string | The sending address, which is the login name; its password is the stored secret mail-password. |
| torequired | string | Where to send it. |
| subject | string | The subject line. |
| smtp_host | string | The SMTP server; smtp.gmail.com when left out. |
| smtp_port | integer | The SMTP port; 587 when left out. |
| smtp_tls | boolean | Upgrade SMTP with STARTTLS; on when left out. |
Outputs
| Field | Type | Description |
|---|---|---|
| changed | boolean | True when the text differs from last time. |
| first_run | boolean | True when nothing had been stored under the watch key. |
| matters | boolean | True when Jev judged the change matters; absent when nothing changed. |
| diff | string | The added lines with '+ ' and the removed ones with '- '. |
| sent | boolean | True 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_host127.0.0.1smtp_port3025smtp_tlsfalseurlhttp://127.0.0.1:18900/status.htmlwatch_keyacme-statususernameagent@ivyx.testtoagent@ivyx.test- expects
changedequals falsefirst_runequals true
- outage
The page now reports an outage: the change matters and is mailed.
- given
smtp_host127.0.0.1smtp_port3025smtp_tlsfalseurlhttp://127.0.0.1:18900/status-changed.htmlwatch_keyacme-statususernameagent@ivyx.testtoagent@ivyx.test- expects
changedequals truefirst_runequals falsemattersequals truesentequals truediffmatches outage