@minicor/mcp-server 2.0.0

package/dist/index.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * Minicor MCP Server (formerly Laminar)
+ *
+ * Brings your Minicor workspace into Cursor / Claude Code.
+ * Core tools always available; Elasticsearch + CRON unlock with advanced setup.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import fs from "node:fs";
+import path from "node:path";
+import { loadServiceConfig } from "./config.js";
+import { LaminarClient } from "./laminar-client.js";
+import { getTokenPath, getWriteTokenPath, regionToApiBase, apiBaseToRegion, } from "./paths.js";
+import { CronService, ElasticsearchService } from "./services.js";
+import { register as registerCore } from "./tools/core.js";
+import { register as registerWorkflowOps } from "./tools/workflow-ops.js";
+import { register as registerConfigStores } from "./tools/config-stores.js";
+import { register as registerIssues } from "./tools/issues.js";
+import { register as registerStats } from "./tools/stats.js";
+import { register as registerElasticsearch } from "./tools/elasticsearch.js";
+import { register as registerCron } from "./tools/cron.js";
+import { register as registerSyncTools } from "./tools/sync-tools.js";
+import { register as registerVm } from "./tools/vm.js";
+import { register as registerVmRpa } from "./tools/vm-rpa.js";
+import { register as registerBrowser } from "./tools/browser.js";
+import { register as registerWorkflowGuide } from "./prompts/workflow-guide.js";
+import { register as registerDebugExecution } from "./prompts/debug-execution.js";
+import { register as registerBuildRpa } from "./prompts/build-rpa.js";
+import { register as registerBuildBrowserRpa } from "./prompts/build-browser-rpa.js";
+// ─── Token management ────────────────────────────────────────
+const REFRESH_BUFFER_MS = 5 * 60 * 1000;
+function readStoredTokens() {
+    try {
+        const tokenPath = getTokenPath();
+        if (!fs.existsSync(tokenPath))
+            return null;
+        return JSON.parse(fs.readFileSync(tokenPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeStoredTokens(tokens) {
+    const writePath = getWriteTokenPath();
+    const dir = path.dirname(writePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(writePath, JSON.stringify(tokens, null, 2) + "\n", {
+        mode: 0o600,
+    });
+}
+export function getApiBase() {
+    const stored = readStoredTokens();
+    if (stored?.region)
+        return regionToApiBase(stored.region);
+    if (stored?.api_base)
+        return stored.api_base;
+    return regionToApiBase("us");
+}
+async function refreshAccessToken(refreshToken) {
+    const base = getApiBase();
+    try {
+        const res = await fetch(`${base}/auth/refresh`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ refreshToken }),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return {
+            access_token: data.access_token,
+            refresh_token: data.refresh_token || refreshToken,
+            expires_at: Date.now() + data.expires_in * 1000,
+            api_base: base,
+            region: apiBaseToRegion(base),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function getValidToken() {
+    const tokens = readStoredTokens();
+    if (!tokens)
+        throw new Error("No stored tokens");
+    if (Date.now() < tokens.expires_at - REFRESH_BUFFER_MS) {
+        return tokens.access_token;
+    }
+    if (tokens.refresh_token) {
+        console.error("Refreshing access token...");
+        const refreshed = await refreshAccessToken(tokens.refresh_token);
+        if (refreshed) {
+            writeStoredTokens(refreshed);
+            console.error("Token refreshed.");
+            return refreshed.access_token;
+        }
+    }
+    console.error("Warning: Token expired and refresh failed. Run `minicor-mcp-setup` to re-authenticate.");
+    return tokens.access_token;
+}
+// ─── Resolve auth ────────────────────────────────────────────
+async function resolveAuth() {
+    const baseUrl = getApiBase();
+    const stored = readStoredTokens();
+    if (stored) {
+        const token = await getValidToken();
+        return { auth: { type: "bearer", token }, baseUrl };
+    }
+    console.error("Not authenticated. Run `minicor-mcp-setup` to sign in or create an account.");
+    process.exit(1);
+}
+// ─── Server state ────────────────────────────────────────────
+let client;
+let esService = null;
+let cronService = null;
+const server = new McpServer({
+    name: "minicor",
+    version: "2.0.0",
+});
+function scheduleTokenRefresh() {
+    const tokens = readStoredTokens();
+    if (!tokens?.refresh_token)
+        return;
+    const msUntilRefresh = Math.max(tokens.expires_at - REFRESH_BUFFER_MS - Date.now(), 60_000);
+    setTimeout(async () => {
+        try {
+            const token = await getValidToken();
+            client = new LaminarClient({ type: "bearer", token }, getApiBase());
+            console.error("Token auto-refreshed, client updated.");
+        }
+        catch (e) {
+            console.error("Auto-refresh failed:", e.message);
+        }
+        scheduleTokenRefresh();
+    }, msUntilRefresh);
+}
+// ─── Register all tools and prompts ──────────────────────────
+function registerAll() {
+    const deps = {
+        server,
+        client: () => client,
+        getApiBase,
+        esService: () => esService,
+        cronService: () => cronService,
+    };
+    registerCore(deps);
+    registerWorkflowOps(deps);
+    registerConfigStores(deps);
+    registerIssues(deps);
+    registerStats(deps);
+    registerElasticsearch(deps);
+    registerCron(deps);
+    registerSyncTools(deps);
+    registerVm(deps);
+    registerVmRpa(deps);
+    registerBrowser(deps);
+    registerWorkflowGuide(deps);
+    registerDebugExecution(deps);
+    registerBuildRpa(deps);
+    registerBuildBrowserRpa(deps);
+}
+// ─── Main ────────────────────────────────────────────────────
+async function main() {
+    const { auth, baseUrl } = await resolveAuth();
+    client = new LaminarClient(auth, baseUrl);
+    scheduleTokenRefresh();
+    const svcConfig = loadServiceConfig();
+    if (svcConfig.elasticsearch) {
+        esService = new ElasticsearchService(svcConfig.elasticsearch);
+        console.error("Elasticsearch: configured");
+    }
+    else {
+        console.error("Elasticsearch: not configured (log search disabled)");
+    }
+    if (svcConfig.cron) {
+        cronService = new CronService(svcConfig.cron);
+        console.error("CRON service: configured");
+    }
+    else {
+        console.error("CRON service: not configured (scheduling disabled)");
+    }
+    registerAll();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Minicor MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inspect-scripts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Python script generators for VM UI inspection.
+ *
+ * Each function returns a Python script string that, when executed on the VM
+ * via LDS /execute, prints structured JSON to stdout for the agent to parse.
+ */
+export type InspectMode = "window_list" | "screen_info" | "element_at_point" | "element_tree" | "focused_element";
+export type InspectFramework = "auto" | "uiautomation" | "pywinauto" | "jab";
+export interface InspectParams {
+    mode: InspectMode;
+    x?: number;
+    y?: number;
+    windowTitle?: string;
+    framework?: InspectFramework;
+    depth?: number;
+}
+export declare function generateInspectScript(params: InspectParams): string;
+//# sourceMappingURL=inspect-scripts.d.ts.map

package/dist/inspect-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-scripts.d.ts","sourceRoot":"","sources":["../src/inspect-scripts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,aAAa,GACb,kBAAkB,GAClB,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAWnE"}