jev-layer 0.1.0 → 0.3.0

package/integrations/template/adapter.mjs

@@ -1,87 +1,87 @@
-/*
- * Copy this file to integrations/<your-harness>/adapter.mjs.
- * The three injected functions are the only Jev/host boundaries:
- *   jevRoute(request) -> decision from jev_route
- *   jevRecordExecution(args) -> execution_receipt from jev_record_execution
- *   executeNative(capabilityId, request) -> host-owned result
- */
-
-export function createTemplateAdapter({ jevRoute, jevRecordExecution, executeNative, approve = async () => true }) {
-  for (const [name, value] of Object.entries({ jevRoute, jevRecordExecution, executeNative, approve })) {
-    if (typeof value !== "function") throw new TypeError(`${name} callback is required`);
-  }
-
-  return {
-    async run(request) {
-      let decision;
-      try {
-        decision = await jevRoute(request);
-      } catch (error) {
-        return nativeFallback("jev_unavailable", error);
-      }
-
-      if (decision?.status !== "selected" || typeof decision.selected !== "string" || decision.selected === "") {
-        return { status: "native_fallback", reason: decision?.reason ?? "no_selection", decision };
-      }
-
-      const approval = await approve(decision.selected, decision, request);
-      if (!approval) {
-        const receipt = await record(jevRecordExecution, {
-          correlation_id: decision.correlation_id,
-          harness: request.harness,
-          capability_id: decision.selected,
-          status: "not_started",
-          error: "host approval denied",
-        });
-        return { status: "native_fallback", reason: "host_confirmation_required", decision, receipt };
-      }
-
-      const started = Date.now();
-      let host;
-      try {
-        host = await executeNative(decision.selected, request, decision);
-      } catch (error) {
-        const receipt = await record(jevRecordExecution, {
-          correlation_id: decision.correlation_id,
-          harness: request.harness,
-          capability_id: decision.selected,
-          status: "failed",
-          error: boundedError(error),
-          duration_ms: Date.now() - started,
-        });
-        return { status: "native_fallback", reason: "host_execution_failed", decision, error: boundedError(error), receipt };
-      }
-
-      const receipt = await record(jevRecordExecution, {
-        correlation_id: decision.correlation_id,
-        harness: request.harness,
-        capability_id: decision.selected,
-        status: "completed",
-        result: host,
-        duration_ms: Date.now() - started,
-      });
-      return { status: "completed", decision, host, receipt };
-    },
-  };
-}
-
-async function record(jevRecordExecution, args) {
-  try {
-    return await jevRecordExecution(args);
-  } catch (error) {
-    // Execution ownership stays with the host even if receipt persistence fails.
-    return { persisted: false, error: boundedError(error) };
-  }
-}
-
-function nativeFallback(reason, error) {
-  return {
-    status: "native_fallback",
-    reason,
-    error: error ? boundedError(error) : null,
-  };
-}
-
-function boundedError(error) {
-  return String(error instanceof Error ? error.message : error).slice(0, 2_000);
-}
+/*
+ * Copy this file to integrations/<your-harness>/adapter.mjs.
+ * The three injected functions are the only Jev/host boundaries:
+ *   jevRoute(request) -> decision from jev_route
+ *   jevRecordExecution(args) -> execution_receipt from jev_record_execution
+ *   executeNative(capabilityId, request) -> host-owned result
+ */
+
+export function createTemplateAdapter({ jevRoute, jevRecordExecution, executeNative, approve = async () => true }) {
+  for (const [name, value] of Object.entries({ jevRoute, jevRecordExecution, executeNative, approve })) {
+    if (typeof value !== "function") throw new TypeError(`${name} callback is required`);
+  }
+
+  return {
+    async run(request) {
+      let decision;
+      try {
+        decision = await jevRoute(request);
+      } catch (error) {
+        return nativeFallback("jev_unavailable", error);
+      }
+
+      if (decision?.status !== "selected" || typeof decision.selected !== "string" || decision.selected === "") {
+        return { status: "native_fallback", reason: decision?.reason ?? "no_selection", decision };
+      }
+
+      const approval = await approve(decision.selected, decision, request);
+      if (!approval) {
+        const receipt = await record(jevRecordExecution, {
+          correlation_id: decision.correlation_id,
+          harness: request.harness,
+          capability_id: decision.selected,
+          status: "not_started",
+          error: "host approval denied",
+        });
+        return { status: "native_fallback", reason: "host_confirmation_required", decision, receipt };
+      }
+
+      const started = Date.now();
+      let host;
+      try {
+        host = await executeNative(decision.selected, request, decision);
+      } catch (error) {
+        const receipt = await record(jevRecordExecution, {
+          correlation_id: decision.correlation_id,
+          harness: request.harness,
+          capability_id: decision.selected,
+          status: "failed",
+          error: boundedError(error),
+          duration_ms: Date.now() - started,
+        });
+        return { status: "native_fallback", reason: "host_execution_failed", decision, error: boundedError(error), receipt };
+      }
+
+      const receipt = await record(jevRecordExecution, {
+        correlation_id: decision.correlation_id,
+        harness: request.harness,
+        capability_id: decision.selected,
+        status: "completed",
+        result: host,
+        duration_ms: Date.now() - started,
+      });
+      return { status: "completed", decision, host, receipt };
+    },
+  };
+}
+
+async function record(jevRecordExecution, args) {
+  try {
+    return await jevRecordExecution(args);
+  } catch (error) {
+    // Execution ownership stays with the host even if receipt persistence fails.
+    return { persisted: false, error: boundedError(error) };
+  }
+}
+
+function nativeFallback(reason, error) {
+  return {
+    status: "native_fallback",
+    reason,
+    error: error ? boundedError(error) : null,
+  };
+}
+
+function boundedError(error) {
+  return String(error instanceof Error ? error.message : error).slice(0, 2_000);
+}

