@capagents/forgeqe 1.1.1 → 1.1.2

package/py/forgeqe_engine/skills.py

@@ -6,7 +6,7 @@ import asyncio
 import logging
 from typing import Any, Dict, List, Tuple
 
-from .prompts import text as prompt_text
+from .prompts import CONVENTIONS, text as prompt_text
 
 logger = logging.getLogger("forgeqe_engine")
 
@@ -14,11 +14,35 @@ MAX_CHOSEN = 3
 # The choice runs before the agent, outside the run's own timeout: a model that hangs here costs at most this long.
 SELECT_TIMEOUT_SECONDS = 60.0
 
-SELECT_SYSTEM = (
-    "You pick playbooks for a browser automation agent. Each playbook explains how to work with a particular kind of "
-    "website or widget. Given the agent's goal and the list of playbooks, return the names of the playbooks the goal "
-    "clearly needs (at most 3), or an empty list when none fits. Never pick a playbook only because it could be loosely related."
-)
+SELECT_SYSTEM = """
+## Role
+You select playbooks for a browser automation agent.
+
+## Objective
+Give the names of the playbooks that the goal of the agent clearly needs.
+
+## Inputs
+- The goal of the agent.
+- The playbooks: each has a name and tells how to work with one type of website or widget.
+
+## Rules
+- You MUST select a playbook only when the goal clearly needs it. The goal names its site or widget, or does the work of the playbook.
+- You MUST NOT select a playbook only because its name looks related.
+- You MUST give 3 names or fewer.
+- You MUST give an empty list when no playbook fits.
+
+## Output
+The names of the selected playbooks, exactly as the list gives them.
+
+## Examples
+### Example 1
+Goal: "Book a flight from Paris to Rome on 12 March." Playbooks: date-picker (calendar widgets), salesforce (Salesforce Lightning pages).
+Answer: date-picker. The goal picks a date. Salesforce is not part of the goal.
+
+### Example 2
+Goal: "Open the home page and check the title." Playbooks: date-picker, salesforce.
+Answer: an empty list. No playbook fits.
+""".strip()
 
 
 def _clean(catalog: List[Dict[str, Any]]) -> List[Dict[str, str]]:
