@capagents/forgeqe 1.3.2 → 2.0.0

package/src/run.ts

@@ -4,6 +4,7 @@ import { createRequire } from "node:module"
 import path from "node:path"
 
 import { assertGoalUrlsAllowed, hostAllowed, normalizeHttpUrl } from "./guard.ts"
+import { ghAuthToken } from "./cases/github.ts"
 import { missingKey } from "./llm.ts"
 import type { AgentEvent, ReplayMode, RunResult } from "./types.ts"
 import { browserConfigFor, type AppConfig, type BrowserProvider } from "./config.ts"
@@ -21,7 +22,9 @@ import { historyFile, recordQuality } from "./quality/history.ts"
 import { compareVisual, engineVisual } from "./quality/visual.ts"
 import { enginePrompts, prompt } from "./prompts.ts"
 import { knowledgeBlock, readKnowledge, relevantKnowledge } from "./knowledge.ts"
+import { environmentBrief } from "./environments.ts"
 import { registryMode } from "./registry/index.ts"
+import { guardrailsNotes } from "./guardrails.ts"
 
 export type ExecuteOptions = {
   config: AppConfig
@@ -211,7 +214,7 @@ export async function executeRun(opts: ExecuteOptions): Promise<{ result: RunRes
     return withReport(out)
   }
 
-  const missing = missingKey(opts.config.llm)
+  const missing = missingKey(opts.config.llm, "engine", ghAuthToken)
   if (missing) throw new Error(missing)
   // A remote grid's keys are checked here, before the engine starts, rather than failing inside it.
   if (browser.remote) {
@@ -220,9 +223,10 @@ export async function executeRun(opts: ExecuteOptions): Promise<{ result: RunRes
   }
   const log = (text: string) => opts.onEvent?.({ type: "log", level: "info", text })
   const python = await ensureEngine(log)
-  // The browser agent's added instructions: forgeqe.yaml's, prompts/browser-extra.md, and the product knowledge that matches the goal.
+  // The browser agent's added instructions: forgeqe.yaml's, prompts/browser-extra.md, the product knowledge that matches the goal, and the guardrails.
   const knowledge = opts.config.knowledge && opts.config.knowledge.browserMaxChars > 0 ? knowledgeBlock(relevantKnowledge(readKnowledge(opts.config.knowledge.dir), goal, opts.config.knowledge.browserMaxChars, 2)) : ""
-  const extend = [opts.config.prompts.guiderails, opts.config.prompts.stepInstruction, prompt("browser-extra"), knowledge]
+  // The team's guardrails come last, so nothing added after them reads as overriding them.
+  const extend = [opts.config.prompts.stepInstruction, prompt("browser-extra"), knowledge, environmentBrief(opts.config, "browser"), guardrailsNotes(opts.config) || ""]
     .map((s) => s.trim())
     .filter(Boolean)
     .join("\n\n")

package/src/tokenomics/ledger.ts

@@ -18,7 +18,7 @@ import { costOf, recordUsage, type Price, type Role } from "../usage.ts"
 export type Trigger = "tui" | "cli" | "mcp" | "ci" | "monitor" | "schedule"
 
 /** What a call was for, from the tools it asked for: no tools is the model thinking or answering. */
-export type Purpose = "reasoning" | "planning" | "search" | "file read" | "edit" | "shell" | "browser" | "integration" | "delegation" | "unattributed"
+export type Purpose = "reasoning" | "planning" | "search" | "file read" | "edit" | "shell" | "browser" | "desktop" | "mobile" | "integration" | "delegation" | "unattributed"
 
 /** What ForgeQE was doing when the call was made. Set with withUsageScope; inner scopes add to outer ones. */
 export type UsageScope = {
@@ -130,6 +130,8 @@ export function purposeOf(tools: string[] | undefined): Purpose {
 const DEFAULT_JOB: Record<Role, string> = {
   "ForgeQE's agent": "chat",
   "browser agent": "browser test",
+  "desktop agent": "desktop test",
+  "mobile agent": "mobile test",
   Scribe: "write tests",
   reviewer: "review",
   judge: "eval",

package/src/tui/App.tsx

@@ -15,6 +15,7 @@ import { FAILURE_ACTION, FAILURE_LABEL } from "../cases/failure.ts"
 import { authStatus, openInBrowser, signIn, signOut, type AuthIO } from "../auth/signin.ts"
 import { HELP, parseCommand } from "../commands.ts"
 import { loadConfig, selectProfile, type AppConfig, type BrowserProvider } from "../config.ts"
+import { appsText, exportEnvironment, withEnvironment } from "../environments.ts"
 import { TOOLS, type AskQuestion, type ToolEvent } from "../mcp/tools.ts"
 import type { executeRun } from "../run.ts"
 import { bundleLogs, logEvent } from "../sessionLog.ts"
@@ -1443,6 +1444,28 @@ export function App({ options }: { options: TuiOptions }) {
       }
       return
     }
+    if (cmd.type === "env") {
+      try {
+        const cfg = configRef.current
+        if (!cfg) throw new Error("Config is not loaded.")
+        if (!cmd.name) {
+          push("sys", appsText(cfg))
+          return
+        }
+        configRef.current = withEnvironment(cfg, cmd.name)
+        exportEnvironment(configRef.current)
+        // Reloads in this session (/init, a profile switch) keep the environment.
+        process.env.FORGEQE_ENV = cmd.name
+        push("sys", `environment  ${cmd.name}`)
+        if (brainRef.current) {
+          closeBrain()
+          push("sys", "The agent switches to this environment on your next message and keeps the conversation.")
+        }
+      } catch (err) {
+        push("err", (err as Error).message)
+      }
+      return
+    }
     if (cmd.type === "init") {
       // forgeqe init in this folder, then the session reads what it wrote: the start screen updates at once.
       try {

package/src/usage.ts

@@ -98,7 +98,7 @@ export function usageLine(usage: Usage, cost?: Cost | null): string {
 // The meter: every model session reports here, by role
 // ---------------------------------------------------------------------------------------------
 
-export type Role = "ForgeQE's agent" | "browser agent" | "Scribe" | "reviewer" | "judge" | "refiner" | "root-cause analyst"
+export type Role = "ForgeQE's agent" | "browser agent" | "desktop agent" | "mobile agent" | "Scribe" | "reviewer" | "judge" | "refiner" | "root-cause analyst"
 
 type Entry = { usage: Usage; cost?: Cost; priced: boolean }