agex 0.2.6 → 0.2.8

package/dist/cli.js

@@ -1,23 +1,592 @@
 #!/usr/bin/env node
-import { defineCommand, runMain } from 'citty';
-import browseCommand from './commands/browse.js';
-import proveCommand from './commands/prove.js';
-import provePrCommand from './commands/prove-pr.js';
-import reviewCommand from './commands/review.js';
-import runCommand from './commands/run.js';
-const main = defineCommand({
-    meta: {
-        name: 'agex',
-        version: '0.1.2',
-        description: 'AI-powered automation toolkit',
-    },
-    subCommands: {
-        browse: browseCommand,
-        prove: proveCommand,
-        'prove-pr': provePrCommand,
-        review: reviewCommand,
-        run: runCommand,
+import {
+  AGENT_NAMES,
+  APPROVAL_POLICIES,
+  OUTPUT_MODES,
+  detectDefaultBranch,
+  isAgexError,
+  prove,
+  proveOptionsSchema,
+  provePr,
+  runAgent,
+  runReview,
+  validate,
+  viewportStringSchema
+} from "./chunk-FCCNIKUD.js";
+
+// src/cli.ts
+import { defineCommand as defineCommand6, runMain } from "citty";
+
+// src/commands/browse.ts
+import { defineCommand } 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 = 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: "prove",
+    description: "Prove visual assertions with screenshots"
+  },
+  args: {
+    assertion: {
+      type: "positional",
+      description: "The assertion to prove",
+      required: true
+    },
+    agent: {
+      type: "string",
+      alias: "a",
+      description: "Agent to use: cursor (default), claude, codex",
+      default: "cursor"
+    },
+    url: {
+      type: "string",
+      alias: "u",
+      description: "URL to navigate to"
+    },
+    output: {
+      type: "string",
+      alias: "o",
+      description: "Output directory",
+      default: "./prove-results"
+    },
+    video: {
+      type: "boolean",
+      description: "Enable video recording",
+      default: true
+    },
+    screenshots: {
+      type: "boolean",
+      description: "Enable screenshots",
+      default: true
+    },
+    model: {
+      type: "string",
+      alias: "m",
+      description: "Model to use"
+    },
+    timeout: {
+      type: "string",
+      alias: "t",
+      description: "Timeout in milliseconds",
+      default: "300000"
+    },
+    viewport: {
+      type: "string",
+      description: "Viewport size (WxH)",
+      default: "1920x1080"
+    },
+    headless: {
+      type: "boolean",
+      description: "Run headless",
+      default: true
+    },
+    browser: {
+      type: "string",
+      alias: "b",
+      description: "Browser mode: mcp (default) or cli (agent-browser)",
+      default: "mcp"
+    }
+  },
+  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);
+    }
+    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,
+      outputDir: args.output,
+      video: args.video,
+      screenshots: args.screenshots,
+      model: args.model,
+      timeout: args.timeout ? parseInt(args.timeout, 10) : void 0,
+      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 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");
+    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);
+    }
+    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("========================================");
+    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 defineCommand5 } from "citty";
+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;
+  }
+}
+var run_default = defineCommand5({
+  meta: {
+    name: "run",
+    description: "Execute AI agent tasks"
+  },
+  args: {
+    prompt: {
+      type: "positional",
+      description: "The prompt to execute",
+      required: true
+    },
+    agent: {
+      type: "string",
+      alias: "a",
+      description: "Agent to use: cursor, claude, codex (auto-detected if not specified)"
+    },
+    model: {
+      type: "string",
+      alias: "m",
+      description: "Model to use"
+    },
+    install: {
+      type: "boolean",
+      description: "Run install command before agent",
+      default: false
+    },
+    installCommand: {
+      type: "string",
+      description: "Custom install command"
+    },
+    requireApiKey: {
+      type: "boolean",
+      description: "Require API key",
+      default: false
+    },
+    approveMcps: {
+      type: "boolean",
+      description: "Auto-approve MCPs",
+      default: true
+    },
+    browser: {
+      type: "boolean",
+      description: "Enable browser",
+      default: true
+    },
+    stream: {
+      type: "boolean",
+      description: "Enable streaming output",
+      default: true
+    },
+    mode: {
+      type: "string",
+      description: "Output mode: text, json, debug",
+      default: "text"
+    },
+    approval: {
+      type: "string",
+      description: "Approval policy: never, on-request, on-failure, untrusted"
+    },
+    timeout: {
+      type: "string",
+      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;
+    const request = {
+      agent: args.agent,
+      prompt: args.prompt,
+      model: args.model,
+      install: args.install,
+      installCommand: args.installCommand,
+      requireApiKey: args.requireApiKey,
+      approveMcps: args.approveMcps,
+      browser: args.browser,
+      streamOutput,
+      quietOutput,
+      approvalPolicy: args.approval,
+      timeoutMs: args.timeout ? parseInt(args.timeout, 10) : void 0
+    };
+    try {
+      const result = await runAgent(request);
+      const output = formatOutput(result, outputMode, streamOutput);
+      if (output !== null) {
+        process.stdout.write(`${output}
+`);
+      }
+    } 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/cli.ts
+var main = defineCommand6({
+  meta: {
+    name: "agex",
+    version: "0.1.2",
+    description: "AI-powered automation toolkit"
+  },
+  subCommands: {
+    browse: browse_default,
+    prove: prove_default,
+    "prove-pr": prove_pr_default,
+    review: review_default,
+    run: run_default
+  }
 });
 runMain(main);
-//# sourceMappingURL=cli.js.map

package/dist/index.js

@@ -1,6 +1,16 @@
-export { prove } from 'agex-prove';
-export { provePr } from 'agex-prove-pr';
-export { runAgent } from 'agex-agent';
-export { runReview } from 'agex-review';
-export { AgexError, isAgexError } from 'agex-core';
-//# sourceMappingURL=index.js.map
+import {
+  AgexError,
+  isAgexError,
+  prove,
+  provePr,
+  runAgent,
+  runReview
+} from "./chunk-FCCNIKUD.js";
+export {
+  AgexError,
+  isAgexError,
+  prove,
+  provePr,
+  runAgent,
+  runReview
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agex",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,12 @@
     "agex": "dist/cli.js"
   },
   "files": [
-    "dist",
+    "dist/cli.js",
+    "dist/cli.js.map",
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/chunk-*.js",
     "assets"
   ],
   "dependencies": {
@@ -21,15 +26,15 @@
     "typescript": "^5.9.3",
     "vitest": "^2.1.9",
     "agex-agent": "0.1.0",
-    "agex-browse": "0.1.0",
     "agex-core": "0.1.0",
+    "agex-browse": "0.1.0",
     "agex-prove": "0.1.0",
     "agex-prove-pr": "0.1.0",
     "agex-review": "0.1.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "bundle": "tsup && mkdir -p ./assets && cp -r ../browse/assets ./assets/assets && cp -r ../browse/scripts ./assets/scripts",
+    "bundle": "rm -rf dist assets && tsup && mkdir -p ./assets/assets ./assets/scripts && cp -r ../browse/assets/ ./assets/assets/ && cp -r ../browse/scripts/ ./assets/scripts/ && cp ../../README.md ./README.md",
     "test": "vitest run"
   }
 }