package/package.json

@@ -1,59 +1,60 @@
-{
-  "name": "jev-layer",
-  "version": "0.1.0",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/typakon4/jev-layer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/typakon4/jev-layer/issues"
-  },
-  "homepage": "https://github.com/typakon4/jev-layer#readme",
-  "type": "module",
-  "bin": {
-    "jev": "bin/jev.mjs"
-  },
-  "files": [
-    "bin/",
-    "config/",
-    "docs/",
-    "examples/",
-    "integrations/",
-    "scripts/",
-    "src/",
-    "test/",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
-    "LICENSE",
-    "README.md",
-    "README.ru.md",
-    "README.zh-CN.md",
-    "RELEASE.md",
-    "SECURITY.md",
-    "package.json",
-    "package-lock.json"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "jev": "node bin/jev.mjs",
-    "test": "node --test test/*.test.mjs",
-    "smoke": "node scripts/smoke.mjs",
-    "benchmark": "node scripts/benchmark.mjs",
-    "openrouter:choice": "node scripts/openrouter-choice.mjs",
-    "mcp": "node src/mcp-server.mjs",
-    "fail-open-smoke": "node scripts/fail-open-smoke.mjs",
-    "codex:mcp-smoke": "node scripts/codex-mcp-smoke.mjs",
-    "replay:evaluate": "node scripts/replay-eval.mjs",
-    "receipt:mcp-smoke": "node scripts/mcp-receipt-smoke.mjs",
-    "browser:e2e": "node scripts/browser-e2e.mjs",
-    "browser:benchmark": "node scripts/browser-benchmark.mjs",
-    "supervision:e2e": "node scripts/supervision-e2e.mjs",
-    "context-filter:e2e": "node scripts/context-filter-e2e.mjs",
-    "capability:e2e": "node scripts/capability-e2e.mjs",
-    "feature-flags:smoke": "node scripts/feature-flags-smoke.mjs",
-    "clean-install-smoke": "node scripts/clean-install-smoke.mjs"
-  }
-}
+{
+  "name": "jev-layer",
+  "version": "0.3.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typakon4/jev-layer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/typakon4/jev-layer/issues"
+  },
+  "homepage": "https://github.com/typakon4/jev-layer#readme",
+  "type": "module",
+  "bin": {
+    "jev": "bin/jev.mjs"
+  },
+  "files": [
+    "bin/",
+    "config/",
+    "docs/",
+    "examples/",
+    "integrations/",
+    "scripts/",
+    "src/",
+    "test/",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
+    "README.md",
+    "README.ru.md",
+    "README.zh-CN.md",
+    "RELEASE.md",
+    "SECURITY.md",
+    "package.json",
+    "package-lock.json"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "jev": "node bin/jev.mjs",
+    "test": "node --test test/*.test.mjs",
+    "smoke": "node scripts/smoke.mjs",
+    "benchmark": "node scripts/benchmark.mjs",
+    "openrouter:choice": "node scripts/openrouter-choice.mjs",
+    "mcp": "node src/mcp-server.mjs",
+    "fail-open-smoke": "node scripts/fail-open-smoke.mjs",
+    "codex:mcp-smoke": "node scripts/codex-mcp-smoke.mjs",
+    "replay:evaluate": "node scripts/replay-eval.mjs",
+    "receipt:mcp-smoke": "node scripts/mcp-receipt-smoke.mjs",
+    "model-route:report": "node scripts/model-route-report.mjs",
+    "browser:e2e": "node scripts/browser-e2e.mjs",
+    "browser:benchmark": "node scripts/browser-benchmark.mjs",
+    "supervision:e2e": "node scripts/supervision-e2e.mjs",
+    "context-filter:e2e": "node scripts/context-filter-e2e.mjs",
+    "capability:e2e": "node scripts/capability-e2e.mjs",
+    "feature-flags:smoke": "node scripts/feature-flags-smoke.mjs",
+    "clean-install-smoke": "node scripts/clean-install-smoke.mjs"
+  }
+}

