@minicor/mcp-server 3.3.5 → 3.5.0

package/dist/prompts/build-rpa.js

@@ -40,6 +40,20 @@ ${appName}
 ID: ${workspaceId}${workflowId ? `\nExisting workflow ID: ${workflowId} (add steps to this workflow)` : "\nCreate a new workflow for this automation."}
 ${modeSection}
 
+## WORK BACKWARDS — Define the Test Case FIRST
+
+Before building anything, write down what "done" means as a concrete, runnable test:
+
+1. **State the contract.** What input does this automation take, and what output proves it worked? Write the input JSON and the expected output shape.
+2. **Author the green-gate.** A workflow's behavior is locked in by a **Job** with **test cases**. As the very first build artifact:
+   - Register a thin Job for this automation: \`register_job\` with a \`definition\` whose single \`workflow\` step calls this workflow (use a placeholder \`workflowId\` you'll fill in, or the existing one). The job is the testable wrapper above the workflow.
+   - Add the test case NOW: \`add_test_case\` with the input from step 1 and assertions \`[{ name, expr }]\` describing the expected output (e.g. \`output.patientId != null\`, \`output.status === "ok"\`). \`expr\` is a TS boolean over \`{ input, output, ctx, steps }\`.
+3. **The test is RED.** It will fail until the workflow exists and is correct. That red test is your target.
+4. **Build the workflow** (the loop below) to turn the test GREEN.
+5. **Green-gate:** the build is NOT done until \`run_tests\` reports \`green: true\`. Re-run \`run_tests\` after every meaningful change.
+
+Use test patients only — never real patient data. Pick inputs/slots far in the future so tests don't collide with real schedules.
+
 ## MANDATORY FIRST STEP — Load Testing Skill
 
 Before doing ANYTHING else, run: \`get_skill("rpa-testing-workflow")\`
@@ -121,6 +135,9 @@ b. Poll \`get_execution_status\` every 5-10s, \`vm_screenshot\` at intervals to
 c. On failure → \`diagnose_execution\` + \`vm_screenshot\`, fix with \`update_flow\`, re-run FULL workflow
 d. Iterate until full workflow passes. **Do NOT declare done until it passes.**${isProduction ? "\ne. Run the workflow a SECOND time to verify idempotency." : ""}
 
+### 6b. GREEN-GATE — run_tests
+The workflow passing once is not enough. Point the Job's workflow step at the finished \`workflowId\` (\`update_job\` if needed), then run \`run_tests\` for the job. **The build is done ONLY when \`run_tests\` returns \`green: true\`** and every test case passes. On a red result, drill into the failing case's job execution → step → Minicor run, fix, and re-run \`run_tests\`. Add more \`add_test_case\` entries for edge cases (empty results, not-found, second-run idempotency) and keep them green.
+
 ### 7. Iterate with the User
 ${isProduction ? `
 ### 8. Production Hardening

