agex 0.1.0

package/dist/cli.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+import {
+  proov,
+  runAgent,
+  runReview
+} from "./chunk-KVAOIDJ4.js";
+import "./chunk-3FGK7LUI.js";
+
+// src/commands/proov.ts
+function printHelp() {
+  console.log(`
+agex proov - Prove visual assertions with screenshots
+
+USAGE:
+  agex proov "<assertion>" [options]
+
+OPTIONS:
+  --agent, -a <name>    Agent to use: cursor (default), claude, codex
+  --url, -u <url>       URL to navigate to
+  --output, -o <dir>    Output directory (default: ./proov-results)
+  --video               Enable video recording (default)
+  --no-video            Disable video recording
+  --screenshots         Enable screenshots (default)
+  --no-screenshots      Disable screenshots
+  --model, -m <model>   Model to use
+  --timeout, -t <ms>    Timeout in milliseconds
+  --viewport <WxH>      Viewport size (default: 1920x1080)
+  --headless            Run headless (default)
+  --headed              Show browser window
+  --help, -h            Show this help
+
+EXAMPLES:
+  agex proov "prove the Google logo is on the homepage" --url https://google.com
+  agex proov "verify login button exists" --agent claude --url https://example.com
+`);
+}
+function parseArgs(args) {
+  const options = {};
+  let assertion = "";
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--agent" || arg === "-a") {
+      options.agent = args[++i];
+    } else if (arg === "--url" || arg === "-u") {
+      options.url = args[++i];
+    } else if (arg === "--output" || arg === "-o") {
+      options.outputDir = args[++i];
+    } else if (arg === "--video") {
+      options.video = true;
+    } else if (arg === "--no-video") {
+      options.video = false;
+    } else if (arg === "--model" || arg === "-m") {
+      options.model = args[++i];
+    } else if (arg === "--timeout" || arg === "-t") {
+      options.timeout = parseInt(args[++i], 10);
+    } else if (arg === "--viewport") {
+      const [width, height] = args[++i].split("x").map(Number);
+      options.viewport = { width, height };
+    } else if (arg === "--headless") {
+      options.headless = true;
+    } else if (arg === "--headed") {
+      options.headless = false;
+    } else if (arg === "--screenshots") {
+      options.screenshots = true;
+    } else if (arg === "--no-screenshots") {
+      options.screenshots = false;
+    } else if (arg === "--help" || arg === "-h") {
+      printHelp();
+      process.exit(0);
+    } else if (!arg.startsWith("-")) {
+      assertion = assertion ? `${assertion} ${arg}` : arg;
+    }
+  }
+  return { assertion, options };
+}
+async function runProov(args) {
+  const { assertion, options } = parseArgs(args);
+  if (!assertion) {
+    console.error("Error: No assertion provided");
+    printHelp();
+    process.exit(1);
+  }
+  console.log("========================================");
+  console.log("agex proov");
+  console.log("========================================");
+  console.log(`Agent: ${options.agent ?? "cursor"}`);
+  console.log(`Task: ${assertion}`);
+  if (options.url) {
+    console.log(`URL: ${options.url}`);
+  }
+  console.log("========================================\n");
+  const result = await proov(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);
+}
+
+// src/commands/run.ts
+function printHelp2() {
+  console.log(`
+agex run - Execute AI agent tasks
+
+USAGE:
+  agex run --agent <name> "<prompt>" [options]
+
+OPTIONS:
+  --agent, -a <name>    Agent to use: cursor, claude, codex (required)
+  --model, -m <model>   Model to use
+  --prompt, -p <text>   Prompt (can also be positional)
+  --install             Run install command before agent
+  --install-command     Custom install command
+  --require-api-key     Require API key
+  --no-approve-mcps     Don't auto-approve MCPs
+  --no-browser          Disable browser
+  --no-stream           Disable streaming output
+  --mode <mode>         Output mode: text, json, debug
+  --approval <policy>   Approval policy
+  --timeout <ms>        Timeout in milliseconds
+  --help, -h            Show this help
+
+EXAMPLES:
+  agex run --agent cursor "build a landing page"
+  agex run --agent claude "refactor this function" --mode json
+`);
+}
+function parseArgs2(args) {
+  let agent;
+  let model;
+  let prompt = "";
+  let install = false;
+  let installCommand;
+  let timeoutMs;
+  let requireApiKey = false;
+  let approveMcps = true;
+  let browser = true;
+  let streamOutput = true;
+  let outputMode = "text";
+  let approvalPolicy;
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      printHelp2();
+      process.exit(0);
+    } else if (arg === "--agent" || arg === "-a") {
+      agent = args[i + 1];
+      i += 1;
+    } else if (arg === "--model" || arg === "-m") {
+      model = args[i + 1];
+      i += 1;
+    } else if (arg === "--prompt" || arg === "-p") {
+      prompt = args[i + 1] ?? "";
+      i += 1;
+    } else if (arg === "--install") {
+      install = true;
+    } else if (arg === "--install-command") {
+      installCommand = args[i + 1];
+      i += 1;
+    } else if (arg === "--require-api-key") {
+      requireApiKey = true;
+    } else if (arg === "--no-approve-mcps") {
+      approveMcps = false;
+    } else if (arg === "--no-browser") {
+      browser = false;
+    } else if (arg === "--no-stream") {
+      streamOutput = false;
+    } else if (arg === "--mode") {
+      const value = args[i + 1];
+      if (value === "json" || value === "text" || value === "debug") {
+        outputMode = value;
+      }
+      i += 1;
+    } else if (arg === "--approval") {
+      approvalPolicy = args[i + 1];
+      i += 1;
+    } else if (arg === "--timeout") {
+      const value = Number(args[i + 1]);
+      if (!Number.isNaN(value)) {
+        timeoutMs = value;
+      }
+      i += 1;
+    } else {
+      prompt = prompt ? `${prompt} ${arg}` : arg;
+    }
+  }
+  if (!agent) {
+    throw new Error("Missing --agent");
+  }
+  if (!prompt) {
+    throw new Error("Missing prompt");
+  }
+  const quietOutput = outputMode === "json";
+  if (quietOutput) {
+    streamOutput = false;
+  }
+  return {
+    agent,
+    model,
+    prompt,
+    install,
+    installCommand,
+    requireApiKey,
+    approveMcps,
+    browser,
+    streamOutput,
+    quietOutput,
+    outputMode,
+    approvalPolicy,
+    timeoutMs
+  };
+}
+function formatOutput(result, mode, wasStreamed) {
+  switch (mode) {
+    case "json":
+      return JSON.stringify(result.json, null, 2);
+    case "text":
+      return wasStreamed ? null : result.formattedText;
+    case "debug":
+      return `${result.text}
+
+---AGEX_JSON---
+${JSON.stringify(result.json, null, 2)}`;
+    default:
+      return null;
+  }
+}
+async function runRun(args) {
+  const request = parseArgs2(args);
+  const result = await runAgent(request);
+  const output = formatOutput(result, request.outputMode, request.streamOutput ?? true);
+  if (output !== null) {
+    process.stdout.write(`${output}
+`);
+  }
+}
+
+// src/commands/review.ts
+function printHelp3() {
+  console.log(`
+agex review - Review code changes
+
+USAGE:
+  agex review --base <ref> --agent <name> [options]
+
+OPTIONS:
+  --base <ref>          Base branch/commit to compare against (required)
+  --agent, -a <name>    Agent to use: cursor, claude, codex (required)
+  --model, -m <model>   Model to use
+  --no-worktree         Exclude worktree changes
+  --hypotheses <n>      Number of hypotheses to generate
+  --hint <text>         Additional prompt hint
+  --help, -h            Show this help
+
+EXAMPLES:
+  agex review --base main --agent cursor
+  agex review --base HEAD~3 --agent claude --hint "focus on security"
+`);
+}
+function parseArgs3(args) {
+  let baseRef = "";
+  let agent;
+  let model;
+  let includeWorktree = true;
+  let hypotheses;
+  let promptHint;
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      printHelp3();
+      process.exit(0);
+    } else if (arg === "--base") {
+      baseRef = args[i + 1] ?? "";
+      i += 1;
+    } else if (arg === "--agent" || arg === "-a") {
+      agent = args[i + 1];
+      i += 1;
+    } else if (arg === "--model" || arg === "-m") {
+      model = args[i + 1];
+      i += 1;
+    } else if (arg === "--no-worktree") {
+      includeWorktree = false;
+    } else if (arg === "--hypotheses") {
+      const value = Number(args[i + 1]);
+      if (!Number.isNaN(value)) {
+        hypotheses = value;
+      }
+      i += 1;
+    } else if (arg === "--hint") {
+      promptHint = args[i + 1];
+      i += 1;
+    }
+  }
+  if (!baseRef) {
+    throw new Error("Missing --base");
+  }
+  if (!agent) {
+    throw new Error("Missing --agent");
+  }
+  return {
+    baseRef,
+    agent,
+    model,
+    includeWorktree,
+    hypotheses,
+    promptHint
+  };
+}
+async function runReview2(args) {
+  const request = parseArgs3(args);
+  const result = await runReview(request);
+  process.stdout.write(`${result.text}
+
+---AGEX_JSON---
+${JSON.stringify(result.json, null, 2)}
+`);
+}
+
+// src/cli.ts
+var VERSION = "0.1.0";
+var COMMANDS = {
+  proov: {
+    description: "Prove visual assertions with screenshots",
+    run: runProov
+  },
+  run: {
+    description: "Execute AI agent tasks",
+    run: runRun
+  },
+  review: {
+    description: "Review code changes",
+    run: runReview2
+  }
+};
+function printHelp4() {
+  console.log(`
+agex - AI-powered automation toolkit
+
+VERSION: ${VERSION}
+
+USAGE:
+  agex <command> [options]
+
+COMMANDS:
+  proov    ${COMMANDS.proov.description}
+  run      ${COMMANDS.run.description}
+  review   ${COMMANDS.review.description}
+
+EXAMPLES:
+  agex proov "prove google has a logo" --url https://google.com
+  agex run --agent cursor "build a landing page"
+  agex review --base main --agent cursor
+
+Run 'agex <command> --help' for command-specific options.
+`);
+}
+function printVersion() {
+  console.log(`agex v${VERSION}`);
+}
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+    printHelp4();
+    process.exit(0);
+  }
+  if (args[0] === "--version" || args[0] === "-v") {
+    printVersion();
+    process.exit(0);
+  }
+  const command = args[0];
+  const commandArgs = args.slice(1);
+  if (!(command in COMMANDS)) {
+    console.error(`Unknown command: ${command}`);
+    console.error(`Run 'agex --help' for available commands.`);
+    process.exit(1);
+  }
+  try {
+    await COMMANDS[command].run(commandArgs);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+main();

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { proov } from 'agex-proov';
+export { runAgent } from 'agex-run';
+export { runReview } from 'agex-review';

package/dist/index.js

@@ -0,0 +1,11 @@
+import {
+  proov,
+  runAgent,
+  runReview
+} from "./chunk-KVAOIDJ4.js";
+import "./chunk-3FGK7LUI.js";
+export {
+  proov,
+  runAgent,
+  runReview
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "agex",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agex": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "dependencies": {
+    "execa": "^9.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.7",
+    "tsup": "^8.4.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9",
+    "agex-run": "0.1.0",
+    "agex-browse": "0.1.0",
+    "agex-proov": "0.1.0",
+    "agex-review": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "bundle": "tsup && cp -r ../browse/assets ./assets",
+    "test": "vitest run"
+  }
+}