How to heal a broken seam

heal belongs to Unsurf’s reusable-seam path. It is what keeps worker useful after a website changes.

Flow

worker fails
   ↓
heal retries
   ↓
re-scout if needed
   ↓
return a repaired path

Call heal

curl -X POST https://unsurf-api.coey.dev/tools/heal \
  -H "Content-Type: application/json" \
  -d '{
    "pathId": "path_lx1a_q7z2",
    "error": "GET /api/v1/users returned 404"
  }'

{
  "healed": true,
  "newPathId": "path_mx2b_r8a1"
}

What heal does

retries the original replay path,
marks it broken if the failure persists,
scouts the original site/task again,
verifies the replacement,
returns the new path.

When to use it

Situation	Use
A direct replay path drifted	`heal`
The browser task itself changed visually	update the browser plan or loop spec
The user-session task is still browser-native	stay on local browser MCP