@minicor/mcp-server 3.3.4 → 3.4.0

package/README.md

@@ -19,20 +19,25 @@ Build, deploy, and debug VM-based browser and desktop automations from **Cursor*
 }
 ```
 
-**Claude Code:**
+**Claude Code** — no global install needed (npx always runs the latest):
 
 ```bash
-npm install -g @minicor/mcp-server
-claude mcp add minicor -- minicor-mcp
+claude mcp add minicor -- npx -y @minicor/mcp-server
 ```
 
 ### 2. Authenticate
 
 ```bash
-npx @minicor/mcp-server
+npx -y -p @minicor/mcp-server minicor-mcp-setup
 ```
 
-Opens a browser to sign in. Tokens stored at `~/.minicor/tokens.json` with auto-refresh. For headless: `npx @minicor/mcp-server-setup --cli`.
+Opens a browser to sign in. Tokens are stored at `~/.minicor/tokens.json` with auto-refresh. For headless / SSH:
+
+```bash
+npx -y -p @minicor/mcp-server minicor-mcp-setup --cli
+```
+
+> The package ships multiple commands. Always use `npx -p @minicor/mcp-server <command>` to run a specific one (`minicor-mcp-setup`, `minicor-bootstrap`, …). Running `npx @minicor/mcp-server` alone only starts the MCP server and ignores trailing arguments.
 
 ### 3. Bootstrap Workspace (optional)
 
@@ -40,22 +45,44 @@ After cloning a workspace, generate harness-specific config files:
 
 ```bash
 # For Claude Code — creates CLAUDE.md + .claude/settings.local.json
-npx @minicor/mcp-server minicor-bootstrap claude-code --dir ./my-workspace
+npx -y -p @minicor/mcp-server minicor-bootstrap claude-code --dir ./my-workspace
 
 # For Cursor — creates .cursor/rules/workspace.mdc
-npx @minicor/mcp-server minicor-bootstrap cursor --dir ./my-workspace
+npx -y -p @minicor/mcp-server minicor-bootstrap cursor --dir ./my-workspace
 
 # All harnesses at once
-npx @minicor/mcp-server minicor-bootstrap all --dir ./my-workspace
+npx -y -p @minicor/mcp-server minicor-bootstrap all --dir ./my-workspace
 ```
 
 ### 4. Update
 
 `npx` users: restart your editor (auto-fetches latest). Global: `npm update -g @minicor/mcp-server`.
 
-## Code Mode
+## Code Mode (experimental, opt-in)
+
+By default the server exposes every Minicor operation as its own MCP tool. As an **experimental** alternative, you can enable a code-mode surface: a single `codemode` tool that runs JavaScript and provides Minicor methods as async functions on the `minicor` global.
+
+Enable it by setting the environment variable before launching the server:
+
+```bash
+EXPERIMENTAL_USE_CODE_MODE=1 minicor-mcp
+```
 
-Authenticated servers now default to a code-mode MCP surface. Instead of exposing every Minicor operation as a separate MCP tool, the server exposes one `codemode` tool that runs JavaScript and provides Minicor methods as async functions on the `minicor` global:
+In Cursor, add it to the server's `env` block in `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "minicor": {
+      "command": "npx",
+      "args": ["-y", "@minicor/mcp-server"],
+      "env": { "EXPERIMENTAL_USE_CODE_MODE": "1" }
+    }
+  }
+}
+```
+
+Once enabled:
 
 ```javascript
 const workspaces = await minicor.list_workspaces({});
@@ -73,21 +100,17 @@ Inside `codemode`:
 - `await codemode.describe("minicor.tool_name")` returns TypeScript-style parameter docs.
 - `await codemode.list()` lists all available methods.
 
-If you need the legacy one-tool-per-operation surface, set either environment variable before launching the server:
-
-```bash
-MINICOR_MCP_LEGACY_TOOLS=1 minicor-mcp
-# or
-MINICOR_MCP_CODE_MODE=0 minicor-mcp
-```
+Unset `EXPERIMENTAL_USE_CODE_MODE` to return to the default one-tool-per-operation surface.
 
 ## Session Lifecycle
 