package/dist/prompts/build-rpa.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-rpa.js","sourceRoot":"","sources":["../../src/prompts/build-rpa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,EAAY;IAC3C,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,wSAAwS,EACxS;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACxD,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,iHAAiH,CAClH;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,uFAAuF,CACxF;QACH,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sEAAsE,CACvE;QACH,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;aAC3B,QAAQ,EAAE;aACV,QAAQ,CACP,4HAA4H,CAC7H;KACJ,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;QACzD,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC;QAC7B,MAAM,WAAW,GAAG,IAAI;YACtB,CAAC,CAAC,aAAa,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,iFAAiF,EAAE;YAC9K,CAAC,CAAC,yIAAyI,CAAC;QAE9I,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;;;EAGlB,IAAI;;;EAGJ,OAAO;;;MAGH,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,2BAA2B,UAAU,+BAA+B,CAAC,CAAC,CAAC,8CAA8C;EACpJ,WAAW;;;;;;;;;;;;;;;;;;;;;;;0EAuB6D,YAAY,CAAC,CAAC,CAAC,sGAAsG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oGAAoG;;;;;;;;;;;;;;;;;;;;;;;;;YAyBvS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAiC8D,YAAY,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC,CAAC,EAAE;;;EAG/J,YAAY,CAAC,CAAC,CAAC;;;;;;CAMhB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;;;CAIhB;;;qFAGoF,YAAY,CAAC,CAAC,CAAC,8EAA8E,CAAC,CAAC,CAAC,EAAE;;sIAEjD;qBACzH;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"build-rpa.js","sourceRoot":"","sources":["../../src/prompts/build-rpa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,EAAY;IAC3C,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,wSAAwS,EACxS;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACxD,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,iHAAiH,CAClH;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,uFAAuF,CACxF;QACH,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sEAAsE,CACvE;QACH,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;aAC3B,QAAQ,EAAE;aACV,QAAQ,CACP,4HAA4H,CAC7H;KACJ,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;QACzD,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC;QAC7B,MAAM,WAAW,GAAG,IAAI;YACtB,CAAC,CAAC,aAAa,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,iFAAiF,EAAE;YAC9K,CAAC,CAAC,yIAAyI,CAAC;QAE9I,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;;;EAGlB,IAAI;;;EAGJ,OAAO;;;MAGH,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,2BAA2B,UAAU,+BAA+B,CAAC,CAAC,CAAC,8CAA8C;EACpJ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAqC6D,YAAY,CAAC,CAAC,CAAC,sGAAsG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oGAAoG;;;;;;;;;;;;;;;;;;;;;;;;;YAyBvS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAiC8D,YAAY,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC,CAAC,EAAE;;;;;;EAM/J,YAAY,CAAC,CAAC,CAAC;;;;;;CAMhB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;;;CAIhB;;;qFAGoF,YAAY,CAAC,CAAC,CAAC,8EAA8E,CAAC,CAAC,CAAC,EAAE;;sIAEjD;qBACzH;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/nestjs-to-job.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDeps } from "../types.js";
+/**
+ * Prompt: turn an existing NestJS customer middleware into a Job.
+ *
+ * Given a Nest.js controller that orchestrates Laminar workflows (login →
+ * lookup → create, with header munging and error mapping), this prompt walks
+ * the agent through mapping that endpoint into a structured JobDefinition step
+ * graph and registering it with register_job.
+ */
+export declare function register({ server }: ToolDeps): void;
+//# sourceMappingURL=nestjs-to-job.d.ts.map

package/dist/prompts/nestjs-to-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-to-job.d.ts","sourceRoot":"","sources":["../../src/prompts/nestjs-to-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,QAwG5C"}

package/dist/prompts/nestjs-to-job.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+/**
+ * Prompt: turn an existing NestJS customer middleware into a Job.
+ *
+ * Given a Nest.js controller that orchestrates Laminar workflows (login →
+ * lookup → create, with header munging and error mapping), this prompt walks
+ * the agent through mapping that endpoint into a structured JobDefinition step
+ * graph and registering it with register_job.
+ */
+export function register({ server }) {
+    server.prompt("nestjs-middleware-to-job", "Convert an existing NestJS customer middleware endpoint (a controller method that orchestrates Minicor workflows) into a Job — a structured JobDefinition step graph (workflow steps + code blocks + when/forEach) registered via register_job, with test cases as the green-gate.", {
+        controllerPath: z
+            .string()
+            .describe("Path to the NestJS controller file (e.g. src/controllers/ams.controller.ts)"),
+        endpoint: z
+            .string()
+            .optional()
+            .describe("Which controller method/route to convert (e.g. POST /ams/account-lookup). Omit to convert all."),
+        workspaceId: z.string().describe("Minicor workspace ID"),
+        middlewareId: z
+            .string()
+            .optional()
+            .describe("Existing router (middleware) ID to attach the job route to. Omit to create one with create_router first."),
+    }, async ({ controllerPath, endpoint, workspaceId, middlewareId }) => {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You are converting a NestJS customer middleware endpoint into a **Job**.
+
+## What you're converting
+- Controller: \`${controllerPath}\`
+- Endpoint: ${endpoint ?? "ALL methods in the controller"}
+- Workspace: ${workspaceId}
+- Router (middleware): ${middlewareId ?? "none yet — create one with create_router first, then use its id"}
+
+## Mental model (read this first)
+- **A Job ≡ a middleware route** whose behavior is a structured \`definition\` (a step graph) instead of freeform handler code.
+- A Job sits **above** workflows. A job step either **calls an entire Minicor workflow** (\`kind: "workflow"\`, by \`workflowId\`) or **runs a code block** (\`kind: "code"\`, a \`(ctx) => ...\` string). The job never touches a workflow's internal steps — a workflow is an opaque callable with an input and an output.
+- Keep job graphs small: typically \`login → lookup/create → shape output\`.
+
+## How a NestJS controller maps to a JobDefinition
+A typical controller method does: validate the body (DTO) → run a login workflow → run the target workflow → munge the result (headers, status) → return / throw. Map each piece:
+
+| NestJS | JobDefinition |
+| --- | --- |
+| \`@Body() dto\` + DTO class | \`inputSchema\` (JSON Schema) |
+| return type / DTO | \`outputSchema\` (JSON Schema) |
+| \`await laminar.executeWorkflow({ workflowId: LOGIN, data:{} })\` | a \`kind:"workflow"\` step with \`cache\` (login gate) |
+| \`await laminar.executeWorkflow({ workflowId: TARGET, data })\` | a \`kind:"workflow"\` step; \`input\` is \`{{ctx.input.*}}\` templating or a CodeBlock |
+| header munging (e.g. \`x-recording-url\` → \`web_agent_video_url\`) | a \`kind:"code"\` step, or the \`output\` CodeBlock |
+| \`if (cond) ...\` branching | step \`when\` (skip) / \`onError\` / \`{ goto }\` |
+| looping over a collection | step \`forEach\` |
+| \`throw new HttpException(...)\` mapping | engine sets failed on \`onError:"abort"\`; \`output\` block decides \`partial\`/\`review\` |
+| serialize per desktop (login lands before run) | \`resource.lockKey\` |
+
+## Worked example — FurtherAI AMS360 \`runWithLogin\` → Job
+A controller that does "ensure AMS360 login, then run the target workflow, then merge the recording URL header" becomes:
+
+\`\`\`json
+{
+  "region": "us",
+  "resource": { "lockKey": "ams360-desktop" },
+  "inputSchema": { "type": "object", "properties": { "insured_name": { "type": "string" } }, "required": ["insured_name"] },
+  "outputSchema": { "type": "object" },
+  "steps": [
+    {
+      "id": "login", "name": "AMS360 Login", "kind": "workflow",
+      "workflowId": 0,
+      "input": {},
+      "cache": { "key": "ams360-login", "ttlMs": 1800000 },
+      "onError": "abort"
+    },
+    {
+      "id": "lookup", "name": "Account Lookup", "kind": "workflow",
+      "workflowId": 2078,
+      "saveAs": "lookup",
+      "input": { "task_type": "ams_account_lookup", "insured_name": "{{ctx.input.insured_name}}" },
+      "onError": "abort"
+    }
+  ],
+  "output": "(ctx) => { const r = ctx.lookup?.data ?? ctx.lookup; const rec = ctx.lookup?.headers?.['x-recording-url']; return rec ? { ...r, web_agent_video_url: String(rec) } : r; }"
+}
+\`\`\`
+(Replace the placeholder \`workflowId: 0\` login id and \`2078\` with the real ids from \`WORKFLOW_IDS\` / \`list_workflows\`. Map every constant in the controller's config to a real workflow id.)
+
+## Procedure
+1. **Read the controller** at \`${controllerPath}\` and its DTOs/constants. List each endpoint, the workflow ids it calls, the call order, and the result-shaping logic.
+2. **Resolve workflow ids** with \`list_workflows(workspaceId: ${workspaceId})\` — match the controller's \`WORKFLOW_IDS\`/constants to live ids.
+3. **Author inputSchema/outputSchema** from the DTOs.
+4. **Build the step graph** per the mapping table. Login/smart-launch → a \`cache\`d workflow step. Each downstream workflow → a workflow step with templated \`input\`. Header/result munging → the \`output\` CodeBlock (or a \`code\` step).
+5. **Define the green-gate FIRST**: \`add_test_case\` with a representative input (use test data only) and assertions over the expected output (e.g. \`output.web_agent_video_url != null\`, \`output.account != null\`).
+6. **Register** with \`register_job(workspaceId, middlewareId, path, definition)\`. Use ${middlewareId ? `middlewareId ${middlewareId}` : "the middlewareId of the router you created"}.
+7. **Run it**: \`run_job\` with the test input; inspect the returned JobExecution (per-step \`workflowExecutionId\`/\`region\` deep-link to the real Minicor runs).
+8. **Green-gate**: \`run_tests\` until \`green: true\`. Drill into any failing case → its job execution → step → Minicor run; fix \`update_job\` and re-run.
+
+## Rules
+- One job per controller endpoint. Keep the graph shallow.
+- Never hardcode credentials — keep secrets in the workflow's config store (\`resource.configStoreId\` / step \`configStoreId\`).
+- Preserve the controller's ordering guarantees with \`resource.lockKey\` (serialize per desktop) so login always lands before the work.
+- Test data only — never real patient/customer data.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=nestjs-to-job.js.map

package/dist/prompts/nestjs-to-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-to-job.js","sourceRoot":"","sources":["../../src/prompts/nestjs-to-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,EAAY;IAC3C,MAAM,CAAC,MAAM,CACX,0BAA0B,EAC1B,oRAAoR,EACpR;QACE,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,CAAC,6EAA6E,CAAC;QAC1F,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,gGAAgG,CAAC;QAC7G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACxD,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0GAA0G,CAAC;KACxH,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE;QAChE,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;;;kBAGF,cAAc;cAClB,QAAQ,IAAI,+BAA+B;eAC1C,WAAW;yBACD,YAAY,IAAI,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAqDxE,cAAc;iEACiB,WAAW;;;;0FAIc,YAAY,CAAC,CAAC,CAAC,gBAAgB,YAAY,EAAE,CAAC,CAAC,CAAC,4CAA4C;;;;;;;;qDAQjI;qBACxC;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/jobs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP tools for Jobs + Test Cases.
+ *
+ * A Job is a middleware route whose behavior is a structured `definition`
+ * (step graph) instead of freeform handler code. Jobs sit *above* workflows: a
+ * job step calls an entire Minicor workflow (by workflowId) or runs a code
+ * block. Test cases attach to a job (route): a named input + code-block
+ * assertions `[{ name, expr }]` evaluated against the execution.
+ *
+ * See middlewares/JOBS-DESIGN.md for the full model + API contract (v1).
+ *
+ * Auth/transport is handled by MiddlewareServiceClient, which by default calls
+ * the region's public middleware-service Cloud Run directly with the MCP's user
+ * bearer token. Set MIDDLEWARE_SERVICE_PROXY_BASE to route through a deployed
+ * frontend proxy instead, or MIDDLEWARE_SERVICE_URL[_US|_CA] to hit a specific
+ * reachable instance (dev/local). See middleware-service-client.ts for the full
+ * precedence.
+ */
+import type { ToolDeps } from "../types.js";
+export declare function register(deps: ToolDeps): void;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/tools/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAmG5C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,QAqqBtC"}