package/scripts/benchmark.mjs

@@ -1,35 +1,35 @@
-import { routeRequest } from "../src/route.mjs";
-
-const capabilities = [
-  { id: "repo_search", kind: "mcp", name: "Repository search", description: "Search repository files and symbols", permissions: ["read"], risk: "low" },
-  { id: "browser_inspect", kind: "mcp", name: "Browser inspection", description: "Open and inspect webpages", permissions: ["browser"], risk: "medium" },
-  { id: "terminal_read", kind: "cli", name: "Read-only terminal", description: "Run read-only terminal commands", permissions: ["terminal:read"], risk: "low" },
-  { id: "file_write", kind: "tool", name: "File writer", description: "Modify repository files", permissions: ["write"], risk: "high" },
-];
-const request = {
-  harness: "benchmark",
-  intent: "Search repository files for the routing implementation",
-  context: { workspace: "jev-layer" },
-  actor_permissions: ["read"],
-  capabilities,
-};
-const samples = [];
-const started = performance.now();
-for (let index = 0; index < 1_000; index += 1) {
-  const before = performance.now();
-  await routeRequest(request, { provider: "demo" });
-  samples.push(performance.now() - before);
-}
-samples.sort((left, right) => left - right);
-const percentile = (p) => Number(samples[Math.min(samples.length - 1, Math.floor(samples.length * p))].toFixed(3));
-console.log(JSON.stringify({
-  provider: "jev-demo",
-  iterations: samples.length,
-  total_ms: Number((performance.now() - started).toFixed(3)),
-  p50_ms: percentile(0.5),
-  p95_ms: percentile(0.95),
-  p99_ms: percentile(0.99),
-  provider_calls_per_route: 1,
-  host_execution_calls: 0,
-  paid_provider_calls: 0,
-}));
+import { routeRequest } from "../src/route.mjs";
+
+const capabilities = [
+  { id: "repo_search", kind: "mcp", name: "Repository search", description: "Search repository files and symbols", permissions: ["read"], risk: "low" },
+  { id: "browser_inspect", kind: "mcp", name: "Browser inspection", description: "Open and inspect webpages", permissions: ["browser"], risk: "medium" },
+  { id: "terminal_read", kind: "cli", name: "Read-only terminal", description: "Run read-only terminal commands", permissions: ["terminal:read"], risk: "low" },
+  { id: "file_write", kind: "tool", name: "File writer", description: "Modify repository files", permissions: ["write"], risk: "high" },
+];
+const request = {
+  harness: "benchmark",
+  intent: "Search repository files for the routing implementation",
+  context: { workspace: "jev-layer" },
+  actor_permissions: ["read"],
+  capabilities,
+};
+const samples = [];
+const started = performance.now();
+for (let index = 0; index < 1_000; index += 1) {
+  const before = performance.now();
+  await routeRequest(request, { provider: "demo" });
+  samples.push(performance.now() - before);
+}
+samples.sort((left, right) => left - right);
+const percentile = (p) => Number(samples[Math.min(samples.length - 1, Math.floor(samples.length * p))].toFixed(3));
+console.log(JSON.stringify({
+  provider: "jev-demo",
+  iterations: samples.length,
+  total_ms: Number((performance.now() - started).toFixed(3)),
+  p50_ms: percentile(0.5),
+  p95_ms: percentile(0.95),
+  p99_ms: percentile(0.99),
+  provider_calls_per_route: 1,
+  host_execution_calls: 0,
+  paid_provider_calls: 0,
+}));

