more business logic

agent_docs/common-issues/execution-timeout.md

@@ -0,0 +1,18 @@
+# Agent Routine Execution Timeout
+
+**Symptom:** Routine execution times out or fails after extended run time
+
+**Possible Causes:**
+
+1. **Long-running routine** - Routine takes 3+ minutes to complete
+2. **Network traffic issues** - Connectivity problems with the Chrome deployment server
+3. **Bad JS evaluation** - JavaScript code stuck in infinite loop or taking too long to execute
+
+**Solutions:**
+
+1. **Run again** - Transient network issues often resolve on retry
+2. **Optimize routine** - Break long routines into smaller parts, reduce unnecessary sleeps
+3. **Check JS code** - Ensure js_evaluate operations don't have infinite loops or expensive computations
+4. **Verify network** - Check connectivity to the Chrome deployment server
+
+**Still stuck?** Consider reaching out to the Vectorly support team for assistance.

agent_docs/debugging.md

@@ -35,6 +35,7 @@ for op in result.operations_metadata:
 | Placeholder not resolved | [placeholder-not-resolved.md](common-issues/placeholder-not-resolved.md) |
 | Click/input fails | [element-not-found.md](common-issues/element-not-found.md) |
 | Fetch returns HTML | [fetch-returns-html.md](common-issues/fetch-returns-html.md) |
+| Routine execution timeout | [execution-timeout.md](common-issues/execution-timeout.md) |
 
 ---
 

example_routines/massachusetts_corp_search_routine.json

@@ -104,5 +104,4 @@
       "session_storage_key": "corp_search_results"
     }
   ]
-}
-
+}

pyproject.toml

@@ -47,6 +47,7 @@ dependencies = [
     "beautifulsoup4>=4.14.2",
     "pylint>=3.0.0",
     "pytest>=8.3.5",
+    "rich>=13.0.0",
 ]
 
 [project.optional-dependencies]