-The MCP server sends **instructions** to every client on connect, telling agents to start a session first when in a workspace clone. In code mode, call `session_start` through the `codemode` tool:
+The MCP server sends **instructions** to every client on connect, telling agents to start a session first when in a workspace clone. Call the `session_start` tool with the workspace directory:
 
-```javascript
-return await minicor.session_start({ directory: "/path/to/workspace" });
 ```
+session_start({ directory: "/path/to/workspace" })
+```
+
+(With experimental code mode enabled, run the same call as `await minicor.session_start({ ... })` through the `codemode` tool.)
 
 This works across all harnesses, including Claude Code, Cursor, and Bedrock.
 
@@ -195,9 +218,75 @@ After a successful build:
 - Skills are stored per-workspace and available to future builds
 - Customer-specific quirks become reusable knowledge
 
+## Jobs (RPA orchestration)
+
+A **Job** is a middleware route whose behavior is a structured `definition` (a step graph) instead of freeform handler code. Jobs sit **above** workflows: a job step either calls an entire Minicor workflow (`kind: "workflow"`, by `workflowId`) or runs a code block (`kind: "code"`). The job never touches a workflow's internal steps — a workflow is an opaque callable with an input and an output. A job is the **macro zoom** (what ran, status, replays); a workflow → step is the **microscope**. This is the layer that turns one or more workflows into a versioned, testable, observable API endpoint.
+
+### The job tools
+
+| Tool | What it does |
+| --- | --- |
+| `list_middlewares` | List the routers (middlewares) in a workspace — jobs attach to one of these. |
+| `register_middleware` | Create a router jobs attach to. `autoConfigure` (default true) populates the router's `workspaceApiKey` from the workspace's first key; or pass `workspaceApiKey` explicitly. |
+| `register_job` | Create a job — a route backed by a structured `definition` (step graph). |
+| `update_job` | Update a job's `definition`, path, method, or description (snapshots a new route version). |
+| `get_job` | Get a job (route) incl. its `definition`; omit `routeId` to list all routes on the router. |
+| `run_job` | Run a job once with an input, poll to completion, return the full `JobExecution` (per-step Minicor deep-links). |
+| `add_test_case` | Attach a test case to a job: named `input` + assertions `[{ name, expr }]` (the green-gate). |
+| `run_tests` | Run a job's test suite (or a subset), poll to completion, return the report (`green`, totals, per-case). |
+| `get_test_report` | Fetch a test run report by id (totals + per-case results, each linking to its job execution). |
+| `list_workspace_api_keys` | List a workspace's API keys (id, apiKey, name) — to find a key for the two tools below. |
+| `set_middleware_api_key` | Set a router's `workspaceApiKey` after the fact, then re-read to confirm it stuck. |
+
+### The recommended build loop — test-driven → job → workflow
+
+You work **backwards from the job's test cases**. The job's test suite is the macro green-gate; individual workflows are the micro RPA underneath.
+
+```
+1. CONTRACT FIRST  — define the JOB's input/output and its test cases (the macro green-gate)
+                     via register_job + add_test_case. Cases start RED.
+2. BUILD WORKFLOWS — build/curate the Minicor workflow(s) each step will call (the micro RPA).
+3. WIRE THE STEPS  — wire workflows as `kind: "workflow"` steps with `input` mappings,
+                     plus `when` / `forEach` / `cache` / `onError` as needed.
+4. RUN TESTS       — run_tests until green: true. (run_job to inspect a single execution.)
+```
+
+A job step supports `saveAs`, `when` (conditional skip), `forEach` (fan-out), `onError` (`abort`/`skip`/`continue`/`{goto}` — `goto` currently treated as abort), `retry`, and `cache` (a login/smart-launch gate). Use `resource.lockKey` to serialize execution per desktop/VM. To migrate an existing NestJS customer middleware onto this layer, use the `nestjs-middleware-to-job` prompt or skill.
+
+### ctx / job-shape primer
+
+The `definition` you pass to `register_job` (see `register_job`'s `definition` param for the full schema):
+
+```ts
+{
+  region: "us" | "ca",                       // region awareness — also auto-detected from workspace
+  resource?: { configStoreId?, lockKey? },    // configStoreId = which VM/desktop; lockKey serializes runs
+  inputSchema:  JSONSchema,
+  outputSchema: JSONSchema,
+  steps: [ { id, name, kind, saveAs?, when?, forEach?, onError?, retry?, cache?,
+             // kind:"workflow" → workflowId + input (object with {{ctx.x}} OR a (ctx)=>({...}) code block)
+             // kind:"code"     → code: "(ctx) => ..."
+           } ],
+  output?: "(ctx) => response",               // builds the job's response from the final ctx
+}
+```
+
+**`ctx` is the data through-line** between steps — each step's `saveAs` key is what the next step reads:
+
+- `ctx` starts as `{ input: <the job input> }`.
+- Each step's result is stored at `ctx.<saveAs>` (when `saveAs` is set), so later steps / `when` / `forEach` / `output` can read it.
+- Inside a `forEach` step, the current item is `ctx.item` (results are collected into an array under `saveAs`).
+- The top-level `output` block `(ctx) => ...` builds the job's response from the accumulated `ctx`.
+
+Assertions (`add_test_case`) are TS booleans over `{ input, output, ctx, steps }`, e.g. `output.status === "COMPLETED"`. The full model + runner semantics live in the **middleware-service** repo's `README.md` ("## Jobs") and `middlewares/JOBS-DESIGN.md`.
+
+### Region & API key
+
+Jobs are **region-aware** (`us` / `ca`) — pass `region` or let it be auto-detected from the workspace. Running a job requires the router's `workspaceApiKey` to be set so a job's workflow steps can call the Laminar API: it's populated by `register_middleware`'s `autoConfigure` (default), or set later with `set_middleware_api_key` (find a key via `list_workspace_api_keys`). `register_middleware` / `set_middleware_api_key` report `workspaceApiKeyConfigured` so you can confirm it stuck.
+
 ## Skills System
 
-Skills are reusable RPA patterns that accumulate as you build automations. The MCP ships with 6 bundled general skills:
+Skills are reusable RPA patterns that accumulate as you build automations. The MCP ships with bundled general skills, including:
 
 
 | Skill                        | Purpose                                                                           |
@@ -208,6 +297,7 @@ Skills are reusable RPA patterns that accumulate as you build automations. The M
 | `data-extraction-strategies` | Priority-ordered methods for reading data from screen                             |
 | `data-passing-between-steps` | JS-layer interpolation, config variables, step outputs                            |
 | `state-verification`         | LLM-based UI verification for production workflows                                |
+| `nestjs-middleware-to-job`   | Map a NestJS middleware controller onto the Jobs layer (step graph + test cases)  |
 
 
 ### Using Skills
@@ -300,6 +390,26 @@ For manual setup, use `get_lds_setup_guide` for step-by-step instructions.
 | `preview_flow_changes` / `compare_flow_versions`           | Diff code before deploying                          |
 
 
+### Jobs & Test Cases
+
+
+| Tool                  | What it does                                                                                  |
+| --------------------- | -------------------------------------------------------------------------------------------- |
+| `list_middlewares`    | List the routers (middlewares) in a workspace — jobs attach to one of these                   |
+| `register_middleware` | Create a router (middleware) jobs attach to; `autoConfigure` populates its workspace API key  |
+| `register_job`        | Create a job — a middleware route backed by a structured `definition` (step graph)            |
+| `update_job`          | Update a job's `definition`, path, method, or description (snapshots a new route version)     |
+| `get_job`             | Get a job (route) incl. its `definition`; omit `routeId` to list all routes on the router     |
+| `run_job`             | Run a job once with an input, poll to completion, return the full `JobExecution`              |
+| `add_test_case`       | Attach a test case to a job: named `input` + assertions `[{ name, expr }]` (the green-gate)   |
+| `run_tests`           | Run a job's test suite, poll to completion, return the report (`green`, totals, per-case)     |
+| `get_test_report`     | Fetch a test run report by id (totals + per-case results, each linking to its job execution)  |
+| `list_workspace_api_keys` | List a workspace's API keys (id, apiKey, name) — find one for the two tools below          |
+| `set_middleware_api_key`  | Set a router's `workspaceApiKey` (then re-reads to confirm it stuck)                        |
+
+
+See the **Jobs (RPA orchestration)** section above for the build loop and job/ctx shape. `batch_test_rpa` can also persist each passing input as a real job test case — set `persistAsTestCases` with `routeId` + `middlewareId` + `workspaceId`.
+
 ### 2FA / OTP
 
 
@@ -410,6 +520,7 @@ Agents are autonomous runners that execute tasks on VMs using MCP tools. After b
 | `minicor-workflow-guide`     | Full workflow specification: step types, data access, keywords, libraries                                                              |
 | `2fa-workflow-guide`         | Handling 2FA in workflows: provisioning channels, TOTP secrets, auto-resolving OTP codes                                               |
 | `workspace-session-guide`    | Returns AGENTS.md rules and session state for any workspace clone                                                                      |
+| `nestjs-middleware-to-job`   | Convert an existing NestJS customer middleware endpoint into a Job (structured step graph) with test cases as the green-gate            |
 
 
 The `build-rpa-workflow` prompt accepts a `mode` parameter:
@@ -421,14 +532,26 @@ The `build-rpa-workflow` prompt accepts a `mode` parameter:
 ## Environment Variables
 
 
-| Variable             | Purpose                | Default            |
-| -------------------- | ---------------------- | ------------------ |
-| `VM_MANAGER_API_URL` | VM Manager service URL | Cloud Run instance |
+Jobs/middleware base resolution (precedence: **proxy > direct > default**):
+
+| Variable                          | Purpose                                                              | Default                |
+| --------------------------------- | ------------------------------------------------------------------- | ---------------------- |
+| `VM_MANAGER_API_URL`              | VM Manager service URL                                               | Cloud Run instance     |
+| `MIDDLEWARE_SERVICE_PROXY_BASE`   | Frontend origin fronting the middleware proxy, all regions          | unset                  |
+| `MIDDLEWARE_SERVICE_PROXY_BASE_US`| Frontend proxy origin for US (overrides the generic one)            | unset                  |
+| `MIDDLEWARE_SERVICE_PROXY_BASE_CA`| Frontend proxy origin for CA (overrides the generic one)            | unset                  |
+| `MIDDLEWARE_SERVICE_PROXY_PREFIX` | Proxy path prefix                                                    | `/api/middleware`      |
+| `MIDDLEWARE_SERVICE_URL`          | Direct middleware-service base, all regions (dev/local)             | unset                  |
+| `MIDDLEWARE_SERVICE_URL_US`       | Direct middleware-service base for US (overrides the generic one)   | unset                  |
+| `MIDDLEWARE_SERVICE_URL_CA`       | Direct middleware-service base for CA (overrides the generic one)   | unset                  |
+| `EXPERIMENTAL_USE_CODE_MODE`      | Expose the experimental single `codemode` tool surface              | unset (standard tools) |
+
+When none are set, Jobs calls the region's public middleware-service Cloud Run directly. To route through the frontend (once it deploys an `/api/middleware/[...path]` proxy), set `MIDDLEWARE_SERVICE_PROXY_BASE` (or the per-region variants).
 
 
 ## Auth
 
-- **Sign in**: `minicor-mcp-setup` (browser) or `minicor-mcp-setup --cli`
+- **Sign in**: `npx -y -p @minicor/mcp-server minicor-mcp-setup` (browser) or append `--cli` for headless
 - **Token storage**: `~/.minicor/tokens.json`
 - **Auto-refresh**: tokens refresh before expiry
 - **Regions**: US (default) or Canada

package/dist/__tests__/middleware-service-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=middleware-service-client.test.d.ts.map

package/dist/__tests__/middleware-service-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-service-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/middleware-service-client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/middleware-service-client.test.js

@@ -0,0 +1,293 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { MiddlewareServiceClient } from "../middleware-service-client.js";
+/**
+ * The client only parses the body as JSON when the response carries an
+ * `application/json` content-type, so tests must set it explicitly (this also
+ * documents the contract the frontend proxy must satisfy).
+ */
+function jsonResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+describe("MiddlewareServiceClient", () => {
+    const originalFetch = globalThis.fetch;
+    const apiBase = "https://api.minicor.com";
+    const token = "user-bearer-xyz";
+    const ws = 257;
+    const mw = "mw-1";
+    const route = "route-1";
+    // Default (deployed): the region's public middleware-service Cloud Run, hit
+    // directly at `${base}/api/workspaces/...`. (us by default for api.minicor.com.)
+    const US_DIRECT = "https://middleware-service-489511347341.northamerica-northeast1.run.app";
+    const middlewaresBase = `${US_DIRECT}/api/workspaces/257/middlewares`;
+    const routesBase = `${middlewaresBase}/mw-1/routes`;
+    const ENV_KEYS = [
+        "MIDDLEWARE_SERVICE_URL",
+        "MIDDLEWARE_SERVICE_URL_US",
+        "MIDDLEWARE_SERVICE_URL_CA",
+        "MIDDLEWARE_SERVICE_PROXY_BASE",
+        "MIDDLEWARE_SERVICE_PROXY_BASE_US",
+        "MIDDLEWARE_SERVICE_PROXY_BASE_CA",
+        "MIDDLEWARE_SERVICE_PROXY_PREFIX",
+    ];
+    const savedEnv = {};
+    let client;
+    beforeEach(() => {
+        for (const k of ENV_KEYS) {
+            savedEnv[k] = process.env[k];
+            delete process.env[k];
+        }
+        globalThis.fetch = vi.fn();
+        client = new MiddlewareServiceClient(apiBase, token);
+    });
+    afterEach(() => {
+        for (const k of ENV_KEYS) {
+            if (savedEnv[k] === undefined)
+                delete process.env[k];
+            else
+                process.env[k] = savedEnv[k];
+        }
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    function lastCall() {
+        const { calls } = vi.mocked(globalThis.fetch).mock;
+        return calls[calls.length - 1];
+    }
+    function lastUrl() {
+        return lastCall()[0];
+    }
+    function lastInit() {
+        return lastCall()[1];
+    }
+    function lastBody() {
+        return JSON.parse(lastInit().body);
+    }
+    it("defaults to the US Cloud Run (direct /api/workspaces) with the bearer token", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: "exec-1" }));
+        await client.getExecution(ws, mw, route, "exec-1");
+        expect(lastUrl()).toBe(`${routesBase}/route-1/executions/exec-1`);
+        expect(lastInit().method).toBe("GET");
+        expect(lastInit().headers.Authorization).toBe(`Bearer ${token}`);
+    });
+    it("defaults to the CA Cloud Run for a CA api base", async () => {
+        const ca = new MiddlewareServiceClient("https://ca.api.minicor.com", token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await ca.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://middleware-service-ca-ernfuwetfa-nn.a.run.app/api/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("routes through the frontend proxy when MIDDLEWARE_SERVICE_PROXY_BASE is set (/api/ stripped)", async () => {
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE = "https://app.minicor.com";
+        const proxied = new MiddlewareServiceClient(apiBase, token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await proxied.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://app.minicor.com/api/middleware/workspaces/257/middlewares/mw-1/routes");
+        expect(lastInit().headers.Authorization).toBe(`Bearer ${token}`);
+    });
+    it("uses a region-specific proxy base for CA, overriding the generic one", async () => {
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE = "https://app.laminar.run";
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE_CA = "https://ca.app.laminar.run";
+        const ca = new MiddlewareServiceClient("https://ca.api.laminar.run", token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await ca.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://ca.app.laminar.run/api/middleware/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("falls back to the generic proxy base for US when no US-specific one is set", async () => {
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE = "https://app.laminar.run";
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE_CA = "https://ca.app.laminar.run";
+        const us = new MiddlewareServiceClient("https://api.laminar.run", token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await us.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://app.laminar.run/api/middleware/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("honors a custom MIDDLEWARE_SERVICE_PROXY_PREFIX", async () => {
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE = "https://app.minicor.com";
+        process.env.MIDDLEWARE_SERVICE_PROXY_PREFIX = "api/mw-proxy";
+        const proxied = new MiddlewareServiceClient(apiBase, token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await proxied.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://app.minicor.com/api/mw-proxy/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("proxy base takes precedence over a direct override", async () => {
+        process.env.MIDDLEWARE_SERVICE_PROXY_BASE = "https://app.minicor.com";
+        process.env.MIDDLEWARE_SERVICE_URL = "https://mw.dev.example.com";
+        const proxied = new MiddlewareServiceClient(apiBase, token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await proxied.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://app.minicor.com/api/middleware/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("hits a direct base (no proxy) when MIDDLEWARE_SERVICE_URL is set", async () => {
+        process.env.MIDDLEWARE_SERVICE_URL = "https://mw.dev.example.com";
+        const direct = new MiddlewareServiceClient(apiBase, token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await direct.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://mw.dev.example.com/api/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("MIDDLEWARE_SERVICE_URL_CA overrides only the CA region", async () => {
+        process.env.MIDDLEWARE_SERVICE_URL_CA = "https://mw-ca.example.com";
+        const ca = new MiddlewareServiceClient("https://ca.api.minicor.com", token);
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([]));
+        await ca.listRoutes(ws, mw);
+        expect(lastUrl()).toBe("https://mw-ca.example.com/api/workspaces/257/middlewares/mw-1/routes");
+    });
+    it("listMiddlewares GETs the workspace middlewares", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([{ id: "mw-1" }, { id: "mw-2" }]));
+        const mws = await client.listMiddlewares(ws);
+        expect(lastUrl()).toBe(middlewaresBase);
+        expect(lastInit().method).toBe("GET");
+        expect(mws.map((m) => m.id)).toEqual(["mw-1", "mw-2"]);
+    });
+    it("createMiddleware POSTs name/slug/description", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: "mw-9", name: "AMS", slug: "ams" }));
+        await client.createMiddleware(ws, { name: "AMS", slug: "ams", description: "d" });
+        expect(lastUrl()).toBe(middlewaresBase);
+        expect(lastInit().method).toBe("POST");
+        expect(lastBody()).toEqual({ name: "AMS", slug: "ams", description: "d" });
+    });
+    it("autoConfigureMiddleware POSTs to the auto-configure endpoint", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({}));
+        await client.autoConfigureMiddleware(ws, "mw-9");
+        expect(lastUrl()).toBe(`${middlewaresBase}/mw-9/auto-configure`);
+        expect(lastInit().method).toBe("POST");
+    });
+    it("createJob defaults method to POST and sends the definition", async () => {
+        const definition = {
+            region: "us",
+            inputSchema: {},
+            outputSchema: {},
+            steps: [],
+        };
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: route, path: "/coi" }));
+        await client.createJob(ws, mw, { path: "/coi", definition });
+        expect(lastUrl()).toBe(routesBase);
+        expect(lastInit().method).toBe("POST");
+        expect(lastBody()).toEqual({ method: "POST", path: "/coi", definition });
+    });
+    it("createJob keeps an explicit method", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: route }));
+        await client.createJob(ws, mw, {
+            path: "/x",
+            method: "GET",
+            definition: {},
+        });
+        expect(lastBody().method).toBe("GET");
+    });
+    it("updateJob PUTs only the provided fields to the route id", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: route }));
+        await client.updateJob(ws, mw, route, { description: "new desc" });
+        expect(lastUrl()).toBe(`${routesBase}/route-1`);
+        expect(lastInit().method).toBe("PUT");
+        expect(lastBody()).toEqual({ description: "new desc" });
+    });
+    it("listRoutes handles a bare array", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse([{ id: "a" }, { id: "b" }]));
+        const routes = await client.listRoutes(ws, mw);
+        expect(routes.map((r) => r.id)).toEqual(["a", "b"]);
+    });
+    it("listRoutes handles a { routes } envelope", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ routes: [{ id: "a" }] }));
+        const routes = await client.listRoutes(ws, mw);
+        expect(routes.map((r) => r.id)).toEqual(["a"]);
+    });
+    it("getJob filters the route list by id, returning undefined when absent", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValueOnce(jsonResponse([{ id: "a" }, { id: "route-1" }]));
+        expect((await client.getJob(ws, mw, "route-1"))?.id).toBe("route-1");
+        vi.mocked(globalThis.fetch).mockResolvedValueOnce(jsonResponse([{ id: "a" }]));
+        expect(await client.getJob(ws, mw, "route-1")).toBeUndefined();
+    });
+    it("runJob posts input + trigger to /run and returns the execution id", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ jobExecutionId: "je-1" }));
+        const res = await client.runJob(ws, mw, route, { a: 1 }, "test");
+        expect(res.jobExecutionId).toBe("je-1");
+        expect(lastUrl()).toBe(`${routesBase}/route-1/run`);
+        expect(lastBody()).toEqual({ input: { a: 1 }, trigger: "test" });
+    });
+    it("runJob defaults the trigger to mcp", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ jobExecutionId: "je-2" }));
+        await client.runJob(ws, mw, route, {});
+        expect(lastBody().trigger).toBe("mcp");
+    });
+    it("addTestCase posts the case to /test-cases", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: "tc-1" }));
+        await client.addTestCase(ws, mw, route, {
+            name: "happy path",
+            input: { x: 1 },
+            assertions: [{ name: "ok", expr: "output != null" }],
+        });
+        expect(lastUrl()).toBe(`${routesBase}/route-1/test-cases`);
+        expect(lastInit().method).toBe("POST");
+        expect(lastBody().name).toBe("happy path");
+    });
+    it("startTestRun sends testCaseIds when provided and {} otherwise", async () => {
+        vi.mocked(globalThis.fetch).mockImplementation(async () => jsonResponse({ testRunId: "tr-1" }));
+        await client.startTestRun(ws, mw, route, ["tc1", "tc2"]);
+        expect(lastUrl()).toBe(`${routesBase}/route-1/test-runs`);
+        expect(lastBody()).toEqual({ testCaseIds: ["tc1", "tc2"] });
+        await client.startTestRun(ws, mw, route);
+        expect(lastBody()).toEqual({});
+    });
+    it("throws on a non-ok response with the method, path and body", async () => {
+        vi.mocked(globalThis.fetch).mockResolvedValue(new Response("nope", { status: 403 }));
+        await expect(client.getExecution(ws, mw, route, "e")).rejects.toThrow(/Middleware service GET .*failed \(403\): nope/);
+    });
+    describe("pollExecution", () => {
+        it("polls until a terminal state and returns it", async () => {
+            vi.mocked(globalThis.fetch)
+                .mockResolvedValueOnce(jsonResponse({ id: "e", status: "queued" }))
+                .mockResolvedValueOnce(jsonResponse({ id: "e", status: "running" }))
+                .mockResolvedValueOnce(jsonResponse({ id: "e", status: "succeeded" }));
+            const exec = await client.pollExecution(ws, mw, route, "e", {
+                intervalMs: 1,
+                timeoutMs: 1000,
+            });
+            expect(exec.status).toBe("succeeded");
+            expect(globalThis.fetch).toHaveBeenCalledTimes(3);
+        });
+        it("treats partial/failed as terminal", async () => {
+            vi.mocked(globalThis.fetch).mockResolvedValue(jsonResponse({ id: "e", status: "partial" }));
+            const exec = await client.pollExecution(ws, mw, route, "e", {
+                intervalMs: 1,
+                timeoutMs: 1000,
+            });
+            expect(exec.status).toBe("partial");
+            expect(globalThis.fetch).toHaveBeenCalledTimes(1);
+        });
+        it("throws on timeout while still running", async () => {
+            vi.mocked(globalThis.fetch).mockImplementation(async () => jsonResponse({ id: "e", status: "running" }));
+            await expect(client.pollExecution(ws, mw, route, "e", {
+                intervalMs: 1,
+                timeoutMs: 15,
+            })).rejects.toThrow(/Timed out polling job execution e .*last status: running/);
+        });
+    });
+    describe("pollTestRun", () => {
+        it("polls until the run leaves running and returns the report", async () => {
+            vi.mocked(globalThis.fetch)
+                .mockResolvedValueOnce(jsonResponse({ testRun: { id: "tr", status: "running" }, results: [] }))
+                .mockResolvedValueOnce(jsonResponse({
+                testRun: {
+                    id: "tr",
+                    status: "passed",
+                    totals: { total: 1, passed: 1, failed: 0, errored: 0 },
+                },
+                results: [{ id: "r1", testRunId: "tr", testCaseId: "tc", passed: true }],
+            }));
+            const report = await client.pollTestRun(ws, mw, route, "tr", {
+                intervalMs: 1,
+                timeoutMs: 1000,
+            });
+            expect(report.testRun.status).toBe("passed");
+            expect(report.results).toHaveLength(1);
+        });
+        it("throws on timeout while still running", async () => {
+            vi.mocked(globalThis.fetch).mockImplementation(async () => jsonResponse({ testRun: { id: "tr", status: "running" }, results: [] }));
+            await expect(client.pollTestRun(ws, mw, route, "tr", {
+                intervalMs: 1,
+                timeoutMs: 15,
+            })).rejects.toThrow(/Timed out polling test run tr/);
+        });
+    });
+});
+//# sourceMappingURL=middleware-service-client.test.js.map

package/dist/__tests__/middleware-service-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-service-client.test.js","sourceRoot":"","sources":["../../src/__tests__/middleware-service-client.test.ts"],"names":[],"mappings":"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"}

package/dist/codemode.js

@@ -694,19 +694,20 @@ export class CodeModeToolRegistry {
     }
 }
 export function shouldUseCodeMode() {
-    const explicit = process.env.MINICOR_MCP_CODE_MODE;
-    if (explicit != null) {
-        return !["0", "false", "off", "no"].includes(explicit.toLowerCase());
-    }
-    return !["1", "true", "on", "yes"].includes((process.env.MINICOR_MCP_LEGACY_TOOLS ?? "").toLowerCase());
+    // Code mode is experimental and OFF by default. Opt in with
+    // EXPERIMENTAL_USE_CODE_MODE=1 (legacy aliases kept for back-compat).
+    const flag = process.env.EXPERIMENTAL_USE_CODE_MODE ??
+        process.env.MINICOR_MCP_CODE_MODE ??
+        "";
+    return ["1", "true", "on", "yes"].includes(flag.toLowerCase());
 }
 export function buildCodeModeInstructions(baseInstructions) {
     return `${baseInstructions}
 