package/scripts/browser-benchmark.mjs

@@ -1,92 +1,92 @@
-import { runBrowserFastPath } from "../src/browser.mjs";
-
-const iterations = Number(process.env.JEV_BROWSER_BENCHMARK_ITERATIONS ?? 25);
-const baseline = [];
-const jev = [];
-
-for (let iteration = 0; iteration < iterations; iteration += 1) {
-  baseline.push(await runBaseline());
-  jev.push(await runJev());
-}
-
-const report = {
-  ok: true,
-  iterations,
-  provider: "injected-jev-demo-choice",
-  baseline: summarize(baseline),
-  jev: summarize(jev),
-  delta: {
-    wall_time_reduction_percent: percent(mean(baseline, "wall_time_ms"), mean(jev, "wall_time_ms")),
-    main_model_turn_reduction: mean(baseline, "main_model_turns") - mean(jev, "main_model_turns"),
-    extra_jev_calls: mean(jev, "jev_calls") - mean(baseline, "jev_calls"),
-    browser_action_delta: mean(jev, "browser_actions") - mean(baseline, "browser_actions"),
-    failure_delta: mean(jev, "failures") - mean(baseline, "failures"),
-  },
-};
-console.log(JSON.stringify(report, null, 2));
-
-async function runBaseline() {
-  const started = performance.now();
-  const actions = ["scroll", "switch_tab"];
-  for (const operation of actions) await Promise.resolve(operation);
-  return {
-    wall_time_ms: elapsed(started),
-    main_model_turns: 2,
-    jev_calls: 0,
-    browser_actions: actions.length,
-    failures: 0,
-    cost_usd: 0,
-  };
-}
-
-async function runJev() {
-  let index = 0;
-  const choices = ["browser:scroll:down", "browser:switch_tab:tab-2"];
-  const result = await runBrowserFastPath({
-    goal: "scroll down and switch to the other tab",
-    enabled: true,
-    provider: {
-      name: "browser-benchmark-provider",
-      async decide({ candidates }) {
-        const requested = choices[index++] ?? "browser:handoff";
-        const choice = candidates.some((candidate) => candidate.id === requested)
-          ? requested
-          : candidates.find((candidate) => candidate.id === "browser:handoff")?.id ?? candidates[0]?.id;
-        return {
-          answers: { tool: { type: "choice", choice, probabilities: Object.fromEntries(candidates.map((candidate) => [candidate.id, candidate.id === choice ? 1 : 0])), confidence: 1 } },
-          usage: { cost: 0.0001 },
-        };
-      },
-    },
-    executor: {
-      state: 0,
-      async observe() {
-        return this.state === 0
-          ? { scroll: { up: false, down: true }, tabs: [{ id: "tab-1", active: true }, { id: "tab-2", title: "Other", active: false }] }
-          : { scroll: { up: false, down: false }, tabs: [{ id: "tab-1", active: true }, { id: "tab-2", title: "Other", active: false }] };
-      },
-      async execute() {
-        this.state += 1;
-        return { observation: await this.observe(), handoff: this.state >= 2 };
-      },
-    },
-    mainModelTurns: 1,
-  });
-  return result.metrics;
-}
-
-function summarize(rows) {
-  return Object.fromEntries(["wall_time_ms", "main_model_turns", "jev_calls", "browser_actions", "failures", "cost_usd"].map((key) => [key, mean(rows, key)]));
-}
-
-function mean(rows, key) {
-  return Number((rows.reduce((sum, row) => sum + row[key], 0) / rows.length).toFixed(3));
-}
-
-function percent(before, after) {
-  return before ? Number((((before - after) / before) * 100).toFixed(2)) : 0;
-}
-
-function elapsed(started) {
-  return Number((performance.now() - started).toFixed(3));
-}
+import { runBrowserFastPath } from "../src/browser.mjs";
+
+const iterations = Number(process.env.JEV_BROWSER_BENCHMARK_ITERATIONS ?? 25);
+const baseline = [];
+const jev = [];
+
+for (let iteration = 0; iteration < iterations; iteration += 1) {
+  baseline.push(await runBaseline());
+  jev.push(await runJev());
+}
+
+const report = {
+  ok: true,
+  iterations,
+  provider: "injected-jev-demo-choice",
+  baseline: summarize(baseline),
+  jev: summarize(jev),
+  delta: {
+    wall_time_reduction_percent: percent(mean(baseline, "wall_time_ms"), mean(jev, "wall_time_ms")),
+    main_model_turn_reduction: mean(baseline, "main_model_turns") - mean(jev, "main_model_turns"),
+    extra_jev_calls: mean(jev, "jev_calls") - mean(baseline, "jev_calls"),
+    browser_action_delta: mean(jev, "browser_actions") - mean(baseline, "browser_actions"),
+    failure_delta: mean(jev, "failures") - mean(baseline, "failures"),
+  },
+};
+console.log(JSON.stringify(report, null, 2));
+
+async function runBaseline() {
+  const started = performance.now();
+  const actions = ["scroll", "switch_tab"];
+  for (const operation of actions) await Promise.resolve(operation);
+  return {
+    wall_time_ms: elapsed(started),
+    main_model_turns: 2,
+    jev_calls: 0,
+    browser_actions: actions.length,
+    failures: 0,
+    cost_usd: 0,
+  };
+}
+
+async function runJev() {
+  let index = 0;
+  const choices = ["browser:scroll:down", "browser:switch_tab:tab-2"];
+  const result = await runBrowserFastPath({
+    goal: "scroll down and switch to the other tab",
+    enabled: true,
+    provider: {
+      name: "browser-benchmark-provider",
+      async decide({ candidates }) {
+        const requested = choices[index++] ?? "browser:handoff";
+        const choice = candidates.some((candidate) => candidate.id === requested)
+          ? requested
+          : candidates.find((candidate) => candidate.id === "browser:handoff")?.id ?? candidates[0]?.id;
+        return {
+          answers: { tool: { type: "choice", choice, probabilities: Object.fromEntries(candidates.map((candidate) => [candidate.id, candidate.id === choice ? 1 : 0])), confidence: 1 } },
+          usage: { cost: 0.0001 },
+        };
+      },
+    },
+    executor: {
+      state: 0,
+      async observe() {
+        return this.state === 0
+          ? { scroll: { up: false, down: true }, tabs: [{ id: "tab-1", active: true }, { id: "tab-2", title: "Other", active: false }] }
+          : { scroll: { up: false, down: false }, tabs: [{ id: "tab-1", active: true }, { id: "tab-2", title: "Other", active: false }] };
+      },
+      async execute() {
+        this.state += 1;
+        return { observation: await this.observe(), handoff: this.state >= 2 };
+      },
+    },
+    mainModelTurns: 1,
+  });
+  return result.metrics;
+}
+
+function summarize(rows) {
+  return Object.fromEntries(["wall_time_ms", "main_model_turns", "jev_calls", "browser_actions", "failures", "cost_usd"].map((key) => [key, mean(rows, key)]));
+}
+
+function mean(rows, key) {
+  return Number((rows.reduce((sum, row) => sum + row[key], 0) / rows.length).toFixed(3));
+}
+
+function percent(before, after) {
+  return before ? Number((((before - after) / before) * 100).toFixed(2)) : 0;
+}
+
+function elapsed(started) {
+  return Number((performance.now() - started).toFixed(3));
+}