{"id":"dom-recipe-match","title":"Check whether a saved interaction recipe still applies to the current version of a page","description":"Compares a recipe (ordered steps naming selectors from an earlier dom-skeleton call), the saved skeleton elements those selectors came from, and the current page HTML. Per step it reports matched (same selector, same tag, type, role and name), changed (selector still exists but the element differs), moved (the same element now has a different selector, given as newSelector), ambiguous (several current elements look the same) or missing. Static HTML only, no scripts run. It does not execute the recipe or judge whether a step's action still makes sense, and a step whose selector is not in the saved skeleton is unknown.","roi":"Tells an agent whether to replay a stored web recipe or re-plan. 100 steps per $0.005 call.","audience":"agent-infra","package":"context-evidence-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/dom-recipe-match","path":"/api/v1/dom-recipe-match","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["recipe","saved","html"],"properties":{"recipe":{"type":"object","additionalProperties":false,"properties":{"steps":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"selector":{"type":"string","maxLength":500,"minLength":1,"description":"A selector from the saved skeleton."},"action":{"type":"string","maxLength":100,"description":"Free-form label, echoed back."}},"required":["selector"]},"maxItems":100,"minItems":1}},"required":["steps"]},"saved":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tag":{"type":"string"},"type":{"type":"string"},"role":{"type":"string"},"name":{"type":"string","description":"Best-effort accessible name (aria-label, aria-labelledby, label, text, placeholder, title, alt, value), at most 80 characters."},"nameSource":{"type":"string"},"selector":{"type":"string","description":"CSS selector that matches exactly this element in the supplied HTML."},"selectorKind":{"type":"string","enum":["id","data-testid","name","aria-label","path"]},"href":{"type":"string"},"disabled":{"type":"boolean"},"required":{"type":"boolean"},"repeats":{"type":"integer","description":"Elements with the same tag, type, role, name and href collapsed into this one (the first)."}}},"maxItems":300,"minItems":1,"description":"elements from an earlier dom-skeleton response."},"html":{"type":"string","maxLength":100000,"minLength":1,"description":"Current page HTML."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"steps":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"index":{"type":"integer"},"selector":{"type":"string"},"action":{"type":"string"},"verdict":{"type":"string","enum":["matched","changed","moved","ambiguous","missing","unknown"]},"newSelector":{"type":"string"},"differences":{"type":"array","items":{"type":"string"},"maxItems":6}}},"maxItems":100},"currentElements":{"type":"integer"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"steps":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"index":{"type":"integer"},"selector":{"type":"string"},"action":{"type":"string"},"verdict":{"type":"string","enum":["matched","changed","moved","ambiguous","missing","unknown"]},"newSelector":{"type":"string"},"differences":{"type":"array","items":{"type":"string"},"maxItems":6}}},"maxItems":100},"currentElements":{"type":"integer"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"recipe":{"steps":[{"selector":"#u","action":"type"},{"selector":"button[type=submit]","action":"click"}]},"saved":[{"tag":"input","selector":"#u","selectorKind":"id","name":"User"}],"html":"<form><label for=\"u\">User</label><input id=\"u\"></form>"},"openapiOperation":{"operationId":"dom_recipe_match","summary":"Check whether a saved interaction recipe still applies to the current version of a page","description":"Compares a recipe (ordered steps naming selectors from an earlier dom-skeleton call), the saved skeleton elements those selectors came from, and the current page HTML. Per step it reports matched (same selector, same tag, type, role and name), changed (selector still exists but the element differs), moved (the same element now has a different selector, given as newSelector), ambiguous (several current elements look the same) or missing. Static HTML only, no scripts run. It does not execute the recipe or judge whether a step's action still makes sense, and a step whose selector is not in the saved skeleton is unknown.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"agent-infra","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/dom-recipe-match","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recipe","saved","html"],"properties":{"recipe":{"type":"object","additionalProperties":false,"properties":{"steps":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"selector":{"type":"string","maxLength":500,"minLength":1,"description":"A selector from the saved skeleton."},"action":{"type":"string","maxLength":100,"description":"Free-form label, echoed back."}},"required":["selector"]},"maxItems":100,"minItems":1}},"required":["steps"]},"saved":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tag":{"type":"string"},"type":{"type":"string"},"role":{"type":"string"},"name":{"type":"string","description":"Best-effort accessible name (aria-label, aria-labelledby, label, text, placeholder, title, alt, value), at most 80 characters."},"nameSource":{"type":"string"},"selector":{"type":"string","description":"CSS selector that matches exactly this element in the supplied HTML."},"selectorKind":{"type":"string","enum":["id","data-testid","name","aria-label","path"]},"href":{"type":"string"},"disabled":{"type":"boolean"},"required":{"type":"boolean"},"repeats":{"type":"integer","description":"Elements with the same tag, type, role, name and href collapsed into this one (the first)."}}},"maxItems":300,"minItems":1,"description":"elements from an earlier dom-skeleton response."},"html":{"type":"string","maxLength":100000,"minLength":1,"description":"Current page HTML."}}},"example":{"recipe":{"steps":[{"selector":"#u","action":"type"},{"selector":"button[type=submit]","action":"click"}]},"saved":[{"tag":"input","selector":"#u","selectorKind":"id","name":"User"}],"html":"<form><label for=\"u\">User</label><input id=\"u\"></form>"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"steps":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"index":{"type":"integer"},"selector":{"type":"string"},"action":{"type":"string"},"verdict":{"type":"string","enum":["matched","changed","moved","ambiguous","missing","unknown"]},"newSelector":{"type":"string"},"differences":{"type":"array","items":{"type":"string"},"maxItems":6}}},"maxItems":100},"currentElements":{"type":"integer"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/dom-recipe-match/","docsJson":"https://agents.writerslogic.com/docs/dom-recipe-match.json","sample":"https://agents.writerslogic.com/api/v1/samples/dom-recipe-match","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}