@@ -49,7 +73,7 @@ async def choose_skills(llm: Any, goal: str, catalog: List[Dict[str, Any]]) -> T
         listing = "\n".join(f"- {s['name']}: {s['description']}" for s in skills)
         res = await asyncio.wait_for(
             llm.ainvoke(
-                [SystemMessage(content=prompt_text("browser-skill-select", SELECT_SYSTEM)), UserMessage(content=f"Goal:\n{goal}\n\nPlaybooks:\n{listing}")],
+                [SystemMessage(content=prompt_text("conventions", CONVENTIONS) + "\n\n" + prompt_text("browser-skill-select", SELECT_SYSTEM)), UserMessage(content=f"Goal:\n{goal}\n\nPlaybooks:\n{listing}")],
                 output_format=Choice,
             ),
             timeout=SELECT_TIMEOUT_SECONDS,

package/src/auth/signin.ts

@@ -19,7 +19,7 @@ export type AuthIO = {
   signal?: AbortSignal
 }
 
-export type SystemId = "azure_devops" | "github" | "jira" | "confluence" | "testrail" | "zephyr" | "qtest" | "xray"
+export type SystemId = "azure_devops" | "github" | "jira" | "confluence" | "testrail" | "zephyr" | "qtest" | "xray" | "browserstack" | "testmu"
 
 export const SYSTEMS: { id: SystemId; label: string; aliases: string[] }[] = [
   { id: "azure_devops", label: "Azure DevOps", aliases: ["ado", "azure", "devops", "azdo", "azure-devops"] },
@@ -30,6 +30,8 @@ export const SYSTEMS: { id: SystemId; label: string; aliases: string[] }[] = [
   { id: "zephyr", label: "Zephyr Scale", aliases: ["zephyr-scale"] },
   { id: "qtest", label: "qTest", aliases: [] },
   { id: "xray", label: "Xray Cloud", aliases: [] },
+  { id: "browserstack", label: "BrowserStack", aliases: ["bstack"] },
+  { id: "testmu", label: "TestMu AI", aliases: ["lambdatest", "lambda-test", "lt"] },
 ]
 
 /** A system id from what the user typed ("ado", "Azure DevOps", "jira"); null when it names none. */
@@ -47,6 +49,7 @@ const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/
 /** The environment variable names the config reads for each system (forgeqe.yaml can rename them). */
 export function envNames(cfg?: AppConfig) {
   const s = cfg?.sources
+  const b = cfg?.browser
   return {
     ado: { url: "ADO_ORG_URL", token: s?.ado?.tokenEnv || "ADO_PAT" },
     jira: { url: "JIRA_URL", email: s?.jira?.emailEnv || "JIRA_EMAIL", token: s?.jira?.tokenEnv || "JIRA_API_TOKEN" },
@@ -55,6 +58,8 @@ export function envNames(cfg?: AppConfig) {
     zephyr: { url: "ZEPHYR_URL", token: s?.zephyr?.tokenEnv || "ZEPHYR_API_TOKEN" },
     qtest: { url: "QTEST_URL", project: "QTEST_PROJECT_ID", token: s?.qtest?.tokenEnv || "QTEST_TOKEN" },
     xray: { url: "XRAY_URL", id: s?.xray.clientIdEnv || "XRAY_CLIENT_ID", secret: s?.xray.clientSecretEnv || "XRAY_CLIENT_SECRET" },
+    browserstack: { user: b?.remote?.provider === "browserstack" ? b.remote.usernameEnv : "BROWSERSTACK_USERNAME", key: b?.remote?.provider === "browserstack" ? b.remote.accessKeyEnv : "BROWSERSTACK_ACCESS_KEY" },
+    testmu: { user: b?.remote?.provider === "testmu" ? b.remote.usernameEnv : "LT_USERNAME", key: b?.remote?.provider === "testmu" ? b.remote.accessKeyEnv : "LT_ACCESS_KEY" },
   }
 }
 
@@ -376,6 +381,24 @@ async function signInXray(io: AuthIO, cfg?: AppConfig): Promise<SignInResult> {
   return finish(io, "xray", { via: "token", env: {}, secrets: { [names.id]: id, [names.secret]: secret } }, "API key")
 }
 
+async function signInBrowserStack(io: AuthIO, cfg?: AppConfig): Promise<SignInResult> {
+  const names = envNames(cfg).browserstack
+  io.openUrl("https://www.browserstack.com/accounts/settings")
+  io.say("Your browser shows BrowserStack account settings. Copy your BrowserStack username and access key.")
+  const user = await ask(io, "BrowserStack user name", { initial: process.env[names.user] || gitEmail() })
+  const key = await ask(io, "Paste the BrowserStack access key", { secret: true })
+  return finish(io, "browserstack", { via: "token", env: { [names.user]: user }, secrets: { [names.key]: key }, account: user }, "access key")
+}
+
+async function signInTestMu(io: AuthIO, cfg?: AppConfig): Promise<SignInResult> {
+  const names = envNames(cfg).testmu
+  io.openUrl("https://accounts.lambdatest.com/security")
+  io.say("Your browser shows the TestMu AI / LambdaTest security page. Copy your user name and access key.")
+  const user = await ask(io, "TestMu AI user name", { initial: process.env[names.user] || gitEmail() })
+  const key = await ask(io, "Paste the TestMu AI access key", { secret: true })
+  return finish(io, "testmu", { via: "token", env: { [names.user]: user }, secrets: { [names.key]: key }, account: user }, "access key")
+}
+
 /** Save one secret by its environment variable name: an LLM API key, a webhook URL, an SMTP or login password. */
 export async function saveNamedSecret(io: AuthIO, name: string): Promise<SignInResult> {
   if (!ENV_NAME.test(name)) return { ok: false, system: name, message: `"${name}" is not an environment variable name.` }
@@ -429,6 +452,10 @@ export async function signIn(io: AuthIO, system: string | undefined, cfg?: AppCo
         return await signInQtest(io, cfg)
       case "xray":
         return await signInXray(io, cfg)
+      case "browserstack":
+        return await signInBrowserStack(io, cfg)
+      case "testmu":
+        return await signInTestMu(io, cfg)
     }
     return { ok: false, system: id, message: "Unknown system." }
   } catch (err) {
@@ -486,6 +513,8 @@ export function authStatus(cfg?: AppConfig): string[] {
     row("zephyr", "Zephyr Scale", source([n.zephyr.token])),
     row("qtest", "qTest", cfg?.sources.qtest || process.env[n.qtest.url] ? source([n.qtest.token]) : null),
     row("xray", "Xray Cloud", source([n.xray.id, n.xray.secret])),
+    row("browserstack", "BrowserStack", source([n.browserstack.user, n.browserstack.key])),
+    row("testmu", "TestMu AI", source([n.testmu.user, n.testmu.key])),
   ]
   const extra = Object.keys(saved).filter((k) => k.startsWith("env:")).map((k) => k.slice(4))
   if (extra.length) lines.push(`${"Other secrets".padEnd(14)}${extra.join(", ")}`)