aidevops 2.52.1 → 2.53.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/README.md +1 -1
  2. package/VERSION +1 -1
  3. package/aidevops.sh +15 -9
  4. package/package.json +4 -4
  5. package/scripts/npm-postinstall.js +6 -7
  6. package/setup.sh +1 -1
  7. package/templates/deploy-templates.sh +144 -0
  8. package/templates/home/.agent/README.md +33 -0
  9. package/templates/home/AGENTS.md +96 -0
  10. package/templates/home/git/.agent/README.md +48 -0
  11. package/templates/home/git/AGENTS.md +97 -0
  12. package/templates/standard-functions.sh +179 -0
  13. package/templates/wordpress-performance-workflow.md +217 -0
  14. package/.agent/AGENTS.md +0 -614
  15. package/.agent/accounts.md +0 -65
  16. package/.agent/aidevops/add-new-mcp-to-aidevops.md +0 -456
  17. package/.agent/aidevops/api-integrations.md +0 -335
  18. package/.agent/aidevops/architecture.md +0 -510
  19. package/.agent/aidevops/configs.md +0 -274
  20. package/.agent/aidevops/docs.md +0 -244
  21. package/.agent/aidevops/extension.md +0 -311
  22. package/.agent/aidevops/mcp-integrations.md +0 -340
  23. package/.agent/aidevops/mcp-troubleshooting.md +0 -162
  24. package/.agent/aidevops/memory-patterns.md +0 -172
  25. package/.agent/aidevops/providers.md +0 -217
  26. package/.agent/aidevops/recommendations.md +0 -321
  27. package/.agent/aidevops/requirements.md +0 -301
  28. package/.agent/aidevops/resources.md +0 -214
  29. package/.agent/aidevops/security-requirements.md +0 -174
  30. package/.agent/aidevops/security.md +0 -350
  31. package/.agent/aidevops/service-links.md +0 -400
  32. package/.agent/aidevops/services.md +0 -357
  33. package/.agent/aidevops/setup.md +0 -153
  34. package/.agent/aidevops/troubleshooting.md +0 -389
  35. package/.agent/aidevops.md +0 -124
  36. package/.agent/build-plus.md +0 -244
  37. package/.agent/content/guidelines.md +0 -109
  38. package/.agent/content.md +0 -87
  39. package/.agent/health.md +0 -59
  40. package/.agent/legal.md +0 -59
  41. package/.agent/loop-state/full-loop.local.md +0 -16
  42. package/.agent/loop-state/ralph-loop.local.md +0 -10
  43. package/.agent/marketing.md +0 -440
  44. package/.agent/memory/README.md +0 -260
  45. package/.agent/onboarding.md +0 -796
  46. package/.agent/plan-plus.md +0 -245
  47. package/.agent/research.md +0 -100
  48. package/.agent/sales.md +0 -333
  49. package/.agent/scripts/101domains-helper.sh +0 -701
  50. package/.agent/scripts/add-missing-returns.sh +0 -140
  51. package/.agent/scripts/agent-browser-helper.sh +0 -311
  52. package/.agent/scripts/agno-setup.sh +0 -712
  53. package/.agent/scripts/ahrefs-mcp-wrapper.js +0 -168
  54. package/.agent/scripts/aidevops-update-check.sh +0 -71
  55. package/.agent/scripts/ampcode-cli.sh +0 -522
  56. package/.agent/scripts/auto-version-bump.sh +0 -156
  57. package/.agent/scripts/autogen-helper.sh +0 -512
  58. package/.agent/scripts/beads-sync-helper.sh +0 -596
  59. package/.agent/scripts/closte-helper.sh +0 -5
  60. package/.agent/scripts/cloudron-helper.sh +0 -321
  61. package/.agent/scripts/codacy-cli-chunked.sh +0 -581
  62. package/.agent/scripts/codacy-cli.sh +0 -442
  63. package/.agent/scripts/code-audit-helper.sh +0 -5
  64. package/.agent/scripts/coderabbit-cli.sh +0 -417
  65. package/.agent/scripts/coderabbit-pro-analysis.sh +0 -238
  66. package/.agent/scripts/commands/code-simplifier.md +0 -86
  67. package/.agent/scripts/commands/full-loop.md +0 -246
  68. package/.agent/scripts/commands/postflight-loop.md +0 -103
  69. package/.agent/scripts/commands/recall.md +0 -182
  70. package/.agent/scripts/commands/remember.md +0 -132
  71. package/.agent/scripts/commands/save-todo.md +0 -175
  72. package/.agent/scripts/commands/session-review.md +0 -154
  73. package/.agent/scripts/comprehensive-quality-fix.sh +0 -106
  74. package/.agent/scripts/context-builder-helper.sh +0 -522
  75. package/.agent/scripts/coolify-cli-helper.sh +0 -674
  76. package/.agent/scripts/coolify-helper.sh +0 -380
  77. package/.agent/scripts/crawl4ai-examples.sh +0 -401
  78. package/.agent/scripts/crawl4ai-helper.sh +0 -1078
  79. package/.agent/scripts/crewai-helper.sh +0 -681
  80. package/.agent/scripts/dev-browser-helper.sh +0 -513
  81. package/.agent/scripts/dns-helper.sh +0 -396
  82. package/.agent/scripts/domain-research-helper.sh +0 -917
  83. package/.agent/scripts/dspy-helper.sh +0 -285
  84. package/.agent/scripts/dspyground-helper.sh +0 -291
  85. package/.agent/scripts/eeat-score-helper.sh +0 -1242
  86. package/.agent/scripts/efficient-return-fix.sh +0 -92
  87. package/.agent/scripts/extract-opencode-prompts.sh +0 -128
  88. package/.agent/scripts/find-missing-returns.sh +0 -113
  89. package/.agent/scripts/fix-auth-headers.sh +0 -104
  90. package/.agent/scripts/fix-common-strings.sh +0 -254
  91. package/.agent/scripts/fix-content-type.sh +0 -100
  92. package/.agent/scripts/fix-error-messages.sh +0 -130
  93. package/.agent/scripts/fix-misplaced-returns.sh +0 -74
  94. package/.agent/scripts/fix-remaining-literals.sh +0 -152
  95. package/.agent/scripts/fix-return-statements.sh +0 -41
  96. package/.agent/scripts/fix-s131-default-cases.sh +0 -249
  97. package/.agent/scripts/fix-sc2155-simple.sh +0 -102
  98. package/.agent/scripts/fix-shellcheck-critical.sh +0 -187
  99. package/.agent/scripts/fix-string-literals.sh +0 -273
  100. package/.agent/scripts/full-loop-helper.sh +0 -773
  101. package/.agent/scripts/generate-opencode-agents.sh +0 -497
  102. package/.agent/scripts/generate-opencode-commands.sh +0 -1629
  103. package/.agent/scripts/generate-skills.sh +0 -366
  104. package/.agent/scripts/git-platforms-helper.sh +0 -640
  105. package/.agent/scripts/gitea-cli-helper.sh +0 -743
  106. package/.agent/scripts/github-cli-helper.sh +0 -702
  107. package/.agent/scripts/gitlab-cli-helper.sh +0 -682
  108. package/.agent/scripts/gsc-add-user-helper.sh +0 -325
  109. package/.agent/scripts/gsc-sitemap-helper.sh +0 -678
  110. package/.agent/scripts/hetzner-helper.sh +0 -485
  111. package/.agent/scripts/hostinger-helper.sh +0 -229
  112. package/.agent/scripts/keyword-research-helper.sh +0 -1815
  113. package/.agent/scripts/langflow-helper.sh +0 -544
  114. package/.agent/scripts/linkedin-automation.py +0 -241
  115. package/.agent/scripts/linter-manager.sh +0 -599
  116. package/.agent/scripts/linters-local.sh +0 -434
  117. package/.agent/scripts/list-keys-helper.sh +0 -488
  118. package/.agent/scripts/local-browser-automation.py +0 -339
  119. package/.agent/scripts/localhost-helper.sh +0 -744
  120. package/.agent/scripts/loop-common.sh +0 -806
  121. package/.agent/scripts/mainwp-helper.sh +0 -728
  122. package/.agent/scripts/markdown-formatter.sh +0 -338
  123. package/.agent/scripts/markdown-lint-fix.sh +0 -311
  124. package/.agent/scripts/mass-fix-returns.sh +0 -58
  125. package/.agent/scripts/mcp-diagnose.sh +0 -167
  126. package/.agent/scripts/mcp-inspector-helper.sh +0 -449
  127. package/.agent/scripts/memory-helper.sh +0 -650
  128. package/.agent/scripts/monitor-code-review.sh +0 -255
  129. package/.agent/scripts/onboarding-helper.sh +0 -706
  130. package/.agent/scripts/opencode-github-setup-helper.sh +0 -797
  131. package/.agent/scripts/opencode-test-helper.sh +0 -213
  132. package/.agent/scripts/pagespeed-helper.sh +0 -464
  133. package/.agent/scripts/pandoc-helper.sh +0 -362
  134. package/.agent/scripts/postflight-check.sh +0 -555
  135. package/.agent/scripts/pre-commit-hook.sh +0 -259
  136. package/.agent/scripts/pre-edit-check.sh +0 -169
  137. package/.agent/scripts/qlty-cli.sh +0 -356
  138. package/.agent/scripts/quality-cli-manager.sh +0 -525
  139. package/.agent/scripts/quality-feedback-helper.sh +0 -462
  140. package/.agent/scripts/quality-fix.sh +0 -263
  141. package/.agent/scripts/quality-loop-helper.sh +0 -1108
  142. package/.agent/scripts/ralph-loop-helper.sh +0 -836
  143. package/.agent/scripts/ralph-upstream-check.sh +0 -341
  144. package/.agent/scripts/secretlint-helper.sh +0 -847
  145. package/.agent/scripts/servers-helper.sh +0 -241
  146. package/.agent/scripts/ses-helper.sh +0 -619
  147. package/.agent/scripts/session-review-helper.sh +0 -404
  148. package/.agent/scripts/setup-linters-wizard.sh +0 -379
  149. package/.agent/scripts/setup-local-api-keys.sh +0 -330
  150. package/.agent/scripts/setup-mcp-integrations.sh +0 -472
  151. package/.agent/scripts/shared-constants.sh +0 -246
  152. package/.agent/scripts/site-crawler-helper.sh +0 -1487
  153. package/.agent/scripts/snyk-helper.sh +0 -940
  154. package/.agent/scripts/sonarcloud-autofix.sh +0 -193
  155. package/.agent/scripts/sonarcloud-cli.sh +0 -191
  156. package/.agent/scripts/sonarscanner-cli.sh +0 -455
  157. package/.agent/scripts/spaceship-helper.sh +0 -747
  158. package/.agent/scripts/stagehand-helper.sh +0 -321
  159. package/.agent/scripts/stagehand-python-helper.sh +0 -321
  160. package/.agent/scripts/stagehand-python-setup.sh +0 -441
  161. package/.agent/scripts/stagehand-setup.sh +0 -439
  162. package/.agent/scripts/system-cleanup.sh +0 -340
  163. package/.agent/scripts/terminal-title-helper.sh +0 -388
  164. package/.agent/scripts/terminal-title-setup.sh +0 -549
  165. package/.agent/scripts/test-stagehand-both-integration.sh +0 -317
  166. package/.agent/scripts/test-stagehand-integration.sh +0 -309
  167. package/.agent/scripts/test-stagehand-python-integration.sh +0 -341
  168. package/.agent/scripts/todo-ready.sh +0 -263
  169. package/.agent/scripts/tool-version-check.sh +0 -362
  170. package/.agent/scripts/toon-helper.sh +0 -469
  171. package/.agent/scripts/twilio-helper.sh +0 -917
  172. package/.agent/scripts/updown-helper.sh +0 -279
  173. package/.agent/scripts/validate-mcp-integrations.sh +0 -250
  174. package/.agent/scripts/validate-version-consistency.sh +0 -131
  175. package/.agent/scripts/vaultwarden-helper.sh +0 -597
  176. package/.agent/scripts/vercel-cli-helper.sh +0 -816
  177. package/.agent/scripts/verify-mirrors.sh +0 -169
  178. package/.agent/scripts/version-manager.sh +0 -831
  179. package/.agent/scripts/webhosting-helper.sh +0 -471
  180. package/.agent/scripts/webhosting-verify.sh +0 -238
  181. package/.agent/scripts/wordpress-mcp-helper.sh +0 -508
  182. package/.agent/scripts/worktree-helper.sh +0 -595
  183. package/.agent/scripts/worktree-sessions.sh +0 -577
  184. package/.agent/seo/dataforseo.md +0 -215
  185. package/.agent/seo/domain-research.md +0 -532
  186. package/.agent/seo/eeat-score.md +0 -659
  187. package/.agent/seo/google-search-console.md +0 -366
  188. package/.agent/seo/gsc-sitemaps.md +0 -282
  189. package/.agent/seo/keyword-research.md +0 -521
  190. package/.agent/seo/serper.md +0 -278
  191. package/.agent/seo/site-crawler.md +0 -387
  192. package/.agent/seo.md +0 -236
  193. package/.agent/services/accounting/quickfile.md +0 -159
  194. package/.agent/services/communications/telfon.md +0 -470
  195. package/.agent/services/communications/twilio.md +0 -569
  196. package/.agent/services/crm/fluentcrm.md +0 -449
  197. package/.agent/services/email/ses.md +0 -399
  198. package/.agent/services/hosting/101domains.md +0 -378
  199. package/.agent/services/hosting/closte.md +0 -177
  200. package/.agent/services/hosting/cloudflare.md +0 -251
  201. package/.agent/services/hosting/cloudron.md +0 -478
  202. package/.agent/services/hosting/dns-providers.md +0 -335
  203. package/.agent/services/hosting/domain-purchasing.md +0 -344
  204. package/.agent/services/hosting/hetzner.md +0 -327
  205. package/.agent/services/hosting/hostinger.md +0 -287
  206. package/.agent/services/hosting/localhost.md +0 -419
  207. package/.agent/services/hosting/spaceship.md +0 -353
  208. package/.agent/services/hosting/webhosting.md +0 -330
  209. package/.agent/social-media.md +0 -69
  210. package/.agent/templates/plans-template.md +0 -114
  211. package/.agent/templates/prd-template.md +0 -129
  212. package/.agent/templates/tasks-template.md +0 -108
  213. package/.agent/templates/todo-template.md +0 -89
  214. package/.agent/tools/ai-assistants/agno.md +0 -471
  215. package/.agent/tools/ai-assistants/capsolver.md +0 -326
  216. package/.agent/tools/ai-assistants/configuration.md +0 -221
  217. package/.agent/tools/ai-assistants/overview.md +0 -209
  218. package/.agent/tools/ai-assistants/status.md +0 -171
  219. package/.agent/tools/ai-assistants/windsurf.md +0 -193
  220. package/.agent/tools/ai-orchestration/autogen.md +0 -406
  221. package/.agent/tools/ai-orchestration/crewai.md +0 -445
  222. package/.agent/tools/ai-orchestration/langflow.md +0 -405
  223. package/.agent/tools/ai-orchestration/openprose.md +0 -487
  224. package/.agent/tools/ai-orchestration/overview.md +0 -362
  225. package/.agent/tools/ai-orchestration/packaging.md +0 -647
  226. package/.agent/tools/browser/agent-browser.md +0 -464
  227. package/.agent/tools/browser/browser-automation.md +0 -400
  228. package/.agent/tools/browser/chrome-devtools.md +0 -282
  229. package/.agent/tools/browser/crawl4ai-integration.md +0 -422
  230. package/.agent/tools/browser/crawl4ai-resources.md +0 -277
  231. package/.agent/tools/browser/crawl4ai-usage.md +0 -416
  232. package/.agent/tools/browser/crawl4ai.md +0 -585
  233. package/.agent/tools/browser/dev-browser.md +0 -341
  234. package/.agent/tools/browser/pagespeed.md +0 -260
  235. package/.agent/tools/browser/playwright.md +0 -266
  236. package/.agent/tools/browser/playwriter.md +0 -310
  237. package/.agent/tools/browser/stagehand-examples.md +0 -456
  238. package/.agent/tools/browser/stagehand-python.md +0 -483
  239. package/.agent/tools/browser/stagehand.md +0 -421
  240. package/.agent/tools/build-agent/agent-review.md +0 -224
  241. package/.agent/tools/build-agent/build-agent.md +0 -784
  242. package/.agent/tools/build-mcp/aidevops-plugin.md +0 -476
  243. package/.agent/tools/build-mcp/api-wrapper.md +0 -445
  244. package/.agent/tools/build-mcp/build-mcp.md +0 -240
  245. package/.agent/tools/build-mcp/deployment.md +0 -401
  246. package/.agent/tools/build-mcp/server-patterns.md +0 -632
  247. package/.agent/tools/build-mcp/transports.md +0 -366
  248. package/.agent/tools/code-review/auditing.md +0 -383
  249. package/.agent/tools/code-review/automation.md +0 -219
  250. package/.agent/tools/code-review/best-practices.md +0 -203
  251. package/.agent/tools/code-review/codacy.md +0 -151
  252. package/.agent/tools/code-review/code-simplifier.md +0 -174
  253. package/.agent/tools/code-review/code-standards.md +0 -309
  254. package/.agent/tools/code-review/coderabbit.md +0 -101
  255. package/.agent/tools/code-review/management.md +0 -155
  256. package/.agent/tools/code-review/qlty.md +0 -248
  257. package/.agent/tools/code-review/secretlint.md +0 -565
  258. package/.agent/tools/code-review/setup.md +0 -250
  259. package/.agent/tools/code-review/snyk.md +0 -563
  260. package/.agent/tools/code-review/tools.md +0 -230
  261. package/.agent/tools/content/summarize.md +0 -353
  262. package/.agent/tools/context/augment-context-engine.md +0 -468
  263. package/.agent/tools/context/context-builder-agent.md +0 -76
  264. package/.agent/tools/context/context-builder.md +0 -375
  265. package/.agent/tools/context/context7.md +0 -371
  266. package/.agent/tools/context/dspy.md +0 -302
  267. package/.agent/tools/context/dspyground.md +0 -374
  268. package/.agent/tools/context/llm-tldr.md +0 -219
  269. package/.agent/tools/context/osgrep.md +0 -488
  270. package/.agent/tools/context/prompt-optimization.md +0 -338
  271. package/.agent/tools/context/toon.md +0 -292
  272. package/.agent/tools/conversion/pandoc.md +0 -304
  273. package/.agent/tools/credentials/api-key-management.md +0 -154
  274. package/.agent/tools/credentials/api-key-setup.md +0 -224
  275. package/.agent/tools/credentials/environment-variables.md +0 -180
  276. package/.agent/tools/credentials/vaultwarden.md +0 -382
  277. package/.agent/tools/data-extraction/outscraper.md +0 -974
  278. package/.agent/tools/deployment/coolify-cli.md +0 -388
  279. package/.agent/tools/deployment/coolify-setup.md +0 -353
  280. package/.agent/tools/deployment/coolify.md +0 -345
  281. package/.agent/tools/deployment/vercel.md +0 -390
  282. package/.agent/tools/git/authentication.md +0 -132
  283. package/.agent/tools/git/gitea-cli.md +0 -193
  284. package/.agent/tools/git/github-actions.md +0 -207
  285. package/.agent/tools/git/github-cli.md +0 -223
  286. package/.agent/tools/git/gitlab-cli.md +0 -190
  287. package/.agent/tools/git/opencode-github-security.md +0 -350
  288. package/.agent/tools/git/opencode-github.md +0 -328
  289. package/.agent/tools/git/opencode-gitlab.md +0 -252
  290. package/.agent/tools/git/security.md +0 -196
  291. package/.agent/tools/git.md +0 -207
  292. package/.agent/tools/opencode/oh-my-opencode.md +0 -375
  293. package/.agent/tools/opencode/opencode-anthropic-auth.md +0 -446
  294. package/.agent/tools/opencode/opencode.md +0 -651
  295. package/.agent/tools/social-media/bird.md +0 -437
  296. package/.agent/tools/task-management/beads.md +0 -336
  297. package/.agent/tools/terminal/terminal-title.md +0 -251
  298. package/.agent/tools/ui/shadcn.md +0 -196
  299. package/.agent/tools/ui/ui-skills.md +0 -115
  300. package/.agent/tools/wordpress/localwp.md +0 -311
  301. package/.agent/tools/wordpress/mainwp.md +0 -391
  302. package/.agent/tools/wordpress/scf.md +0 -527
  303. package/.agent/tools/wordpress/wp-admin.md +0 -729
  304. package/.agent/tools/wordpress/wp-dev.md +0 -940
  305. package/.agent/tools/wordpress/wp-preferred.md +0 -398
  306. package/.agent/tools/wordpress.md +0 -95
  307. package/.agent/workflows/branch/bugfix.md +0 -63
  308. package/.agent/workflows/branch/chore.md +0 -95
  309. package/.agent/workflows/branch/experiment.md +0 -115
  310. package/.agent/workflows/branch/feature.md +0 -59
  311. package/.agent/workflows/branch/hotfix.md +0 -98
  312. package/.agent/workflows/branch/refactor.md +0 -92
  313. package/.agent/workflows/branch/release.md +0 -96
  314. package/.agent/workflows/branch.md +0 -347
  315. package/.agent/workflows/bug-fixing.md +0 -267
  316. package/.agent/workflows/changelog.md +0 -129
  317. package/.agent/workflows/code-audit-remote.md +0 -279
  318. package/.agent/workflows/conversation-starter.md +0 -69
  319. package/.agent/workflows/error-feedback.md +0 -578
  320. package/.agent/workflows/feature-development.md +0 -355
  321. package/.agent/workflows/git-workflow.md +0 -702
  322. package/.agent/workflows/multi-repo-workspace.md +0 -268
  323. package/.agent/workflows/plans.md +0 -709
  324. package/.agent/workflows/postflight.md +0 -604
  325. package/.agent/workflows/pr.md +0 -571
  326. package/.agent/workflows/preflight.md +0 -278
  327. package/.agent/workflows/ralph-loop.md +0 -773
  328. package/.agent/workflows/release.md +0 -498
  329. package/.agent/workflows/session-manager.md +0 -254
  330. package/.agent/workflows/session-review.md +0 -311
  331. package/.agent/workflows/sql-migrations.md +0 -631
  332. package/.agent/workflows/version-bump.md +0 -283
  333. package/.agent/workflows/wiki-update.md +0 -333
  334. package/.agent/workflows/worktree.md +0 -477
