@jkudish/jev-browser 0.1.0

package/dist/questions.js

@@ -0,0 +1,38 @@
+// The Jev question catalog — every question in one place, with the pattern it
+// follows. Changing a question here changes every consumer; link the relevant
+// TypeSafe doc when you change a design.
+import { choice, noul } from "@typesafe-ai/sdk";
+/**
+ * The primary Jev call for each step: three independent judgments over the
+ * same state. A select action adds one second-stage call for its option (see
+ * selectOptionQuestion), so "one call per step" means one primary call.
+ * Patterns: fan-out (docs.typesafe.ai/patterns/fan-out.md) — the questions
+ * cannot see each other's answers, which is what makes goal_done an honest
+ * cross-check on the action Choice rather than a rationalization of it.
+ */
+export function stepQuestions(criteria) {
+    return {
+        action: choice("Which single action best advances the task on the current page?", criteria),
+        goal_done: noul("The task's goal has been achieved: the current page and history show the sought outcome", {
+            true: "The page being viewed is the sought destination or shows the sought information",
+            false: "The goal is not yet achieved",
+        }),
+        stuck: noul("The actions so far are not making progress toward the task (repeats, loops, or no change)", {
+            true: "Recent actions repeat or nothing changes; a different strategy is needed",
+            false: "Progress is visible or the first steps are still reasonable",
+        }),
+    };
+}
+/**
+ * Second stage for native <select> elements, asked only when the step Choice
+ * picked select_eN. Option labels are the defined set; Jev picks the value.
+ * Two-stage pattern: docs.typesafe.ai (Choice cardinality is bounded at 255).
+ */
+export function selectOptionQuestion(elementDescription, options) {
+    const criteria = {};
+    options.forEach((label, i) => {
+        criteria[`o${i}`] = label.slice(0, 80);
+    });
+    return choice(`Which option should be selected in the dropdown "${elementDescription}", given the task and the page?`, criteria);
+}
+//# sourceMappingURL=questions.js.map

package/dist/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../src/questions.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgC;IAC5D,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,iEAAiE,EAAE,QAAQ,CAAC;QAC3F,SAAS,EAAE,IAAI,CAAC,yFAAyF,EAAE;YACzG,IAAI,EAAE,iFAAiF;YACvF,KAAK,EAAE,8BAA8B;SACtC,CAAC;QACF,KAAK,EAAE,IAAI,CAAC,2FAA2F,EAAE;YACvG,IAAI,EAAE,0EAA0E;YAChF,KAAK,EAAE,6DAA6D;SACrE,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,kBAA0B,EAAE,OAAiB;IAChF,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CACX,oDAAoD,kBAAkB,iCAAiC,EACvG,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@jkudish/jev-browser",
+  "version": "0.1.0",
+  "description": "A Jev-driven browser agent as an MCP tool: give it a task and a start URL; it navigates with typed Choice actions, a typed-input cascade, and stop/stuck safety gates.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Joey Kudish",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jkudish/jev-browser.git"
+  },
+  "bin": {
+    "jev-browser": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test test/unit.test.mjs",
+    "test:e2e": "node --test test/e2e.test.mjs"
+  },
+  "postinstall": "node scripts/ensure-chromium.mjs",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typesafe",
+    "jev",
+    "browser",
+    "agent",
+    "playwright",
+    "automation"
+  ],
+  "dependencies": {
+    "@ai-sdk/anthropic": "^2.0.0",
+    "@ai-sdk/google": "^1.2.0",
+    "@ai-sdk/openai": "^2.0.0",
+    "@ai-sdk/openai-compatible": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@typesafe-ai/sdk": "^0.6.0",
+    "ai": "^5.0.0",
+    "playwright": "^1.55.0",
+    "turndown": "^7.2.0",
+    "turndown-plugin-gfm": "^1.0.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/turndown": "^5.0.5",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/ensure-chromium.mjs

@@ -0,0 +1,19 @@
+// Downloads Chromium for Playwright unless it is already present or the
+// caller opted out. Keeps `npx -y github:jkudish/jev-browser` self-contained:
+// "packages everything it needs to navigate directly".
+import { execFileSync } from "node:child_process";
+
+if (process.env.JEV_BROWSER_SKIP_BROWSER_DOWNLOAD === "1" || process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD === "1") {
+  process.exit(0);
+}
+
+try {
+  execFileSync("npx", ["--yes", "playwright", "install", "chromium"], {
+    stdio: "inherit",
+    env: process.env,
+  });
+} catch (error) {
+  console.error("[jev-browser] chromium install failed:", error.message);
+  console.error("[jev-browser] retry manually with: npx playwright install chromium");
+  process.exit(0); // not fatal: an existing system install may still work
+}