Yonatan
f74924cd0c
* feat(skills): Add hierarchical structure with references and templates Adds modular documentation and executable templates to the agent-browser skill for better AI agent consumption and progressive disclosure. ## Added ### References (deep-dive documentation) - `references/snapshot-refs.md` - Ref lifecycle, invalidation, troubleshooting - `references/session-management.md` - Parallel sessions, state persistence - `references/authentication.md` - Login flows, OAuth, 2FA patterns - `references/video-recording.md` - Recording for debugging/docs - `references/proxy-support.md` - Proxy configuration, geo-testing ### Templates (ready-to-use workflows) - `templates/form-automation.sh` - Form filling with validation - `templates/authenticated-session.sh` - Login once, reuse state - `templates/capture-workflow.sh` - Content extraction with screenshots ## Modified - `SKILL.md` - Added reference tables linking to new documentation ## Benefits - Progressive disclosure: Load overview first, deep dives on demand - Reduced context: Smaller chunks for better LLM token efficiency - Ready workflows: Copy-paste templates for common patterns * fix(templates): Make authenticated-session.sh runnable out-of-box Addresses review feedback: login actions were commented but verification wasn't, causing script to fail when run as-is. New approach: - DISCOVERY MODE runs first (shows form structure) - LOGIN FLOW section is fully commented as a unit - User runs once to see refs, then customizes ┌─────────────────────────────────────────────────────────────┐ │ LOGIN FORM STRUCTURE │ ├─────────────────────────────────────────────────────────────┤ │ @e1 [input type="email"] │ │ @e2 [input type="password"] │ │ @e3 [button] "Sign In" │ └─────────────────────────────────────────────────────────────┘
92 lines
4.1 KiB
Bash
Executable File
92 lines
4.1 KiB
Bash
Executable File
#!/bin/bash
|
|
# Template: Authenticated Session Workflow
|
|
# Login once, save state, reuse for subsequent runs
|
|
#
|
|
# Usage:
|
|
# ./authenticated-session.sh <login-url> [state-file]
|
|
#
|
|
# Setup:
|
|
# 1. Run once to see your form structure
|
|
# 2. Note the @refs for your fields
|
|
# 3. Uncomment LOGIN FLOW section and update refs
|
|
|
|
set -euo pipefail
|
|
|
|
LOGIN_URL="${1:?Usage: $0 <login-url> [state-file]}"
|
|
STATE_FILE="${2:-./auth-state.json}"
|
|
|
|
echo "Authentication workflow for: $LOGIN_URL"
|
|
|
|
# ══════════════════════════════════════════════════════════════
|
|
# SAVED STATE: Skip login if we have valid saved state
|
|
# ══════════════════════════════════════════════════════════════
|
|
if [[ -f "$STATE_FILE" ]]; then
|
|
echo "Loading saved authentication state..."
|
|
agent-browser state load "$STATE_FILE"
|
|
agent-browser open "$LOGIN_URL"
|
|
agent-browser wait --load networkidle
|
|
|
|
CURRENT_URL=$(agent-browser get url)
|
|
if [[ "$CURRENT_URL" != *"login"* ]] && [[ "$CURRENT_URL" != *"signin"* ]]; then
|
|
echo "Session restored successfully!"
|
|
agent-browser snapshot -i
|
|
exit 0
|
|
fi
|
|
echo "Session expired, performing fresh login..."
|
|
rm -f "$STATE_FILE"
|
|
fi
|
|
|
|
# ══════════════════════════════════════════════════════════════
|
|
# DISCOVERY MODE: Show form structure (remove after setup)
|
|
# ══════════════════════════════════════════════════════════════
|
|
echo "Opening login page..."
|
|
agent-browser open "$LOGIN_URL"
|
|
agent-browser wait --load networkidle
|
|
|
|
echo ""
|
|
echo "┌─────────────────────────────────────────────────────────┐"
|
|
echo "│ LOGIN FORM STRUCTURE │"
|
|
echo "├─────────────────────────────────────────────────────────┤"
|
|
agent-browser snapshot -i
|
|
echo "└─────────────────────────────────────────────────────────┘"
|
|
echo ""
|
|
echo "Next steps:"
|
|
echo " 1. Note refs: @e? = username, @e? = password, @e? = submit"
|
|
echo " 2. Uncomment LOGIN FLOW section below"
|
|
echo " 3. Replace @e1, @e2, @e3 with your refs"
|
|
echo " 4. Delete this DISCOVERY MODE section"
|
|
echo ""
|
|
agent-browser close
|
|
exit 0
|
|
|
|
# ══════════════════════════════════════════════════════════════
|
|
# LOGIN FLOW: Uncomment and customize after discovery
|
|
# ══════════════════════════════════════════════════════════════
|
|
# : "${APP_USERNAME:?Set APP_USERNAME environment variable}"
|
|
# : "${APP_PASSWORD:?Set APP_PASSWORD environment variable}"
|
|
#
|
|
# agent-browser open "$LOGIN_URL"
|
|
# agent-browser wait --load networkidle
|
|
# agent-browser snapshot -i
|
|
#
|
|
# # Fill credentials (update refs to match your form)
|
|
# agent-browser fill @e1 "$APP_USERNAME"
|
|
# agent-browser fill @e2 "$APP_PASSWORD"
|
|
# agent-browser click @e3
|
|
# agent-browser wait --load networkidle
|
|
#
|
|
# # Verify login succeeded
|
|
# FINAL_URL=$(agent-browser get url)
|
|
# if [[ "$FINAL_URL" == *"login"* ]] || [[ "$FINAL_URL" == *"signin"* ]]; then
|
|
# echo "ERROR: Login failed - still on login page"
|
|
# agent-browser screenshot /tmp/login-failed.png
|
|
# agent-browser close
|
|
# exit 1
|
|
# fi
|
|
#
|
|
# # Save state for future runs
|
|
# echo "Saving authentication state to: $STATE_FILE"
|
|
# agent-browser state save "$STATE_FILE"
|
|
# echo "Login successful!"
|
|
# agent-browser snapshot -i
|