Add get_by_prompt example

javascript-sdk/examples/first-steps/README.md

@@ -5,11 +5,11 @@ This is an example of collecting pricing data from e-commerce website using Agen
 ## Run the script
 
 - [Install AgentQL SDK](https://docs.agentql.com/javascript-sdk/installation)
-- Save this JavaScript file locally as **first_steps.js**
+- Save this JavaScript file locally as **first-steps.js**
 - Run the following command from the project's folder:
 
 ```bash
-node first_steps.js
+node first-steps.js
 ```
 
 ## Play with the query

javascript-sdk/examples/get-by-prompt/README.md

@@ -0,0 +1,17 @@
+# Example script: interact with elements leveraging getByPrompt method
+
+This is an example of levergaing getByPrompt() method to retrieve an element and interact with it using AgentQL.
+
+## Run the script
+
+- [Install AgentQL SDK](https://docs.agentql.com/javascript-sdk/installation)
+- Save this Javascript file locally as **get-by-prompt.js**
+- Run the following command from the project's folder:
+
+```bash
+node get-by-prompt.js
+```
+
+## Play with the query
+
+Install the [AgentQL Debugger Chrome extension](https://docs.agentql.com/installation/chrome-extension-installation) to play with the AgentQL query. [Learn more about the AgentQL query language](https://docs.agentql.com/agentql-query/query-intro)

javascript-sdk/examples/get-by-prompt/get-by-prompt.js

@@ -0,0 +1,37 @@
+// This example demonstrates how to leverage get_by_prompt method to interact with element by prompt text.
+
+const { wrap, configure } = require('agentql');
+const { chromium } = require('playwright');
+
+// Set the URL to the desired website
+const URL = 'https://thinking-tester-contact-list.herokuapp.com/';
+
+async function main() {
+// Configure the AgentQL API key
+  configure({
+    apiKey: process.env.AGENTQL_API_KEY, // This is the default and can be omitted.
+  });
+
+  const browser = await chromium.launch({ headless: false });
+
+  // Wrap the page to get access to the AgentQL's querying API
+  const page = await wrap(await browser.newPage());
+
+  // Navigate to the URL
+  await page.goto(URL);
+
+  // Get the sign up button by the prompt text
+  const signUpBtn = await page.getByPrompt('Sign up button');
+
+  // Click the sign up button if it exists
+  if (signUpBtn) {
+    await signUpBtn.click();
+  }
+
+  // Used only for demo purposes. It allows you to see the effect of the script.
+  await page.waitForTimeout(10000);
+
+  await browser.close();
+}
+
+main();

javascript-sdk/package.json

@@ -18,7 +18,7 @@
     "prettier": "^2.8.7"
   },
   "dependencies": {
-    "agentql": "^0.0.1",
+    "agentql": "latest",
     "openai": "^4.70.1",
     "playwright": "^1.48.2",
     "playwright-dompath": "^0.0.7"