webscout 8.3.7__py3-none-any.whl → 2025.10.11__py3-none-any.whl

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.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (273) hide show
  1. webscout/AIauto.py +250 -250
  2. webscout/AIbase.py +379 -379
  3. webscout/AIutel.py +60 -60
  4. webscout/Bard.py +1012 -1012
  5. webscout/Bing_search.py +417 -417
  6. webscout/DWEBS.py +529 -529
  7. webscout/Extra/Act.md +309 -309
  8. webscout/Extra/GitToolkit/__init__.py +10 -10
  9. webscout/Extra/GitToolkit/gitapi/README.md +110 -110
  10. webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
  11. webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
  12. webscout/Extra/GitToolkit/gitapi/user.py +96 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
  14. webscout/Extra/YTToolkit/README.md +375 -375
  15. webscout/Extra/YTToolkit/YTdownloader.py +956 -956
  16. webscout/Extra/YTToolkit/__init__.py +2 -2
  17. webscout/Extra/YTToolkit/transcriber.py +475 -475
  18. webscout/Extra/YTToolkit/ytapi/README.md +44 -44
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
  20. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  21. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  22. webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
  23. webscout/Extra/YTToolkit/ytapi/https.py +88 -88
  24. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  25. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  26. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  27. webscout/Extra/YTToolkit/ytapi/query.py +39 -39
  28. webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
  29. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  30. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  31. webscout/Extra/autocoder/__init__.py +9 -9
  32. webscout/Extra/autocoder/autocoder.py +1105 -1105
  33. webscout/Extra/autocoder/autocoder_utiles.py +332 -332
  34. webscout/Extra/gguf.md +429 -429
  35. webscout/Extra/gguf.py +1213 -1213
  36. webscout/Extra/tempmail/README.md +487 -487
  37. webscout/Extra/tempmail/__init__.py +27 -27
  38. webscout/Extra/tempmail/async_utils.py +140 -140
  39. webscout/Extra/tempmail/base.py +160 -160
  40. webscout/Extra/tempmail/cli.py +186 -186
  41. webscout/Extra/tempmail/emailnator.py +84 -84
  42. webscout/Extra/tempmail/mail_tm.py +360 -360
  43. webscout/Extra/tempmail/temp_mail_io.py +291 -291
  44. webscout/Extra/weather.md +281 -281
  45. webscout/Extra/weather.py +193 -193
  46. webscout/Litlogger/README.md +10 -10
  47. webscout/Litlogger/__init__.py +15 -15
  48. webscout/Litlogger/formats.py +13 -13
  49. webscout/Litlogger/handlers.py +121 -121
  50. webscout/Litlogger/levels.py +13 -13
  51. webscout/Litlogger/logger.py +134 -134
  52. webscout/Provider/AISEARCH/Perplexity.py +332 -332
  53. webscout/Provider/AISEARCH/README.md +279 -279
  54. webscout/Provider/AISEARCH/__init__.py +16 -1
  55. webscout/Provider/AISEARCH/felo_search.py +206 -206
  56. webscout/Provider/AISEARCH/genspark_search.py +323 -323
  57. webscout/Provider/AISEARCH/hika_search.py +185 -185
  58. webscout/Provider/AISEARCH/iask_search.py +410 -410
  59. webscout/Provider/AISEARCH/monica_search.py +219 -219
  60. webscout/Provider/AISEARCH/scira_search.py +316 -316
  61. webscout/Provider/AISEARCH/stellar_search.py +177 -177
  62. webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
  63. webscout/Provider/Aitopia.py +314 -314
  64. webscout/Provider/Apriel.py +306 -0
  65. webscout/Provider/ChatGPTClone.py +236 -236
  66. webscout/Provider/ChatSandbox.py +343 -343
  67. webscout/Provider/Cloudflare.py +324 -324
  68. webscout/Provider/Cohere.py +208 -208
  69. webscout/Provider/Deepinfra.py +370 -366
  70. webscout/Provider/ExaAI.py +260 -260
  71. webscout/Provider/ExaChat.py +308 -308
  72. webscout/Provider/Flowith.py +221 -221
  73. webscout/Provider/GMI.py +293 -0
  74. webscout/Provider/Gemini.py +164 -164
  75. webscout/Provider/GeminiProxy.py +167 -167
  76. webscout/Provider/GithubChat.py +371 -372
  77. webscout/Provider/Groq.py +800 -800
  78. webscout/Provider/HeckAI.py +383 -383
  79. webscout/Provider/Jadve.py +282 -282
  80. webscout/Provider/K2Think.py +307 -307
  81. webscout/Provider/Koboldai.py +205 -205
  82. webscout/Provider/LambdaChat.py +423 -423
  83. webscout/Provider/Nemotron.py +244 -244
  84. webscout/Provider/Netwrck.py +248 -248
  85. webscout/Provider/OLLAMA.py +395 -395
  86. webscout/Provider/OPENAI/Cloudflare.py +393 -393
  87. webscout/Provider/OPENAI/FalconH1.py +451 -451
  88. webscout/Provider/OPENAI/FreeGemini.py +296 -296
  89. webscout/Provider/OPENAI/K2Think.py +431 -431
  90. webscout/Provider/OPENAI/NEMOTRON.py +240 -240
  91. webscout/Provider/OPENAI/PI.py +427 -427
  92. webscout/Provider/OPENAI/README.md +959 -959
  93. webscout/Provider/OPENAI/TogetherAI.py +345 -345
  94. webscout/Provider/OPENAI/TwoAI.py +465 -465
  95. webscout/Provider/OPENAI/__init__.py +33 -18
  96. webscout/Provider/OPENAI/base.py +248 -248
  97. webscout/Provider/OPENAI/chatglm.py +528 -0
  98. webscout/Provider/OPENAI/chatgpt.py +592 -592
  99. webscout/Provider/OPENAI/chatgptclone.py +521 -521
  100. webscout/Provider/OPENAI/chatsandbox.py +202 -202
  101. webscout/Provider/OPENAI/deepinfra.py +318 -314
  102. webscout/Provider/OPENAI/e2b.py +1665 -1665
  103. webscout/Provider/OPENAI/exaai.py +420 -420
  104. webscout/Provider/OPENAI/exachat.py +452 -452
  105. webscout/Provider/OPENAI/friendli.py +232 -232
  106. webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
  107. webscout/Provider/OPENAI/groq.py +364 -364
  108. webscout/Provider/OPENAI/heckai.py +314 -314
  109. webscout/Provider/OPENAI/llmchatco.py +337 -337
  110. webscout/Provider/OPENAI/netwrck.py +355 -355
  111. webscout/Provider/OPENAI/oivscode.py +290 -290
  112. webscout/Provider/OPENAI/opkfc.py +518 -518
  113. webscout/Provider/OPENAI/pydantic_imports.py +1 -1
  114. webscout/Provider/OPENAI/scirachat.py +535 -535
  115. webscout/Provider/OPENAI/sonus.py +308 -308
  116. webscout/Provider/OPENAI/standardinput.py +442 -442
  117. webscout/Provider/OPENAI/textpollinations.py +340 -340
  118. webscout/Provider/OPENAI/toolbaz.py +419 -416
  119. webscout/Provider/OPENAI/typefully.py +362 -362
  120. webscout/Provider/OPENAI/utils.py +295 -295
  121. webscout/Provider/OPENAI/venice.py +436 -436
  122. webscout/Provider/OPENAI/wisecat.py +387 -387
  123. webscout/Provider/OPENAI/writecream.py +166 -166
  124. webscout/Provider/OPENAI/x0gpt.py +378 -378
  125. webscout/Provider/OPENAI/yep.py +389 -389
  126. webscout/Provider/OpenGPT.py +230 -230
  127. webscout/Provider/Openai.py +243 -243
  128. webscout/Provider/PI.py +405 -405
  129. webscout/Provider/Perplexitylabs.py +430 -430
  130. webscout/Provider/QwenLM.py +272 -272
  131. webscout/Provider/STT/__init__.py +16 -1
  132. webscout/Provider/Sambanova.py +257 -257
  133. webscout/Provider/StandardInput.py +309 -309
  134. webscout/Provider/TTI/README.md +82 -82
  135. webscout/Provider/TTI/__init__.py +33 -18
  136. webscout/Provider/TTI/aiarta.py +413 -413
  137. webscout/Provider/TTI/base.py +136 -136
  138. webscout/Provider/TTI/bing.py +243 -243
  139. webscout/Provider/TTI/gpt1image.py +149 -149
  140. webscout/Provider/TTI/imagen.py +196 -196
  141. webscout/Provider/TTI/infip.py +211 -211
  142. webscout/Provider/TTI/magicstudio.py +232 -232
  143. webscout/Provider/TTI/monochat.py +219 -219
  144. webscout/Provider/TTI/piclumen.py +214 -214
  145. webscout/Provider/TTI/pixelmuse.py +232 -232
  146. webscout/Provider/TTI/pollinations.py +232 -232
  147. webscout/Provider/TTI/together.py +288 -288
  148. webscout/Provider/TTI/utils.py +12 -12
  149. webscout/Provider/TTI/venice.py +367 -367
  150. webscout/Provider/TTS/README.md +192 -192
  151. webscout/Provider/TTS/__init__.py +33 -18
  152. webscout/Provider/TTS/parler.py +110 -110
  153. webscout/Provider/TTS/streamElements.py +333 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TeachAnything.py +237 -237
  156. webscout/Provider/TextPollinationsAI.py +310 -310
  157. webscout/Provider/TogetherAI.py +356 -356
  158. webscout/Provider/TwoAI.py +312 -312
  159. webscout/Provider/TypliAI.py +311 -311
  160. webscout/Provider/UNFINISHED/ChatHub.py +208 -208
  161. webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
  162. webscout/Provider/UNFINISHED/GizAI.py +294 -294
  163. webscout/Provider/UNFINISHED/Marcus.py +198 -198
  164. webscout/Provider/UNFINISHED/Qodo.py +477 -477
  165. webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
  166. webscout/Provider/UNFINISHED/XenAI.py +324 -324
  167. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  168. webscout/Provider/UNFINISHED/liner.py +334 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
  170. webscout/Provider/UNFINISHED/puterjs.py +634 -634
  171. webscout/Provider/UNFINISHED/samurai.py +223 -223
  172. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  173. webscout/Provider/Venice.py +250 -250
  174. webscout/Provider/VercelAI.py +256 -256
  175. webscout/Provider/WiseCat.py +231 -231
  176. webscout/Provider/WrDoChat.py +366 -366
  177. webscout/Provider/__init__.py +33 -18
  178. webscout/Provider/ai4chat.py +174 -174
  179. webscout/Provider/akashgpt.py +331 -331
  180. webscout/Provider/cerebras.py +446 -446
  181. webscout/Provider/chatglm.py +394 -301
  182. webscout/Provider/cleeai.py +211 -211
  183. webscout/Provider/elmo.py +282 -282
  184. webscout/Provider/geminiapi.py +208 -208
  185. webscout/Provider/granite.py +261 -261
  186. webscout/Provider/hermes.py +263 -263
  187. webscout/Provider/julius.py +223 -223
  188. webscout/Provider/learnfastai.py +309 -309
  189. webscout/Provider/llama3mitril.py +214 -214
  190. webscout/Provider/llmchat.py +243 -243
  191. webscout/Provider/llmchatco.py +290 -290
  192. webscout/Provider/meta.py +801 -801
  193. webscout/Provider/oivscode.py +309 -309
  194. webscout/Provider/scira_chat.py +383 -383
  195. webscout/Provider/searchchat.py +292 -292
  196. webscout/Provider/sonus.py +258 -258
  197. webscout/Provider/toolbaz.py +370 -367
  198. webscout/Provider/turboseek.py +273 -273
  199. webscout/Provider/typefully.py +207 -207
  200. webscout/Provider/yep.py +372 -372
  201. webscout/__init__.py +30 -31
  202. webscout/__main__.py +5 -5
  203. webscout/auth/api_key_manager.py +189 -189
  204. webscout/auth/config.py +175 -175
  205. webscout/auth/models.py +185 -185
  206. webscout/auth/routes.py +664 -664
  207. webscout/auth/simple_logger.py +236 -236
  208. webscout/cli.py +523 -523
  209. webscout/conversation.py +438 -438
  210. webscout/exceptions.py +361 -361
  211. webscout/litagent/Readme.md +298 -298
  212. webscout/litagent/__init__.py +28 -28
  213. webscout/litagent/agent.py +581 -581
  214. webscout/litagent/constants.py +59 -59
  215. webscout/litprinter/__init__.py +58 -58
  216. webscout/models.py +181 -181
  217. webscout/optimizers.py +419 -419
  218. webscout/prompt_manager.py +288 -288
  219. webscout/sanitize.py +1078 -1078
  220. webscout/scout/README.md +401 -401
  221. webscout/scout/__init__.py +8 -8
  222. webscout/scout/core/__init__.py +6 -6
  223. webscout/scout/core/crawler.py +297 -297
  224. webscout/scout/core/scout.py +706 -706
  225. webscout/scout/core/search_result.py +95 -95
  226. webscout/scout/core/text_analyzer.py +62 -62
  227. webscout/scout/core/text_utils.py +277 -277
  228. webscout/scout/core/web_analyzer.py +51 -51
  229. webscout/scout/element.py +599 -599
  230. webscout/scout/parsers/__init__.py +69 -69
  231. webscout/scout/parsers/html5lib_parser.py +172 -172
  232. webscout/scout/parsers/html_parser.py +236 -236
  233. webscout/scout/parsers/lxml_parser.py +178 -178
  234. webscout/scout/utils.py +37 -37
  235. webscout/swiftcli/Readme.md +323 -323
  236. webscout/swiftcli/__init__.py +95 -95
  237. webscout/swiftcli/core/__init__.py +7 -7
  238. webscout/swiftcli/core/cli.py +308 -308
  239. webscout/swiftcli/core/context.py +104 -104
  240. webscout/swiftcli/core/group.py +241 -241
  241. webscout/swiftcli/decorators/__init__.py +28 -28
  242. webscout/swiftcli/decorators/command.py +221 -221
  243. webscout/swiftcli/decorators/options.py +220 -220
  244. webscout/swiftcli/decorators/output.py +302 -302
  245. webscout/swiftcli/exceptions.py +21 -21
  246. webscout/swiftcli/plugins/__init__.py +9 -9
  247. webscout/swiftcli/plugins/base.py +135 -135
  248. webscout/swiftcli/plugins/manager.py +269 -269
  249. webscout/swiftcli/utils/__init__.py +59 -59
  250. webscout/swiftcli/utils/formatting.py +252 -252
  251. webscout/swiftcli/utils/parsing.py +267 -267
  252. webscout/update_checker.py +117 -117
  253. webscout/version.py +1 -1
  254. webscout/webscout_search.py +1183 -1183
  255. webscout/webscout_search_async.py +649 -649
  256. webscout/yep_search.py +346 -346
  257. webscout/zeroart/README.md +89 -89
  258. webscout/zeroart/__init__.py +134 -134
  259. webscout/zeroart/base.py +66 -66
  260. webscout/zeroart/effects.py +100 -100
  261. webscout/zeroart/fonts.py +1238 -1238
  262. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -937
  263. webscout-2025.10.11.dist-info/RECORD +300 -0
  264. webscout/Provider/AISEARCH/DeepFind.py +0 -254
  265. webscout/Provider/OPENAI/Qwen3.py +0 -303
  266. webscout/Provider/OPENAI/qodo.py +0 -630
  267. webscout/Provider/OPENAI/xenai.py +0 -514
  268. webscout/tempid.py +0 -134
  269. webscout-8.3.7.dist-info/RECORD +0 -301
  270. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
  271. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
  272. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
  273. {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/top_level.txt +0 -0
@@ -1,332 +1,332 @@
1
- """AutoCoder utilities module."""
2
-
3
- import os
4
- import platform
5
- import datetime
6
- import sys
7
- import os
8
- import platform
9
- import subprocess
10
-
11
- def get_current_app() -> str:
12
- """
13
- Get the current active application or window title in a cross-platform manner.
14
-
15
- On Windows, uses the win32gui module from pywin32.
16
- On macOS, uses AppKit to access the active application info.
17
- On Linux, uses xprop to get the active window details.
18
-
19
- Returns:
20
- A string containing the title of the active application/window, or "Unknown" if it cannot be determined.
21
- """
22
- system_name = platform.system()
23
-
24
- if system_name == "Windows":
25
- try:
26
- import win32gui # pywin32 must be installed
27
- window_handle = win32gui.GetForegroundWindow()
28
- title = win32gui.GetWindowText(window_handle)
29
- return title if title else "Unknown"
30
- except Exception:
31
- return "Unknown"
32
-
33
- elif system_name == "Darwin": # macOS
34
- try:
35
- from AppKit import NSWorkspace # type: ignore
36
- active_app = NSWorkspace.sharedWorkspace().activeApplication()
37
- title = active_app.get('NSApplicationName')
38
- return title if title else "Unknown"
39
- except Exception:
40
- return "Unknown"
41
-
42
- elif system_name == "Linux":
43
- try:
44
- # Get the active window id using xprop
45
- result = subprocess.run(
46
- ["xprop", "-root", "_NET_ACTIVE_WINDOW"],
47
- stdout=subprocess.PIPE,
48
- stderr=subprocess.PIPE,
49
- text=True
50
- )
51
- if result.returncode == 0 and result.stdout:
52
- # Expected format: _NET_ACTIVE_WINDOW(WINDOW): window id # 0x1400007
53
- parts = result.stdout.strip().split()
54
- window_id = parts[-1]
55
- if window_id != "0x0":
56
- title_result = subprocess.run(
57
- ["xprop", "-id", window_id, "WM_NAME"],
58
- stdout=subprocess.PIPE,
59
- stderr=subprocess.PIPE,
60
- text=True
61
- )
62
- if title_result.returncode == 0 and title_result.stdout:
63
- # Expected format: WM_NAME(STRING) = "Terminal"
64
- title_parts = title_result.stdout.split(" = ", 1)
65
- if len(title_parts) == 2:
66
- title = title_parts[1].strip().strip('"')
67
- return title if title else "Unknown"
68
- except Exception:
69
- pass
70
- return "Unknown"
71
- else:
72
- return "Unknown"
73
-
74
-
75
- def get_intro_prompt(name: str = "Vortex") -> str:
76
- """Get the introduction prompt for the AutoCoder."""
77
- current_app: str = get_current_app()
78
- python_version: str = sys.version.split()[0]
79
-
80
- return f"""
81
- <system_context>
82
- <purpose>
83
- You are a command-line coding assistant named Rawdog, designed to generate and auto-execute Python scripts for {name}.
84
- Your core function is to understand natural language requests, transform them into executable Python code,
85
- and return results to the user via console output. You must adhere to all instructions.
86
- </purpose>
87
-
88
- <process_description>
89
- A typical interaction unfolds as follows:
90
- 1. The user provides a natural language PROMPT.
91
- 2. You:
92
- i. Analyze the PROMPT to determine the required actions.
93
- ii. Craft a SCRIPT to execute those actions. This SCRIPT may contain Python code for logic, data processing, and interacting with Python libraries. However, for any direct shell/command-line (CLI) operations, the SCRIPT MUST use the `!` prefix (e.g., `!ls -la`, `!pip install requests`).
94
- iii. Provide clear and concise feedback to the user by printing to the console, either from Python code or by observing the output of `!` commands.
95
- 3. The compiler will then:
96
- i. Extract the SCRIPT. Python parts of the script are executed (e.g., via `exec()`), and `!` prefixed commands are handled as direct shell executions.
97
- ii. Handle any exceptions that arise during Python script execution. Exceptions are returned to you starting with "PREVIOUS SCRIPT EXCEPTION:". Errors from `!` commands might also be reported.
98
- 4. In cases of exceptions, ensure that you regenerate the script and return one that has no errors.
99
-
100
- <continue_process>
101
- If you need to review script outputs before task completion, include the word "CONTINUE" at the end of your SCRIPT.
102
- This allows multi-step reasoning for tasks like summarizing documents, reviewing instructions, or performing other multi-part operations.
103
- A typical 'CONTINUE' interaction looks like this:
104
- 1. The user gives you a natural language PROMPT.
105
- 2. You:
106
- i. Determine what needs to be done.
107
- ii. Determine that you need to see the output of some subprocess call to complete the task
108
- iii. Write a SCRIPT to perform the action and print its output (if necessary), then print the word "CONTINUE".
109
- 3. The compiler will:
110
- i. Check and run your SCRIPT.
111
- ii. Capture the output and append it to the conversation as "LAST SCRIPT OUTPUT:".
112
- iii. Find the word "CONTINUE" and return control back to you.
113
- 4. You will then:
114
- i. Review the original PROMPT + the "LAST SCRIPT OUTPUT:" to determine what to do
115
- ii. Write a short Python SCRIPT to complete the task.
116
- iii. Communicate back to the user by printing to the console in that SCRIPT, or by ensuring the `!` command output is relevant.
117
- 5. The compiler repeats the above process...
118
- </continue_process>
119
-
120
- </process_description>
121
-
122
- <conventions>
123
- - Decline any tasks that seem dangerous, irreversible, or that you don't understand.
124
- - **Shell/CLI Command Execution**: This is a critical instruction. For ALL shell, terminal, or command-line interface (CLI) tasks (e.g., listing files with `ls` or `dir`, managing packages with `pip` or `npm`, using `git`, running system utilities), you MUST use the `!` prefix followed directly by the command. For example: `!ls -l`, `!pip install SomePackage`, `!git status`. You MUST NEVER use Python modules such as `os.system()`, `subprocess.run()`, `subprocess.Popen()`, or any other Python code constructs to execute these types of commands. The SCRIPT you generate should contain these `!` commands directly when a shell/CLI operation is needed. Python code should still be used for other logic, data manipulation, or when interacting with Python-specific libraries and their functions.
125
- - Always review the full conversation prior to answering and maintain continuity.
126
- - If asked for information, just print the information clearly and concisely.
127
- - If asked to do something, print a concise summary of what you've done as confirmation.
128
- - If asked a question, respond in a friendly, conversational way. Use programmatically-generated and natural language responses as appropriate.
129
- - If you need clarification, return a SCRIPT that prints your question. In the next interaction, continue based on the user's response.
130
- - Assume the user would like something concise. For example rather than printing a massive table, filter or summarize it to what's likely of interest.
131
- - Actively clean up any temporary processes or files you use.
132
- - When looking through files, use git as available to skip files, and skip hidden files (.env, .git, etc) by default.
133
- - You can plot anything with matplotlib using Python code.
134
- - **IMPORTANT**: ALWAYS Return your SCRIPT inside of a single pair of ``` delimiters. This SCRIPT can be a mix of Python code and `!`-prefixed shell commands. Only the console output from this SCRIPT (Python prints or `!` command stdout/stderr) is visible to the user, so ensure it's complete.
135
- </conventions>
136
-
137
- <examples>
138
- <example>
139
- <user_request>Kill the process running on port 3000 and then list installed pip packages.</user_request>
140
- <rawdog_response>
141
- ```
142
- !kill $(lsof -t -i:3000)
143
- !pip list
144
- ```
145
- </rawdog_response>
146
- </example>
147
- <example>
148
- <user_request>Summarize my essay</user_request>
149
- <rawdog_response>
150
- ```python
151
- import glob
152
- files = glob.glob("*essay*.*")
153
- with open(files[0], "r") as f:
154
- print(f.read())
155
- ```
156
- CONTINUE
157
- </rawdog_response>
158
- <user_response>
159
- LAST SCRIPT OUTPUT:
160
- John Smith
161
- Essay 2021-09-01
162
- ...
163
- </user_response>
164
- <rawdog_response>
165
- ```python
166
- print("The essay is about...")
167
- ```
168
- </rawdog_response>
169
- </example>
170
- <example>
171
- <user_request>Weather in qazigund</user_request>
172
- <rawdog_response>
173
- ```python
174
- from webscout import weather as w
175
- weather = w.get("Qazigund")
176
- w.print_weather(weather)
177
- ```
178
- </rawdog_response>
179
- </example>
180
- </examples>
181
-
182
- <environment_info>
183
- - System: {platform.system()}
184
- - Python: {python_version}
185
- - Directory: {os.getcwd()}
186
- - Datetime: {datetime.datetime.now()}
187
- - Active App: {current_app}
188
- </environment_info>
189
- </system_context>
190
- """
191
-
192
- def get_thinking_intro() -> str:
193
- return """
194
- <instructions>
195
- <instruction>You are a Thought Process Generation Engine. Your role is to meticulously analyze a given task and outline a step-by-step plan (a thought process) for how an autocoder or automated system should approach it.</instruction>
196
- <instruction>DO NOT EXECUTE any actions or code. Your sole output is the structured thought process itself.</instruction>
197
- <instruction>Decompose the provided task into the smallest logical, sequential, and atomic thoughts required to achieve the overall goal.</instruction>
198
- <instruction>For each individual thought, you MUST provide:
199
- - A clear `<description>` of the specific action or check.
200
- - The `<required_packages>` or tools needed for this specific step (e.g., specific libraries, OS commands, APIs, software applications). If none are needed (e.g., a purely logical step), state "None".
201
- - Concrete `<code_suggestions>` or specific commands relevant to executing this thought. Provide language-agnostic pseudocode or specific examples if a language context is implied or provided. For non-coding steps (like UI interaction), describe the action precisely (e.g., "Click 'File' menu", "Type 'search query' into element ID 'search-box'").
202
- - The immediate `<result>` expected after successfully executing this single thought.
203
- </instruction>
204
- <instruction>Identify any `<prerequisites>` necessary before starting the *entire* task (e.g., internet connection, specific software installed, user logged in, necessary files exist).</instruction>
205
- <instruction>Structure the thoughts logically. The result of one thought should often enable the next.</instruction>
206
- <instruction>Briefly consider potential issues or basic error handling within the description or result where relevant (e.g., "Check if file exists before attempting to read", "Result: File content loaded, or error if file not found").</instruction>
207
- <instruction>Conclude with the final `<expected_outcome>` of the entire task sequence.</instruction>
208
- <instruction>Output your response strictly adhering to the XML structure defined in the `<response_format>` section.</instruction>
209
- </instructions>
210
-
211
- <response_format>
212
- <thought_process>
213
- <goal>The user's original request, summarized.</goal>
214
- <prerequisites>
215
- <prerequisite>Prerequisite 1</prerequisite>
216
- <prerequisite>Prerequisite 2</prerequisite>
217
- {{...more prerequisites}}
218
- </prerequisites>
219
- <thoughts>
220
- <thought>
221
- <description>Description of the first atomic step.</description>
222
- <required_packages>Package/Tool/Library needed for this step, or "None".</required_packages>
223
- <code_suggestions>Code snippet, command, or specific action description.</code_suggestions>
224
- <result>Expected state or outcome immediately after this step.</result>
225
- </thought>
226
- <thought>
227
- <description>Description of the second atomic step.</description>
228
- <required_packages>Package/Tool/Library needed for this step, or "None".</required_packages>
229
- <code_suggestions>Code snippet, command, or specific action description.</code_suggestions>
230
- <result>Expected state or outcome immediately after this step.</result>
231
- </thought>
232
- {{...more thoughts}}
233
- </thoughts>
234
- <expected_outcome>The final desired state after all thoughts are successfully executed.</expected_outcome>
235
- </thought_process>
236
- </response_format>
237
-
238
- <examples>
239
- <example>
240
- <input>Check if the file 'config.json' exists in the current directory and print its content if it does.</input>
241
- <output>
242
- <thought_process>
243
- <goal>Check for 'config.json' and print its content if it exists.</goal>
244
- <prerequisites>
245
- <prerequisite>Access to the file system in the current directory.</prerequisite>
246
- <prerequisite>A terminal or execution environment capable of running file system commands/code.</prerequisite>
247
- <prerequisite>Permissions to read files in the current directory.</prerequisite>
248
- </prerequisites>
249
- <thoughts>
250
- <thought>
251
- <description>Check if the file 'config.json' exists in the current working directory.</description>
252
- <required_packages>OS-specific file system module (e.g., `os` in Python, `fs` in Node.js, `System.IO` in C#)</required_packages>
253
- <code_suggestions>Python: `import os; os.path.exists('config.json')` | Node.js: `require('fs').existsSync('config.json')` | Bash: `[ -f config.json ]`</code_suggestions>
254
- <result>Boolean status indicating if 'config.json' exists (True/False or exit code 0/1).</result>
255
- </thought>
256
- <thought>
257
- <description>If the file exists, open 'config.json' for reading.</description>
258
- <required_packages>OS-specific file system module (same as above).</required_packages>
259
- <code_suggestions>Python: `file = open('config.json', 'r')` | Node.js: `const fileContent = require('fs').readFileSync('config.json', 'utf8')` | Bash: `cat config.json` (implicitly opens and reads)</code_suggestions>
260
- <result>File handle obtained or file content read into memory, contingent on existence check being true. No action if file doesn't exist.</result>
261
- </thought>
262
- <thought>
263
- <description>If the file was opened, read its entire content.</description>
264
- <required_packages>OS-specific file system module (if using file handle).</required_packages>
265
- <code_suggestions>Python: `content = file.read()` | Node.js: (Already done in previous step suggestion) | Bash: (Already done in previous step suggestion)</code_suggestions>
266
- <result>String variable `content` holds the text from 'config.json'. No action if file doesn't exist.</result>
267
- </thought>
268
- <thought>
269
- <description>If content was read, print the content to the standard output.</description>
270
- <required_packages>Standard output library/function (e.g., `print` in Python, `console.log` in Node.js, `echo` in Bash).</required_packages>
271
- <code_suggestions>Python: `print(content)` | Node.js: `console.log(fileContent)` | Bash: `cat config.json` (already prints)</code_suggestions>
272
- <result>The content of 'config.json' is displayed on the console/terminal. No action if file doesn't exist.</result>
273
- </thought>
274
- <thought>
275
- <description>If the file was opened with a handle, close the file.</description>
276
- <required_packages>OS-specific file system module (if using file handle).</required_packages>
277
- <code_suggestions>Python: `file.close()` (Or use `with open(...)` for automatic closing)</code_suggestions>
278
- <result>File handle is released. No action if file doesn't exist or wasn't opened with a handle.</result>
279
- </thought>
280
- </thoughts>
281
- <expected_outcome>If 'config.json' exists in the current directory, its contents are printed to the standard output. Otherwise, nothing is printed.</expected_outcome>
282
- </thought_process>
283
- </output>
284
- </example>
285
-
286
- <example>
287
- <input>Open Chrome, go to example.com, find the text "More information..." and click it.</input>
288
- <output>
289
- <thought_process>
290
- <goal>Open Chrome, navigate to example.com, find and click the "More information..." link.</goal>
291
- <prerequisites>
292
- <prerequisite>Google Chrome browser installed.</prerequisite>
293
- <prerequisite>Internet connection.</prerequisite>
294
- <prerequisite>Ability to launch applications (GUI or command line).</prerequisite>
295
- <prerequisite>Web automation tool/library if doing programmatically (e.g., Selenium, Playwright).</prerequisite>
296
- </prerequisites>
297
- <thoughts>
298
- <thought>
299
- <description>Launch the Google Chrome browser.</description>
300
- <required_packages>OS (for launching apps), or specific automation library like Selenium/Playwright.</required_packages>
301
- <code_suggestions>Command Line: `google-chrome` or `start chrome` | Selenium(Python): `from selenium import webdriver; driver = webdriver.Chrome()`</code_suggestions>
302
- <result>A new Chrome browser window opens.</result>
303
- </thought>
304
- <thought>
305
- <description>Navigate to the URL 'http://example.com'.</description>
306
- <required_packages>Chrome browser UI, or automation library.</required_packages>
307
- <code_suggestions>Manual: Type 'example.com' in address bar and press Enter | Selenium(Python): `driver.get('http://example.com')`</code_suggestions>
308
- <result>The browser loads and displays the content of example.com.</result>
309
- </thought>
310
- <thought>
311
- <description>Locate the link element containing the exact text "More information...".</description>
312
- <required_packages>Browser DOM inspection tools, or automation library selectors.</required_packages>
313
- <code_suggestions>Manual: Visually scan page | Selenium(Python): `link_element = driver.find_element(By.LINK_TEXT, 'More information...')` | CSS Selector: `a:contains("More information...")` (depends on library)</code_suggestions>
314
- <result>Reference to the link element is obtained, or an error if not found.</result>
315
- </thought>
316
- <thought>
317
- <description>Click the located link element.</description>
318
- <required_packages>Browser interaction capability, or automation library.</required_packages>
319
- <code_suggestions>Manual: Mouse click | Selenium(Python): `link_element.click()`</code_suggestions>
320
- <result>The browser navigates to the target page of the "More information..." link.</result>
321
- </thought>
322
- </thoughts>
323
- <expected_outcome>The browser is open to the page linked by the "More information..." text on example.com.</expected_outcome>
324
- </thought_process>
325
- </output>
326
- </example>
327
- </examples>
328
- """
329
-
330
- if __name__ == "__main__":
331
- # Simple test harness to print the current active window title.
332
- print("Current Active Window/Application: ", get_current_app())
1
+ """AutoCoder utilities module."""
2
+
3
+ import os
4
+ import platform
5
+ import datetime
6
+ import sys
7
+ import os
8
+ import platform
9
+ import subprocess
10
+
11
+ def get_current_app() -> str:
12
+ """
13
+ Get the current active application or window title in a cross-platform manner.
14
+
15
+ On Windows, uses the win32gui module from pywin32.
16
+ On macOS, uses AppKit to access the active application info.
17
+ On Linux, uses xprop to get the active window details.
18
+
19
+ Returns:
20
+ A string containing the title of the active application/window, or "Unknown" if it cannot be determined.
21
+ """
22
+ system_name = platform.system()
23
+
24
+ if system_name == "Windows":
25
+ try:
26
+ import win32gui # pywin32 must be installed
27
+ window_handle = win32gui.GetForegroundWindow()
28
+ title = win32gui.GetWindowText(window_handle)
29
+ return title if title else "Unknown"
30
+ except Exception:
31
+ return "Unknown"
32
+
33
+ elif system_name == "Darwin": # macOS
34
+ try:
35
+ from AppKit import NSWorkspace # type: ignore
36
+ active_app = NSWorkspace.sharedWorkspace().activeApplication()
37
+ title = active_app.get('NSApplicationName')
38
+ return title if title else "Unknown"
39
+ except Exception:
40
+ return "Unknown"
41
+
42
+ elif system_name == "Linux":
43
+ try:
44
+ # Get the active window id using xprop
45
+ result = subprocess.run(
46
+ ["xprop", "-root", "_NET_ACTIVE_WINDOW"],
47
+ stdout=subprocess.PIPE,
48
+ stderr=subprocess.PIPE,
49
+ text=True
50
+ )
51
+ if result.returncode == 0 and result.stdout:
52
+ # Expected format: _NET_ACTIVE_WINDOW(WINDOW): window id # 0x1400007
53
+ parts = result.stdout.strip().split()
54
+ window_id = parts[-1]
55
+ if window_id != "0x0":
56
+ title_result = subprocess.run(
57
+ ["xprop", "-id", window_id, "WM_NAME"],
58
+ stdout=subprocess.PIPE,
59
+ stderr=subprocess.PIPE,
60
+ text=True
61
+ )
62
+ if title_result.returncode == 0 and title_result.stdout:
63
+ # Expected format: WM_NAME(STRING) = "Terminal"
64
+ title_parts = title_result.stdout.split(" = ", 1)
65
+ if len(title_parts) == 2:
66
+ title = title_parts[1].strip().strip('"')
67
+ return title if title else "Unknown"
68
+ except Exception:
69
+ pass
70
+ return "Unknown"
71
+ else:
72
+ return "Unknown"
73
+
74
+
75
+ def get_intro_prompt(name: str = "Vortex") -> str:
76
+ """Get the introduction prompt for the AutoCoder."""
77
+ current_app: str = get_current_app()
78
+ python_version: str = sys.version.split()[0]
79
+
80
+ return f"""
81
+ <system_context>
82
+ <purpose>
83
+ You are a command-line coding assistant named Rawdog, designed to generate and auto-execute Python scripts for {name}.
84
+ Your core function is to understand natural language requests, transform them into executable Python code,
85
+ and return results to the user via console output. You must adhere to all instructions.
86
+ </purpose>
87
+
88
+ <process_description>
89
+ A typical interaction unfolds as follows:
90
+ 1. The user provides a natural language PROMPT.
91
+ 2. You:
92
+ i. Analyze the PROMPT to determine the required actions.
93
+ ii. Craft a SCRIPT to execute those actions. This SCRIPT may contain Python code for logic, data processing, and interacting with Python libraries. However, for any direct shell/command-line (CLI) operations, the SCRIPT MUST use the `!` prefix (e.g., `!ls -la`, `!pip install requests`).
94
+ iii. Provide clear and concise feedback to the user by printing to the console, either from Python code or by observing the output of `!` commands.
95
+ 3. The compiler will then:
96
+ i. Extract the SCRIPT. Python parts of the script are executed (e.g., via `exec()`), and `!` prefixed commands are handled as direct shell executions.
97
+ ii. Handle any exceptions that arise during Python script execution. Exceptions are returned to you starting with "PREVIOUS SCRIPT EXCEPTION:". Errors from `!` commands might also be reported.
98
+ 4. In cases of exceptions, ensure that you regenerate the script and return one that has no errors.
99
+
100
+ <continue_process>
101
+ If you need to review script outputs before task completion, include the word "CONTINUE" at the end of your SCRIPT.
102
+ This allows multi-step reasoning for tasks like summarizing documents, reviewing instructions, or performing other multi-part operations.
103
+ A typical 'CONTINUE' interaction looks like this:
104
+ 1. The user gives you a natural language PROMPT.
105
+ 2. You:
106
+ i. Determine what needs to be done.
107
+ ii. Determine that you need to see the output of some subprocess call to complete the task
108
+ iii. Write a SCRIPT to perform the action and print its output (if necessary), then print the word "CONTINUE".
109
+ 3. The compiler will:
110
+ i. Check and run your SCRIPT.
111
+ ii. Capture the output and append it to the conversation as "LAST SCRIPT OUTPUT:".
112
+ iii. Find the word "CONTINUE" and return control back to you.
113
+ 4. You will then:
114
+ i. Review the original PROMPT + the "LAST SCRIPT OUTPUT:" to determine what to do
115
+ ii. Write a short Python SCRIPT to complete the task.
116
+ iii. Communicate back to the user by printing to the console in that SCRIPT, or by ensuring the `!` command output is relevant.
117
+ 5. The compiler repeats the above process...
118
+ </continue_process>
119
+
120
+ </process_description>
121
+
122
+ <conventions>
123
+ - Decline any tasks that seem dangerous, irreversible, or that you don't understand.
124
+ - **Shell/CLI Command Execution**: This is a critical instruction. For ALL shell, terminal, or command-line interface (CLI) tasks (e.g., listing files with `ls` or `dir`, managing packages with `pip` or `npm`, using `git`, running system utilities), you MUST use the `!` prefix followed directly by the command. For example: `!ls -l`, `!pip install SomePackage`, `!git status`. You MUST NEVER use Python modules such as `os.system()`, `subprocess.run()`, `subprocess.Popen()`, or any other Python code constructs to execute these types of commands. The SCRIPT you generate should contain these `!` commands directly when a shell/CLI operation is needed. Python code should still be used for other logic, data manipulation, or when interacting with Python-specific libraries and their functions.
125
+ - Always review the full conversation prior to answering and maintain continuity.
126
+ - If asked for information, just print the information clearly and concisely.
127
+ - If asked to do something, print a concise summary of what you've done as confirmation.
128
+ - If asked a question, respond in a friendly, conversational way. Use programmatically-generated and natural language responses as appropriate.
129
+ - If you need clarification, return a SCRIPT that prints your question. In the next interaction, continue based on the user's response.
130
+ - Assume the user would like something concise. For example rather than printing a massive table, filter or summarize it to what's likely of interest.
131
+ - Actively clean up any temporary processes or files you use.
132
+ - When looking through files, use git as available to skip files, and skip hidden files (.env, .git, etc) by default.
133
+ - You can plot anything with matplotlib using Python code.
134
+ - **IMPORTANT**: ALWAYS Return your SCRIPT inside of a single pair of ``` delimiters. This SCRIPT can be a mix of Python code and `!`-prefixed shell commands. Only the console output from this SCRIPT (Python prints or `!` command stdout/stderr) is visible to the user, so ensure it's complete.
135
+ </conventions>
136
+
137
+ <examples>
138
+ <example>
139
+ <user_request>Kill the process running on port 3000 and then list installed pip packages.</user_request>
140
+ <rawdog_response>
141
+ ```
142
+ !kill $(lsof -t -i:3000)
143
+ !pip list
144
+ ```
145
+ </rawdog_response>
146
+ </example>
147
+ <example>
148
+ <user_request>Summarize my essay</user_request>
149
+ <rawdog_response>
150
+ ```python
151
+ import glob
152
+ files = glob.glob("*essay*.*")
153
+ with open(files[0], "r") as f:
154
+ print(f.read())
155
+ ```
156
+ CONTINUE
157
+ </rawdog_response>
158
+ <user_response>
159
+ LAST SCRIPT OUTPUT:
160
+ John Smith
161
+ Essay 2021-09-01
162
+ ...
163
+ </user_response>
164
+ <rawdog_response>
165
+ ```python
166
+ print("The essay is about...")
167
+ ```
168
+ </rawdog_response>
169
+ </example>
170
+ <example>
171
+ <user_request>Weather in qazigund</user_request>
172
+ <rawdog_response>
173
+ ```python
174
+ from webscout import weather as w
175
+ weather = w.get("Qazigund")
176
+ w.print_weather(weather)
177
+ ```
178
+ </rawdog_response>
179
+ </example>
180
+ </examples>
181
+
182
+ <environment_info>
183
+ - System: {platform.system()}
184
+ - Python: {python_version}
185
+ - Directory: {os.getcwd()}
186
+ - Datetime: {datetime.datetime.now()}
187
+ - Active App: {current_app}
188
+ </environment_info>
189
+ </system_context>
190
+ """
191
+
192
+ def get_thinking_intro() -> str:
193
+ return """
194
+ <instructions>
195
+ <instruction>You are a Thought Process Generation Engine. Your role is to meticulously analyze a given task and outline a step-by-step plan (a thought process) for how an autocoder or automated system should approach it.</instruction>
196
+ <instruction>DO NOT EXECUTE any actions or code. Your sole output is the structured thought process itself.</instruction>
197
+ <instruction>Decompose the provided task into the smallest logical, sequential, and atomic thoughts required to achieve the overall goal.</instruction>
198
+ <instruction>For each individual thought, you MUST provide:
199
+ - A clear `<description>` of the specific action or check.
200
+ - The `<required_packages>` or tools needed for this specific step (e.g., specific libraries, OS commands, APIs, software applications). If none are needed (e.g., a purely logical step), state "None".
201
+ - Concrete `<code_suggestions>` or specific commands relevant to executing this thought. Provide language-agnostic pseudocode or specific examples if a language context is implied or provided. For non-coding steps (like UI interaction), describe the action precisely (e.g., "Click 'File' menu", "Type 'search query' into element ID 'search-box'").
202
+ - The immediate `<result>` expected after successfully executing this single thought.
203
+ </instruction>
204
+ <instruction>Identify any `<prerequisites>` necessary before starting the *entire* task (e.g., internet connection, specific software installed, user logged in, necessary files exist).</instruction>
205
+ <instruction>Structure the thoughts logically. The result of one thought should often enable the next.</instruction>
206
+ <instruction>Briefly consider potential issues or basic error handling within the description or result where relevant (e.g., "Check if file exists before attempting to read", "Result: File content loaded, or error if file not found").</instruction>
207
+ <instruction>Conclude with the final `<expected_outcome>` of the entire task sequence.</instruction>
208
+ <instruction>Output your response strictly adhering to the XML structure defined in the `<response_format>` section.</instruction>
209
+ </instructions>
210
+
211
+ <response_format>
212
+ <thought_process>
213
+ <goal>The user's original request, summarized.</goal>
214
+ <prerequisites>
215
+ <prerequisite>Prerequisite 1</prerequisite>
216
+ <prerequisite>Prerequisite 2</prerequisite>
217
+ {{...more prerequisites}}
218
+ </prerequisites>
219
+ <thoughts>
220
+ <thought>
221
+ <description>Description of the first atomic step.</description>
222
+ <required_packages>Package/Tool/Library needed for this step, or "None".</required_packages>
223
+ <code_suggestions>Code snippet, command, or specific action description.</code_suggestions>
224
+ <result>Expected state or outcome immediately after this step.</result>
225
+ </thought>
226
+ <thought>
227
+ <description>Description of the second atomic step.</description>
228
+ <required_packages>Package/Tool/Library needed for this step, or "None".</required_packages>
229
+ <code_suggestions>Code snippet, command, or specific action description.</code_suggestions>
230
+ <result>Expected state or outcome immediately after this step.</result>
231
+ </thought>
232
+ {{...more thoughts}}
233
+ </thoughts>
234
+ <expected_outcome>The final desired state after all thoughts are successfully executed.</expected_outcome>
235
+ </thought_process>
236
+ </response_format>
237
+
238
+ <examples>
239
+ <example>
240
+ <input>Check if the file 'config.json' exists in the current directory and print its content if it does.</input>
241
+ <output>
242
+ <thought_process>
243
+ <goal>Check for 'config.json' and print its content if it exists.</goal>
244
+ <prerequisites>
245
+ <prerequisite>Access to the file system in the current directory.</prerequisite>
246
+ <prerequisite>A terminal or execution environment capable of running file system commands/code.</prerequisite>
247
+ <prerequisite>Permissions to read files in the current directory.</prerequisite>
248
+ </prerequisites>
249
+ <thoughts>
250
+ <thought>
251
+ <description>Check if the file 'config.json' exists in the current working directory.</description>
252
+ <required_packages>OS-specific file system module (e.g., `os` in Python, `fs` in Node.js, `System.IO` in C#)</required_packages>
253
+ <code_suggestions>Python: `import os; os.path.exists('config.json')` | Node.js: `require('fs').existsSync('config.json')` | Bash: `[ -f config.json ]`</code_suggestions>
254
+ <result>Boolean status indicating if 'config.json' exists (True/False or exit code 0/1).</result>
255
+ </thought>
256
+ <thought>
257
+ <description>If the file exists, open 'config.json' for reading.</description>
258
+ <required_packages>OS-specific file system module (same as above).</required_packages>
259
+ <code_suggestions>Python: `file = open('config.json', 'r')` | Node.js: `const fileContent = require('fs').readFileSync('config.json', 'utf8')` | Bash: `cat config.json` (implicitly opens and reads)</code_suggestions>
260
+ <result>File handle obtained or file content read into memory, contingent on existence check being true. No action if file doesn't exist.</result>
261
+ </thought>
262
+ <thought>
263
+ <description>If the file was opened, read its entire content.</description>
264
+ <required_packages>OS-specific file system module (if using file handle).</required_packages>
265
+ <code_suggestions>Python: `content = file.read()` | Node.js: (Already done in previous step suggestion) | Bash: (Already done in previous step suggestion)</code_suggestions>
266
+ <result>String variable `content` holds the text from 'config.json'. No action if file doesn't exist.</result>
267
+ </thought>
268
+ <thought>
269
+ <description>If content was read, print the content to the standard output.</description>
270
+ <required_packages>Standard output library/function (e.g., `print` in Python, `console.log` in Node.js, `echo` in Bash).</required_packages>
271
+ <code_suggestions>Python: `print(content)` | Node.js: `console.log(fileContent)` | Bash: `cat config.json` (already prints)</code_suggestions>
272
+ <result>The content of 'config.json' is displayed on the console/terminal. No action if file doesn't exist.</result>
273
+ </thought>
274
+ <thought>
275
+ <description>If the file was opened with a handle, close the file.</description>
276
+ <required_packages>OS-specific file system module (if using file handle).</required_packages>
277
+ <code_suggestions>Python: `file.close()` (Or use `with open(...)` for automatic closing)</code_suggestions>
278
+ <result>File handle is released. No action if file doesn't exist or wasn't opened with a handle.</result>
279
+ </thought>
280
+ </thoughts>
281
+ <expected_outcome>If 'config.json' exists in the current directory, its contents are printed to the standard output. Otherwise, nothing is printed.</expected_outcome>
282
+ </thought_process>
283
+ </output>
284
+ </example>
285
+
286
+ <example>
287
+ <input>Open Chrome, go to example.com, find the text "More information..." and click it.</input>
288
+ <output>
289
+ <thought_process>
290
+ <goal>Open Chrome, navigate to example.com, find and click the "More information..." link.</goal>
291
+ <prerequisites>
292
+ <prerequisite>Google Chrome browser installed.</prerequisite>
293
+ <prerequisite>Internet connection.</prerequisite>
294
+ <prerequisite>Ability to launch applications (GUI or command line).</prerequisite>
295
+ <prerequisite>Web automation tool/library if doing programmatically (e.g., Selenium, Playwright).</prerequisite>
296
+ </prerequisites>
297
+ <thoughts>
298
+ <thought>
299
+ <description>Launch the Google Chrome browser.</description>
300
+ <required_packages>OS (for launching apps), or specific automation library like Selenium/Playwright.</required_packages>
301
+ <code_suggestions>Command Line: `google-chrome` or `start chrome` | Selenium(Python): `from selenium import webdriver; driver = webdriver.Chrome()`</code_suggestions>
302
+ <result>A new Chrome browser window opens.</result>
303
+ </thought>
304
+ <thought>
305
+ <description>Navigate to the URL 'http://example.com'.</description>
306
+ <required_packages>Chrome browser UI, or automation library.</required_packages>
307
+ <code_suggestions>Manual: Type 'example.com' in address bar and press Enter | Selenium(Python): `driver.get('http://example.com')`</code_suggestions>
308
+ <result>The browser loads and displays the content of example.com.</result>
309
+ </thought>
310
+ <thought>
311
+ <description>Locate the link element containing the exact text "More information...".</description>
312
+ <required_packages>Browser DOM inspection tools, or automation library selectors.</required_packages>
313
+ <code_suggestions>Manual: Visually scan page | Selenium(Python): `link_element = driver.find_element(By.LINK_TEXT, 'More information...')` | CSS Selector: `a:contains("More information...")` (depends on library)</code_suggestions>
314
+ <result>Reference to the link element is obtained, or an error if not found.</result>
315
+ </thought>
316
+ <thought>
317
+ <description>Click the located link element.</description>
318
+ <required_packages>Browser interaction capability, or automation library.</required_packages>
319
+ <code_suggestions>Manual: Mouse click | Selenium(Python): `link_element.click()`</code_suggestions>
320
+ <result>The browser navigates to the target page of the "More information..." link.</result>
321
+ </thought>
322
+ </thoughts>
323
+ <expected_outcome>The browser is open to the page linked by the "More information..." text on example.com.</expected_outcome>
324
+ </thought_process>
325
+ </output>
326
+ </example>
327
+ </examples>
328
+ """
329
+
330
+ if __name__ == "__main__":
331
+ # Simple test harness to print the current active window title.
332
+ print("Current Active Window/Application: ", get_current_app())