@@ -1,441 +0,0 @@
1
- #!/bin/bash
2
- # shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
3
-
4
- # Stagehand Python Setup Script for AI DevOps Framework
5
- # Comprehensive setup and configuration for Stagehand Python AI browser automation
6
-
7
- # Source shared constants
8
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
9
- source "${SCRIPT_DIR}/../../.agent/scripts/shared-constants.sh"
10
-
11
- # Colors for output
12
- readonly BLUE='\033[0;34m'
13
- readonly GREEN='\033[0;32m'
14
- readonly YELLOW='\033[1;33m'
15
- readonly RED='\033[0;31m'
16
- readonly NC='\033[0m'
17
-
18
- # Print functions
19
- print_info() {
20
- local msg="$1"
21
- echo -e "${BLUE}[INFO]${NC} $msg"
22
- return 0
23
- }
24
-
25
- print_success() {
26
- local msg="$1"
27
- echo -e "${GREEN}[SUCCESS]${NC} $msg"
28
- return 0
29
- }
30
-
31
- print_warning() {
32
- local msg="$1"
33
- echo -e "${YELLOW}[WARNING]${NC} $msg"
34
- return 0
35
- }
36
-
37
- print_error() {
38
- local msg="$1"
39
- echo -e "${RED}[ERROR]${NC} $msg" >&2
40
- return 0
41
- }
42
-
43
- # Stagehand Python configuration
44
- readonly STAGEHAND_PYTHON_CONFIG_DIR="${HOME}/.aidevops/stagehand-python"
45
- readonly STAGEHAND_PYTHON_EXAMPLES_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/examples"
46
- readonly STAGEHAND_PYTHON_TEMPLATES_DIR="${STAGEHAND_PYTHON_CONFIG_DIR}/templates"
47
-
48
- # Create advanced Python example scripts
49
- create_python_examples() {
50
- print_info "Creating advanced Stagehand Python example scripts..."
51
-
52
- mkdir -p "$STAGEHAND_PYTHON_EXAMPLES_DIR"
53
- mkdir -p "$STAGEHAND_PYTHON_TEMPLATES_DIR"
54
-
55
- # Basic example with Pydantic
56
- cat > "${STAGEHAND_PYTHON_EXAMPLES_DIR}/basic_example.py" << 'EOF'
57
- #!/usr/bin/env python3
58
- """
59
- Basic Stagehand Python Example
60
- Simple example demonstrating core Stagehand Python functionality
61
- """
62
-
63
- import asyncio
64
- import os
65
- from dotenv import load_dotenv
66
- from pydantic import BaseModel, Field
67
-
68
- from stagehand import StagehandConfig, Stagehand
69
-
70
- # Load environment variables
71
- load_dotenv()
72
-
73
- # Define Pydantic models for structured data extraction
74
- class PageInfo(BaseModel):
75
- title: str = Field(..., description="Page title")
76
- heading: str = Field(..., description="Main heading text")
77
- description: str = Field(..., description="Page description or summary")
78
-
79
- async def main():
80
- """Main function demonstrating basic Stagehand usage"""
81
- print("🤘 Testing Stagehand Python AI Browser Automation...")
82
-
83
- # Create configuration
84
- config = StagehandConfig(
85
- env="LOCAL", # or "BROWSERBASE"
86
- api_key=os.getenv("BROWSERBASE_API_KEY"),
87
- project_id=os.getenv("BROWSERBASE_PROJECT_ID"),
88
- model_name="google/gemini-2.5-flash-preview-05-20",
89
- model_api_key=os.getenv("GOOGLE_API_KEY"),
90
- headless=False,
91
- verbose=1
92
- )
93
-
94
- stagehand = Stagehand(config)
95
-
96
- try:
97
- print("\nInitializing 🤘 Stagehand...")
98
- await stagehand.init()
99
-
100
- if stagehand.env == "BROWSERBASE":
101
- print(f"🌐 View your live browser: https://www.browserbase.com/sessions/{stagehand.session_id}")
102
-
103
- page = stagehand.page
104
-
105
- # Navigate to a test page
106
- await page.goto("https://example.com")
107
- print("✅ Successfully navigated to example.com")
108
-
109
- # Use natural language to interact
110
- await page.act("scroll down to see more content")
111
- print("✅ Performed scroll action")
112
-
113
- # Extract structured data
114
- page_info = await page.extract(
115
- "extract the page title, main heading, and description",
116
- schema=PageInfo
117
- )
118
-
119
- print(f"\n📊 Extracted Data:")
120
- print(f"Title: {page_info.title}")
121
- print(f"Heading: {page_info.heading}")
122
- print(f"Description: {page_info.description}")
123
-
124
- # Use observe to discover elements
125
- elements = await page.observe("find all clickable links")
126
- print(f"\n🔍 Observed Elements: {elements}")
127
-
128
- print("\n🎉 Stagehand Python test completed successfully!")
129
-
130
- except Exception as e:
131
- print(f"❌ Error: {str(e)}")
132
- raise
133
- finally:
134
- print("\nClosing 🤘 Stagehand...")
135
- await stagehand.close()
136
-
137
- if __name__ == "__main__":
138
- asyncio.run(main())
139
- EOF
140
-
141
- # E-commerce automation example
142
- cat > "${STAGEHAND_PYTHON_EXAMPLES_DIR}/ecommerce_automation.py" << 'EOF'
143
- #!/usr/bin/env python3
144
- """
145
- E-commerce Automation with Stagehand Python
146
- Product research and price comparison automation
147
- """
148
-
149
- import asyncio
150
- import json
151
- import os
152
- from datetime import datetime
153
- from typing import List
154
- from dotenv import load_dotenv
155
- from pydantic import BaseModel, Field
156
-
157
- from stagehand import StagehandConfig, Stagehand
158
-
159
- # Load environment variables
160
- load_dotenv()
161
-
162
- class Product(BaseModel):
163
- name: str = Field(..., description="Product name")
164
- price: float = Field(..., description="Price in USD")
165
- rating: float = Field(..., description="Star rating out of 5")
166
- review_count: int = Field(..., description="Number of reviews")
167
- availability: str = Field(..., description="Stock status")
168
- url: str = Field(None, description="Product URL")
169
-
170
- class ProductResults(BaseModel):
171
- products: List[Product] = Field(..., description="List of products")
172
- search_query: str = Field(..., description="Search query used")
173
- timestamp: str = Field(..., description="Search timestamp")
174
-
175
- async def search_products(query: str, max_results: int = 5) -> ProductResults:
176
- """Search for products and extract structured data"""
177
-
178
- config = StagehandConfig(
179
- env="LOCAL",
180
- model_name="google/gemini-2.5-flash-preview-05-20",
181
- model_api_key=os.getenv("GOOGLE_API_KEY"),
182
- headless=True, # Run headless for automation
183
- verbose=1
184
- )
185
-
186
- stagehand = Stagehand(config)
187
-
188
- try:
189
- await stagehand.init()
190
- page = stagehand.page
191
-
192
- # Navigate to Amazon (example)
193
- await page.goto("https://amazon.com")
194
-
195
- # Search for products
196
- await page.act(f'search for "{query}"')
197
-
198
- # Wait for results to load
199
- await asyncio.sleep(3)
200
-
201
- # Extract product information
202
- products_data = await page.extract(
203
- f"extract the first {max_results} products with their details",
204
- schema=ProductResults
205
- )
206
-
207
- # Add metadata
208
- products_data.search_query = query
209
- products_data.timestamp = datetime.now().isoformat()
210
-
211
- # Save results
212
- results_dir = f"{os.path.expanduser('~')}/.aidevops/stagehand-python/results"
213
- os.makedirs(results_dir, exist_ok=True)
214
-
215
- filename = f"product-search-{query.replace(' ', '-')}-{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
216
- filepath = os.path.join(results_dir, filename)
217
-
218
- with open(filepath, 'w') as f:
219
- json.dump(products_data.dict(), f, indent=2)
220
-
221
- print(f"Found {len(products_data.products)} products:")
222
- for i, product in enumerate(products_data.products, 1):
223
- print(f"{i}. {product.name} - ${product.price} ({product.rating}⭐)")
224
-
225
- print(f"Results saved to: {filepath}")
226
- return products_data
227
-
228
- except Exception as e:
229
- print(f"Error during product search: {e}")
230
- raise
231
- finally:
232
- await stagehand.close()
233
-
234
- async def main():
235
- """Main function for product search"""
236
- import sys
237
-
238
- query = sys.argv[1] if len(sys.argv) > 1 else "wireless headphones"
239
- max_results = int(sys.argv[2]) if len(sys.argv) > 2 else 5
240
-
241
- results = await search_products(query, max_results)
242
- print(f"\nProduct search completed for: {results.search_query}")
243
-
244
- if __name__ == "__main__":
245
- asyncio.run(main())
246
- EOF
247
-
248
- # Web scraping template
249
- cat > "${STAGEHAND_PYTHON_TEMPLATES_DIR}/web_scraping_template.py" << 'EOF'
250
- #!/usr/bin/env python3
251
- """
252
- Web Scraping Template with Stagehand Python
253
- Adaptable template for various websites with structured data extraction
254
- """
255
-
256
- import asyncio
257
- import json
258
- import os
259
- from datetime import datetime
260
- from typing import List, Optional
261
- from dotenv import load_dotenv
262
- from pydantic import BaseModel, Field
263
-
264
- from stagehand import StagehandConfig, Stagehand
265
-
266
- # Load environment variables
267
- load_dotenv()
268
-
269
- class ScrapedItem(BaseModel):
270
- title: str = Field(..., description="Item title")
271
- description: str = Field(..., description="Item description or content")
272
- url: Optional[str] = Field(None, description="Item URL")
273
- metadata: Optional[dict] = Field(None, description="Additional metadata")
274
-
275
- class ScrapingResults(BaseModel):
276
- items: List[ScrapedItem] = Field(..., description="List of scraped items")
277
- source_url: str = Field(..., description="Source URL")
278
- extraction_prompt: str = Field(..., description="Extraction prompt used")
279
- timestamp: str = Field(..., description="Scraping timestamp")
280
-
281
- async def scrape_website(url: str, extraction_prompt: str, max_items: int = 10) -> ScrapingResults:
282
- """Generic website scraping function"""
283
-
284
- config = StagehandConfig(
285
- env="LOCAL",
286
- model_name="google/gemini-2.5-flash-preview-05-20",
287
- model_api_key=os.getenv("GOOGLE_API_KEY"),
288
- headless=True,
289
- verbose=1
290
- )
291
-
292
- stagehand = Stagehand(config)
293
-
294
- try:
295
- await stagehand.init()
296
- page = stagehand.page
297
-
298
- print(f"Navigating to: {url}")
299
- await page.goto(url)
300
-
301
- # Wait for page to load
302
- await asyncio.sleep(3)
303
-
304
- # Handle cookie banners or popups
305
- try:
306
- await page.act("close any cookie banners or popups")
307
- except Exception:
308
- print("No popups to close")
309
-
310
- # Extract data based on the prompt
311
- results = await page.extract(
312
- extraction_prompt,
313
- schema=ScrapingResults
314
- )
315
-
316
- # Add metadata
317
- results.source_url = url
318
- results.extraction_prompt = extraction_prompt
319
- results.timestamp = datetime.now().isoformat()
320
-
321
- print(f"Extracted {len(results.items)} items:")
322
- for i, item in enumerate(results.items, 1):
323
- print(f"{i}. {item.title}")
324
- print(f" {item.description[:100]}...")
325
-
326
- return results
327
-
328
- except Exception as e:
329
- print(f"Error during web scraping: {e}")
330
- raise
331
- finally:
332
- await stagehand.close()
333
-
334
- async def main():
335
- """Main function for web scraping"""
336
- import sys
337
-
338
- url = sys.argv[1] if len(sys.argv) > 1 else "https://news.ycombinator.com"
339
- prompt = sys.argv[2] if len(sys.argv) > 2 else "extract the top stories with titles and descriptions"
340
- max_items = int(sys.argv[3]) if len(sys.argv) > 3 else 10
341
-
342
- results = await scrape_website(url, prompt, max_items)
343
-
344
- # Save results
345
- results_dir = f"{os.path.expanduser('~')}/.aidevops/stagehand-python/results"
346
- os.makedirs(results_dir, exist_ok=True)
347
-
348
- filename = f"scraping-results-{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
349
- filepath = os.path.join(results_dir, filename)
350
-
351
- with open(filepath, 'w') as f:
352
- json.dump(results.dict(), f, indent=2)
353
-
354
- print(f"Results saved to: {filepath}")
355
-
356
- if __name__ == "__main__":
357
- asyncio.run(main())
358
- EOF
359
-
360
- print_success "Created advanced Stagehand Python examples"
361
- return 0
362
- }
363
-
364
- # Create requirements.txt for the project
365
- create_requirements_file() {
366
- local requirements_file="${STAGEHAND_PYTHON_CONFIG_DIR}/requirements.txt"
367
-
368
- cat > "$requirements_file" << 'EOF'
369
- # Stagehand Python AI Browser Automation
370
- stagehand>=0.5.0
371
-
372
- # Core dependencies
373
- pydantic>=2.0.0
374
- python-dotenv>=1.0.0
375
- playwright>=1.40.0
376
-
377
- # Optional dependencies for enhanced functionality
378
- aiofiles>=23.0.0
379
- httpx>=0.25.0
380
- rich>=13.0.0
381
-
382
- # Development dependencies (optional)
383
- pytest>=7.0.0
384
- pytest-asyncio>=0.21.0
385
- black>=23.0.0
386
- isort>=5.12.0
387
- mypy>=1.5.0
388
- EOF
389
-
390
- print_success "Created requirements.txt at: $requirements_file"
391
- return 0
392
- }
393
-
394
- # Main setup function
395
- main() {
396
- local command="${1:-setup}"
397
-
398
- case "$command" in
399
- "setup")
400
- print_info "Setting up Stagehand Python advanced configuration..."
401
- create_python_examples
402
- create_requirements_file
403
- print_success "Stagehand Python advanced setup completed!"
404
- print_info "Next steps:"
405
- print_info "1. Run: bash .agent/scripts/stagehand-python-helper.sh install"
406
- print_info "2. Configure API keys in ~/.aidevops/stagehand-python/.env"
407
- print_info "3. Activate venv: source ~/.aidevops/stagehand-python/.venv/bin/activate"
408
- print_info "4. Try examples: cd ~/.aidevops/stagehand-python && python examples/basic_example.py" || exit
409
- ;;
410
- "examples")
411
- create_python_examples
412
- ;;
413
- "requirements")
414
- create_requirements_file
415
- ;;
416
- "help")
417
- cat << EOF
418
- Stagehand Python Setup Script
419
-
420
- USAGE:
421
- $0 [COMMAND]
422
-
423
- COMMANDS:
424
- setup Complete advanced setup (default)
425
- examples Create example scripts only
426
- requirements Create requirements.txt only
427
- help Show this help
428
-
429
- EOF
430
- ;;
431
- *)
432
- print_error "$ERROR_UNKNOWN_COMMAND $command"
433
- return 1
434
- ;;
435
- esac
436
-
437
- return 0
438
- }
439
-
440
- # Execute main function
441
- main "$@"