-CODE MODE:
-This MCP exposes Minicor capabilities through a code-mode surface by default. Use the \`codemode\` tool to run JavaScript that calls Minicor methods as \`await minicor.tool_name({ ... })\`.
+CODE MODE (EXPERIMENTAL):
+This MCP is running with the experimental code-mode surface enabled. Use the \`codemode\` tool to run JavaScript that calls Minicor methods as \`await minicor.tool_name({ ... })\`.
 
-If the server starts unauthenticated and only exposes \`setup_account\`, call \`setup_account\` directly, authenticate, and restart the MCP server. Code mode is enabled for authenticated sessions.
+If the server starts unauthenticated and only exposes \`setup_account\`, call \`setup_account\` directly, authenticate, and restart the MCP server.
 
 Discovery inside code mode:
 - \`await codemode.search("workflow")\` finds relevant Minicor methods.
@@ -715,7 +716,7 @@ Discovery inside code mode:
 
 If the current directory contains a minicor.json file, your first MCP action should be a \`codemode\` call whose code invokes \`await minicor.session_start({ directory: "<current directory>" })\`. Before ending work, invoke \`await minicor.session_end(...)\` through code mode.
 
-Set MINICOR_MCP_LEGACY_TOOLS=1 or MINICOR_MCP_CODE_MODE=0 to expose the legacy one-tool-per-operation MCP surface.`;
+Code mode is opt-in: unset EXPERIMENTAL_USE_CODE_MODE to return to the default one-tool-per-operation MCP surface.`;
 }
 export function asMcpServer(registry) {
     return registry;