agex 0.2.2 → 0.2.4

package/dist/cli.d.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
-import 'agex-proov';
-import 'agex-run';
+import 'agex-prove';
+import 'agex-prove-pr';
+import 'agex-agent';
 import 'agex-review';
+import 'agex-core';

package/dist/cli.js

@@ -1,19 +1,134 @@
 #!/usr/bin/env node
 import {
-  proov,
+  AGENT_NAMES,
+  APPROVAL_POLICIES,
+  OUTPUT_MODES,
+  detectDefaultBranch,
+  isAgexError,
+  prove,
+  proveOptionsSchema,
+  provePr,
   runAgent,
-  runReview
-} from "./chunk-H3CMLOXO.js";
-import "./chunk-2ZRS4JND.js";
+  runReview,
+  validate,
+  viewportStringSchema
+} from "./chunk-CY6NF2GO.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand5, runMain } from "citty";
+import { defineCommand as defineCommand6, runMain } from "citty";
 
-// src/commands/proov.ts
+// src/commands/browse.ts
 import { defineCommand } from "citty";
-var proov_default = defineCommand({
+import { execa } from "execa";
+async function installBrowser() {
+  console.log("[agex browse] Browser not found. Installing Chromium...");
+  await execa("npx", ["--yes", "playwright", "install", "chromium"], { stdio: "inherit" });
+  console.log("[agex browse] Browser installed successfully.");
+}
+async function runAgentBrowser(browserArgs) {
+  try {
+    const result = await execa("npx", ["--yes", "agent-browser", ...browserArgs], {
+      stdio: "pipe",
+      env: { ...process.env }
+    });
+    if (result.stdout) process.stdout.write(result.stdout);
+    if (result.stderr) process.stderr.write(result.stderr);
+    return { success: true, needsBrowserInstall: false };
+  } catch (error) {
+    const execaError = error;
+    const output = `${execaError.stdout ?? ""}${execaError.stderr ?? ""}`;
+    if (output.includes("Executable doesn't exist") || output.includes("npx playwright install")) {
+      return { success: false, needsBrowserInstall: true };
+    }
+    if (execaError.stdout) process.stdout.write(execaError.stdout);
+    if (execaError.stderr) process.stderr.write(execaError.stderr);
+    return { success: false, needsBrowserInstall: false };
+  }
+}
+var browse_default = defineCommand({
+  meta: {
+    name: "browse",
+    description: "Browser automation via agent-browser"
+  },
+  args: {
+    install: {
+      type: "boolean",
+      description: "Force reinstall browser",
+      default: false
+    },
+    _: {
+      type: "positional",
+      description: "agent-browser command and arguments",
+      required: false
+    }
+  },
+  async run({ args, rawArgs }) {
+    const browserArgs = rawArgs.filter((arg) => arg !== "--install");
+    if (browserArgs.length === 0) {
+      console.log(`
+agex browse - Browser automation via agent-browser
+
+USAGE:
+  agex browse <command> [options]
+
+COMMANDS:
+  All agent-browser commands are supported. Common ones:
+  
+  open <url>          Navigate to URL
+  snapshot [-i]       Get accessibility tree (use -i for interactive elements)
+  click @e1           Click element by ref
+  fill @e2 "text"     Fill input by ref
+  screenshot [path]   Take screenshot
+  close               Close browser
+
+OPTIONS:
+  --install           Force reinstall browser
+
+EXAMPLES:
+  agex browse open https://example.com
+  agex browse snapshot -i
+  agex browse click @e1
+  agex browse fill @e2 "hello@example.com"
+  agex browse screenshot page.png
+  agex browse close
+
+For full documentation, run: npx agent-browser --help
+Or visit: https://github.com/vercel-labs/agent-browser
+`);
+      return;
+    }
+    if (args.install) {
+      await installBrowser();
+      if (browserArgs.length === 0) {
+        return;
+      }
+    }
+    const firstRun = await runAgentBrowser(browserArgs);
+    if (firstRun.success) {
+      return;
+    }
+    if (firstRun.needsBrowserInstall) {
+      await installBrowser();
+      try {
+        await execa("npx", ["--yes", "agent-browser", ...browserArgs], {
+          stdio: "inherit",
+          env: { ...process.env }
+        });
+      } catch (error) {
+        const exitCode = error.exitCode ?? 1;
+        process.exit(exitCode);
+      }
+      return;
+    }
+    process.exit(1);
+  }
+});
+
+// src/commands/prove.ts
+import { defineCommand as defineCommand2 } from "citty";
+var prove_default = defineCommand2({
   meta: {
-    name: "proov",
+    name: "prove",
     description: "Prove visual assertions with screenshots"
   },
   args: {
@@ -37,7 +152,7 @@ var proov_default = defineCommand({
       type: "string",
       alias: "o",
       description: "Output directory",
-      default: "./proov-results"
+      default: "./prove-results"
     },
     video: {
       type: "boolean",
@@ -57,7 +172,8 @@ var proov_default = defineCommand({
     timeout: {
       type: "string",
       alias: "t",
-      description: "Timeout in milliseconds"
+      description: "Timeout in milliseconds",
+      default: "300000"
     },
     viewport: {
       type: "string",
@@ -77,7 +193,15 @@ var proov_default = defineCommand({
     }
   },
   async run({ args }) {
-    const [width, height] = args.viewport.split("x").map(Number);
+    if (!AGENT_NAMES.includes(args.agent)) {
+      console.error(`Invalid agent: "${args.agent}". Must be one of: ${AGENT_NAMES.join(", ")}`);
+      process.exit(1);
+    }
+    const viewportResult = viewportStringSchema.safeParse(args.viewport);
+    if (!viewportResult.success) {
+      console.error(`Invalid viewport: "${args.viewport}". Use format "WIDTHxHEIGHT" (e.g. "1920x1080")`);
+      process.exit(1);
+    }
     const options = {
       agent: args.agent,
       url: args.url,
@@ -86,37 +210,242 @@ var proov_default = defineCommand({
       screenshots: args.screenshots,
       model: args.model,
       timeout: args.timeout ? parseInt(args.timeout, 10) : void 0,
-      viewport: { width, height },
+      viewport: viewportResult.data,
       headless: args.headless
     };
+    const validated = validate(proveOptionsSchema, options);
+    if (!validated.success) {
+      console.error(`Invalid options: ${validated.error}`);
+      process.exit(1);
+    }
     console.log("========================================");
-    console.log("agex proov");
+    console.log("agex prove");
     console.log("========================================");
+    console.log(`Workspace: ${process.cwd()}`);
     console.log(`Agent: ${options.agent}`);
     console.log(`Task: ${args.assertion}`);
     if (options.url) {
       console.log(`URL: ${options.url}`);
     }
     console.log("========================================\n");
-    const result = await proov(args.assertion, options);
-    console.log("\n========================================");
-    if (result.verdict === "pass") {
-      console.log("\u2705 PASS");
-    } else if (result.verdict === "fail") {
-      console.log("\u274C FAIL");
-    } else {
-      console.log("\u23ED\uFE0F  SKIP");
+    try {
+      const result = await prove(args.assertion, options);
+      console.log("\n========================================");
+      if (result.verdict === "pass") {
+        console.log("\u2705 PASS");
+      } else if (result.verdict === "fail") {
+        console.log("\u274C FAIL");
+      } else {
+        console.log("\u23ED\uFE0F  SKIP");
+      }
+      console.log(`Reason: ${result.reason}`);
+      console.log(`Duration: ${result.durationMs}ms`);
+      console.log(`Output: ${result.outputDir}`);
+      console.log("========================================");
+      process.exit(result.verdict === "pass" ? 0 : 1);
+    } catch (err) {
+      if (isAgexError(err)) {
+        console.error(`Error [${err.code}]: ${err.message}`);
+      } else {
+        console.error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/prove-pr.ts
+import { defineCommand as defineCommand3 } from "citty";
+var prove_pr_default = defineCommand3({
+  meta: {
+    name: "prove-pr",
+    description: "Prove PR changes work with screenshots and evidence"
+  },
+  args: {
+    base: {
+      type: "string",
+      description: "Base branch/commit to compare against (auto-detected if omitted)"
+    },
+    agent: {
+      type: "string",
+      alias: "a",
+      description: "Agent to use: cursor (default), claude, codex",
+      default: "cursor"
+    },
+    url: {
+      type: "string",
+      alias: "u",
+      description: "Dev server URL for visual testing"
+    },
+    output: {
+      type: "string",
+      alias: "o",
+      description: "Output directory",
+      default: "./prove-pr-results"
+    },
+    hypotheses: {
+      type: "string",
+      description: "Number of hypotheses to generate",
+      default: "5"
+    },
+    model: {
+      type: "string",
+      alias: "m",
+      description: "Model to use"
+    },
+    viewport: {
+      type: "string",
+      description: "Viewport size (WxH)",
+      default: "1920x1080"
+    },
+    hint: {
+      type: "string",
+      description: "Additional prompt hint for hypothesis generation"
+    },
+    timeout: {
+      type: "string",
+      alias: "t",
+      description: "Timeout in milliseconds",
+      default: "300000"
+    }
+  },
+  async run({ args }) {
+    if (!AGENT_NAMES.includes(args.agent)) {
+      console.error(`Invalid agent: "${args.agent}". Must be one of: ${AGENT_NAMES.join(", ")}`);
+      process.exit(1);
     }
-    console.log(`Reason: ${result.reason}`);
-    console.log(`Duration: ${result.durationMs}ms`);
-    console.log(`Output: ${result.outputDir}`);
+    const viewportResult = viewportStringSchema.safeParse(args.viewport);
+    if (!viewportResult.success) {
+      console.error(`Invalid viewport: "${args.viewport}". Use format "WIDTHxHEIGHT" (e.g. "1920x1080")`);
+      process.exit(1);
+    }
+    const hypothesesCount = parseInt(args.hypotheses, 10);
+    if (isNaN(hypothesesCount) || hypothesesCount <= 0) {
+      console.error(`Invalid hypotheses count: "${args.hypotheses}". Must be a positive integer.`);
+      process.exit(1);
+    }
+    const request = {
+      baseRef: args.base,
+      agent: args.agent,
+      url: args.url,
+      outputDir: args.output,
+      hypothesesCount,
+      model: args.model,
+      viewport: viewportResult.data,
+      hint: args.hint,
+      timeoutMs: args.timeout ? parseInt(args.timeout, 10) : void 0
+    };
+    console.log("========================================");
+    console.log("agex prove-pr");
     console.log("========================================");
-    process.exit(result.verdict === "pass" ? 0 : 1);
+    console.log(`Base: ${request.baseRef || "(auto-detect)"}`);
+    console.log(`Agent: ${request.agent}`);
+    console.log(`Hypotheses: ${hypothesesCount}`);
+    if (request.url) console.log(`URL: ${request.url}`);
+    console.log(`Output: ${request.outputDir}`);
+    console.log("========================================\n");
+    try {
+      const result = await provePr(request);
+      console.log("\n========================================");
+      console.log("RESULTS");
+      console.log("========================================");
+      console.log(`\u2705 Passed: ${result.summary.pass}`);
+      console.log(`\u274C Failed: ${result.summary.fail}`);
+      console.log(`\u23ED\uFE0F  Skipped: ${result.summary.skip}`);
+      console.log(`Duration: ${(result.durationMs / 1e3).toFixed(1)}s`);
+      console.log(`Output: ${result.outputDir}`);
+      console.log("========================================");
+      process.exit(result.summary.fail === 0 ? 0 : 1);
+    } catch (err) {
+      if (isAgexError(err)) {
+        console.error(`Error [${err.code}]: ${err.message}`);
+      } else {
+        console.error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/review.ts
+import { defineCommand as defineCommand4 } from "citty";
+var review_default = defineCommand4({
+  meta: {
+    name: "review",
+    description: "Review code changes"
+  },
+  args: {
+    base: {
+      type: "string",
+      description: "Base branch/commit to compare against (auto-detected if omitted)"
+    },
+    agent: {
+      type: "string",
+      alias: "a",
+      description: "Agent to use: cursor, claude, codex",
+      required: true
+    },
+    model: {
+      type: "string",
+      alias: "m",
+      description: "Model to use"
+    },
+    worktree: {
+      type: "boolean",
+      description: "Include worktree changes",
+      default: true
+    },
+    hypotheses: {
+      type: "string",
+      description: "Number of hypotheses to generate"
+    },
+    hint: {
+      type: "string",
+      description: "Additional prompt hint"
+    },
+    timeout: {
+      type: "string",
+      alias: "t",
+      description: "Timeout in milliseconds",
+      default: "300000"
+    }
+  },
+  async run({ args }) {
+    if (!AGENT_NAMES.includes(args.agent)) {
+      console.error(`Invalid agent: "${args.agent}". Must be one of: ${AGENT_NAMES.join(", ")}`);
+      process.exit(1);
+    }
+    if (args.hypotheses) {
+      const h = parseInt(args.hypotheses, 10);
+      if (isNaN(h) || h <= 0) {
+        console.error(`Invalid hypotheses count: "${args.hypotheses}". Must be a positive integer.`);
+        process.exit(1);
+      }
+    }
+    try {
+      const base = args.base || detectDefaultBranch();
+      await runReview({
+        baseRef: base,
+        agent: args.agent,
+        model: args.model,
+        includeWorktree: args.worktree,
+        hypotheses: args.hypotheses ? parseInt(args.hypotheses, 10) : void 0,
+        promptHint: args.hint,
+        timeoutMs: args.timeout ? parseInt(args.timeout, 10) : void 0
+      });
+    } catch (err) {
+      if (isAgexError(err)) {
+        console.error(`Error [${err.code}]: ${err.message}`);
+      } else {
+        console.error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      process.exit(1);
+    }
   }
 });
 
 // src/commands/run.ts
-import { defineCommand as defineCommand2 } from "citty";
+import { defineCommand as defineCommand5 } from "citty";
 function formatOutput(result, mode, wasStreamed) {
   switch (mode) {
     case "json":
@@ -132,7 +461,7 @@ ${JSON.stringify(result.json, null, 2)}`;
       return null;
   }
 }
-var run_default = defineCommand2({
+var run_default = defineCommand5({
   meta: {
     name: "run",
     description: "Execute AI agent tasks"
@@ -146,8 +475,7 @@ var run_default = defineCommand2({
     agent: {
       type: "string",
       alias: "a",
-      description: "Agent to use: cursor, claude, codex",
-      required: true
+      description: "Agent to use: cursor, claude, codex (auto-detected if not specified)"
     },
     model: {
       type: "string",
@@ -194,10 +522,23 @@ var run_default = defineCommand2({
     },
     timeout: {
       type: "string",
-      description: "Timeout in milliseconds"
+      description: "Timeout in milliseconds",
+      default: "300000"
     }
   },
   async run({ args }) {
+    if (args.agent && !AGENT_NAMES.includes(args.agent)) {
+      console.error(`Invalid agent: "${args.agent}". Must be one of: ${AGENT_NAMES.join(", ")}`);
+      process.exit(1);
+    }
+    if (!OUTPUT_MODES.includes(args.mode)) {
+      console.error(`Invalid mode: "${args.mode}". Must be one of: ${OUTPUT_MODES.join(", ")}`);
+      process.exit(1);
+    }
+    if (args.approval && !APPROVAL_POLICIES.includes(args.approval)) {
+      console.error(`Invalid approval policy: "${args.approval}". Must be one of: ${APPROVAL_POLICIES.join(", ")}`);
+      process.exit(1);
+    }
     const outputMode = args.mode;
     const quietOutput = outputMode === "json";
     const streamOutput = quietOutput ? false : args.stream;
@@ -215,184 +556,37 @@ var run_default = defineCommand2({
       approvalPolicy: args.approval,
       timeoutMs: args.timeout ? parseInt(args.timeout, 10) : void 0
     };
-    const result = await runAgent(request);
-    const output = formatOutput(result, outputMode, streamOutput);
-    if (output !== null) {
-      process.stdout.write(`${output}
+    try {
+      const result = await runAgent(request);
+      const output = formatOutput(result, outputMode, streamOutput);
+      if (output !== null) {
+        process.stdout.write(`${output}
 `);
-    }
-  }
-});
-
-// src/commands/review.ts
-import { defineCommand as defineCommand3 } from "citty";
-var review_default = defineCommand3({
-  meta: {
-    name: "review",
-    description: "Review code changes"
-  },
-  args: {
-    base: {
-      type: "string",
-      description: "Base branch/commit to compare against",
-      required: true
-    },
-    agent: {
-      type: "string",
-      alias: "a",
-      description: "Agent to use: cursor, claude, codex",
-      required: true
-    },
-    model: {
-      type: "string",
-      alias: "m",
-      description: "Model to use"
-    },
-    worktree: {
-      type: "boolean",
-      description: "Include worktree changes",
-      default: true
-    },
-    hypotheses: {
-      type: "string",
-      description: "Number of hypotheses to generate"
-    },
-    hint: {
-      type: "string",
-      description: "Additional prompt hint"
-    }
-  },
-  async run({ args }) {
-    await runReview({
-      baseRef: args.base,
-      agent: args.agent,
-      model: args.model,
-      includeWorktree: args.worktree,
-      hypotheses: args.hypotheses ? parseInt(args.hypotheses, 10) : void 0,
-      promptHint: args.hint
-    });
-  }
-});
-
-// src/commands/browse.ts
-import { defineCommand as defineCommand4 } from "citty";
-import { execa } from "execa";
-async function installBrowser() {
-  console.log("[agex browse] Browser not found. Installing Chromium...");
-  await execa("npx", ["--yes", "playwright", "install", "chromium"], { stdio: "inherit" });
-  console.log("[agex browse] Browser installed successfully.");
-}
-async function runAgentBrowser(browserArgs) {
-  try {
-    const result = await execa("npx", ["--yes", "agent-browser", ...browserArgs], {
-      stdio: "pipe",
-      env: { ...process.env }
-    });
-    if (result.stdout) process.stdout.write(result.stdout);
-    if (result.stderr) process.stderr.write(result.stderr);
-    return { success: true, needsBrowserInstall: false };
-  } catch (error) {
-    const execaError = error;
-    const output = `${execaError.stdout ?? ""}${execaError.stderr ?? ""}`;
-    if (output.includes("Executable doesn't exist") || output.includes("npx playwright install")) {
-      return { success: false, needsBrowserInstall: true };
-    }
-    if (execaError.stdout) process.stdout.write(execaError.stdout);
-    if (execaError.stderr) process.stderr.write(execaError.stderr);
-    return { success: false, needsBrowserInstall: false };
-  }
-}
-var browse_default = defineCommand4({
-  meta: {
-    name: "browse",
-    description: "Browser automation via agent-browser"
-  },
-  args: {
-    install: {
-      type: "boolean",
-      description: "Force reinstall browser",
-      default: false
-    },
-    _: {
-      type: "positional",
-      description: "agent-browser command and arguments",
-      required: false
-    }
-  },
-  async run({ args, rawArgs }) {
-    const browserArgs = rawArgs.filter((arg) => arg !== "--install");
-    if (browserArgs.length === 0) {
-      console.log(`
-agex browse - Browser automation via agent-browser
-
-USAGE:
-  agex browse <command> [options]
-
-COMMANDS:
-  All agent-browser commands are supported. Common ones:
-  
-  open <url>          Navigate to URL
-  snapshot [-i]       Get accessibility tree (use -i for interactive elements)
-  click @e1           Click element by ref
-  fill @e2 "text"     Fill input by ref
-  screenshot [path]   Take screenshot
-  close               Close browser
-
-OPTIONS:
-  --install           Force reinstall browser
-
-EXAMPLES:
-  agex browse open https://example.com
-  agex browse snapshot -i
-  agex browse click @e1
-  agex browse fill @e2 "hello@example.com"
-  agex browse screenshot page.png
-  agex browse close
-
-For full documentation, run: npx agent-browser --help
-Or visit: https://github.com/vercel-labs/agent-browser
-`);
-      return;
-    }
-    if (args.install) {
-      await installBrowser();
-      if (browserArgs.length === 0) {
-        return;
       }
-    }
-    const firstRun = await runAgentBrowser(browserArgs);
-    if (firstRun.success) {
-      return;
-    }
-    if (firstRun.needsBrowserInstall) {
-      await installBrowser();
-      try {
-        await execa("npx", ["--yes", "agent-browser", ...browserArgs], {
-          stdio: "inherit",
-          env: { ...process.env }
-        });
-      } catch (error) {
-        const exitCode = error.exitCode ?? 1;
-        process.exit(exitCode);
+    } catch (err) {
+      if (isAgexError(err)) {
+        console.error(`Error [${err.code}]: ${err.message}`);
+      } else {
+        console.error(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
       }
-      return;
+      process.exit(1);
     }
-    process.exit(1);
   }
 });
 
 // src/cli.ts
-var main = defineCommand5({
+var main = defineCommand6({
   meta: {
     name: "agex",
     version: "0.1.2",
     description: "AI-powered automation toolkit"
   },
   subCommands: {
-    proov: proov_default,
-    run: run_default,
+    browse: browse_default,
+    prove: prove_default,
+    "prove-pr": prove_pr_default,
     review: review_default,
-    browse: browse_default
+    run: run_default
   }
 });
 runMain(main);

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { proov } from 'agex-proov';
-export { runAgent } from 'agex-run';
-export { runReview } from 'agex-review';
+export { ProveOptions, ProveResult, prove } from 'agex-prove';
+export { ProvePrRequest, ProvePrResult, provePr } from 'agex-prove-pr';
+export { AgentName, OutputMode, RunOutput, RunRequest, runAgent } from 'agex-agent';
+export { ReviewOutput, ReviewRequest, runReview } from 'agex-review';
+export { AgexError, Verdict, isAgexError } from 'agex-core';