npm - premanmcp - Versions diffs - 0.3.4 - Mend

premanmcp 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/LICENSE +21 -0
package/README.md +137 -0
package/bin/cli.js +168 -0
package/dist/auth_flow_ui.d.ts +35 -0
package/dist/auth_flow_ui.js +159 -0
package/dist/mcp-preview-panel.d.ts +30 -0
package/dist/mcp-preview-panel.js +166 -0
package/dist/server.d.ts +2 -0
package/dist/server.js +1132 -0
package/dist/user_auth_flow.d.ts +11 -0
package/dist/user_auth_flow.js +251 -0
package/package.json +53 -0

package/dist/mcp-preview-panel.js ADDED Viewed

@@ -0,0 +1,166 @@
+/**
+ * Two-pane HTML for mcp_preview — shared by the MCP stdio server and
+ * scripts/emit-mcp-preview.mjs (browser tab fallback when Cursor does not render mcp-app).
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+export const MCP_PREVIEW_RESOURCE_URI = "ui://preman/mcp-preview";
+export const RESOURCE_URI_META_KEY = "ui/resourceUri";
+export function escapeHtmlAttr(s) {
+    return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+export function escapeHtmlText(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+export function buildConversionPanelHtml(data) {
+    const toStr = (v) => {
+        if (v == null)
+            return "";
+        if (Array.isArray(v))
+            return v.filter((x) => x != null).map((x) => String(x)).join("; ");
+        if (typeof v === "object") {
+            try {
+                return Object.entries(v)
+                    .map(([k, val]) => `${k}: ${val == null ? "" : String(val)}`)
+                    .join(" · ");
+            }
+            catch {
+                try {
+                    return JSON.stringify(v);
+                }
+                catch {
+                    return String(v);
+                }
+            }
+        }
+        return String(v);
+    };
+    const intent = toStr(data.intent).trim() || "(unspecified)";
+    const method = toStr(data.selection_method).trim() || "unknown";
+    const rationale = toStr(data.rationale).trim();
+    const upstream = toStr(data.spec_preview?.upstream_base_url).trim();
+    const tools = Array.isArray(data.spec_preview?.tools) ? data.spec_preview.tools : [];
+    const selectedCount = typeof data.selected_count === "number" ? data.selected_count : tools.length;
+    const linkKey = (m, p) => `${(m || "").toUpperCase()} ${p || ""}`.trim();
+    const endpointRows = tools
+        .map((t) => {
+        const ref = t._endpoint_ref ?? {};
+        const m = (ref.method ?? "").toUpperCase();
+        const p = ref.path_template ?? "";
+        const key = linkKey(m, p);
+        const tags = Array.isArray(ref.tags) && ref.tags.length > 0 ? ref.tags.join(", ") : "";
+        return `
+        <div class="row" data-link="${escapeHtmlAttr(key)}">
+          <div class="row-head">
+            <span class="method ${escapeHtmlAttr(m)}">${escapeHtmlText(m)}</span>
+            <span class="path">${escapeHtmlText(p)}</span>
+          </div>
+          ${tags ? `<div class="row-meta">tags: ${escapeHtmlText(tags)}</div>` : ""}
+        </div>`;
+    })
+        .join("");
+    const toolRows = tools
+        .map((t) => {
+        const ref = t._endpoint_ref ?? {};
+        const key = linkKey(ref.method, ref.path_template);
+        const schemaJson = (() => {
+            try {
+                return JSON.stringify(t.inputSchema ?? {}, null, 2);
+            }
+            catch {
+                return "{}";
+            }
+        })();
+        return `
+        <div class="row" data-link="${escapeHtmlAttr(key)}">
+          <div class="tool-name">${escapeHtmlText(t.name ?? "(unnamed)")}</div>
+          ${t.description ? `<div class="tool-desc">${escapeHtmlText(t.description)}</div>` : ""}
+          <pre class="tool-schema">${escapeHtmlText(schemaJson)}</pre>
+        </div>`;
+    })
+        .join("");
+    const empty = tools.length === 0
+        ? `<div class="empty">No matching endpoints. Try a different intent or run <code>verify_endpoints_live</code> first.</div>`
+        : "";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>PreMan · MCP Preview</title>
+<style>
+  :root { color-scheme: light dark; --bg:#0d1117; --bg2:#161b22; --border:#30363d; --fg:#e6edf3; --muted:#8b949e; --accent:#58a6ff; --green:#2ea043; --orange:#bf8700; --red:#cf222e; --purple:#8957e5; }
+  * { margin:0; padding:0; box-sizing:border-box; }
+  html, body { height:100%; background:var(--bg); color:var(--fg); font-family:-apple-system,BlinkMacSystemFont,sans-serif; font-size:13px; }
+  body { display:flex; flex-direction:column; overflow:hidden; }
+  header { padding:10px 14px; border-bottom:1px solid var(--border); background:var(--bg2); flex-shrink:0; }
+  header h1 { font-size:13px; font-weight:600; color:var(--accent); }
+  header .meta { font-size:11px; color:var(--muted); margin-top:3px; }
+  header .meta strong { color:var(--fg); font-weight:600; }
+  header .rationale { font-size:11px; color:var(--muted); margin-top:5px; font-style:italic; max-width:900px; }
+  .columns { flex:1; display:grid; grid-template-columns:1fr 1fr; gap:1px; background:var(--border); overflow:hidden; min-height:0; }
+  .col { background:var(--bg); overflow-y:auto; }
+  .col-header { padding:7px 12px; font-size:10px; font-weight:700; letter-spacing:0.06em; text-transform:uppercase; color:var(--muted); border-bottom:1px solid var(--border); position:sticky; top:0; background:var(--bg2); z-index:1; }
+  .row { padding:9px 12px; border-bottom:1px solid var(--border); transition:background 0.1s; }
+  .row:last-child { border-bottom:none; }
+  .row:hover, .row.linked { background:rgba(88,166,255,0.08); }
+  .row-head { display:flex; align-items:center; gap:8px; }
+  .row-meta { font-size:10px; color:var(--muted); margin-top:3px; padding-left:56px; }
+  .method { display:inline-block; min-width:48px; text-align:center; padding:2px 6px; border-radius:3px; font-weight:700; font-size:10px; color:white; font-family:SFMono-Regular,Consolas,monospace; }
+  .method.GET{background:var(--accent);} .method.POST{background:var(--green);} .method.PATCH{background:var(--orange);} .method.PUT{background:var(--purple);} .method.DELETE{background:var(--red);}
+  .path { font-family:SFMono-Regular,Consolas,monospace; font-size:12px; word-break:break-all; }
+  .tool-name { font-family:SFMono-Regular,Consolas,monospace; font-size:12px; font-weight:600; color:var(--accent); }
+  .tool-desc { font-size:11px; color:var(--muted); margin-top:3px; line-height:1.4; }
+  .tool-schema { font-family:SFMono-Regular,Consolas,monospace; font-size:10px; background:var(--bg2); padding:6px 8px; border-radius:3px; margin-top:6px; white-space:pre-wrap; word-break:break-all; max-height:120px; overflow-y:auto; line-height:1.4; color:var(--muted); }
+  .empty { padding:24px; text-align:center; color:var(--muted); font-style:italic; }
+  .empty code { font-family:SFMono-Regular,Consolas,monospace; color:var(--accent); background:var(--bg2); padding:1px 5px; border-radius:3px; font-style:normal; }
+  footer { padding:8px 14px; border-top:1px solid var(--border); background:var(--bg2); display:flex; gap:10px; align-items:center; flex-shrink:0; font-size:11px; color:var(--muted); }
+  footer .upstream { font-family:SFMono-Regular,Consolas,monospace; color:var(--accent); }
+  footer .deploy-hint { margin-left:auto; }
+  footer .deploy-hint code { font-family:SFMono-Regular,Consolas,monospace; color:var(--fg); background:var(--bg); padding:2px 6px; border-radius:3px; }
+</style>
+</head>
+<body>
+  <header>
+    <h1>API → MCP Conversion preview</h1>
+    <div class="meta">
+      Intent: <strong>${escapeHtmlText(intent)}</strong> · Selected <strong>${selectedCount}</strong> endpoint${selectedCount === 1 ? "" : "s"} · Method: ${escapeHtmlText(method)}
+    </div>
+    ${rationale ? `<div class="rationale">${escapeHtmlText(rationale)}</div>` : ""}
+  </header>
+  <main class="columns">
+    <div class="col">
+      <div class="col-header">Your API endpoints (${tools.length})</div>
+      ${endpointRows}${tools.length === 0 ? empty : ""}
+    </div>
+    <div class="col">
+      <div class="col-header">Generated MCP tools (${tools.length})</div>
+      ${toolRows}${tools.length === 0 ? empty : ""}
+    </div>
+  </main>
+  <footer>
+    <span>Upstream: <span class="upstream">${escapeHtmlText(upstream || "(not set)")}</span></span>
+    <span class="deploy-hint">Next: ask the agent to call <code>mcp_deploy</code></span>
+  </footer>
+  <script>
+    document.querySelectorAll('.row[data-link]').forEach(row => {
+      const key = row.getAttribute('data-link');
+      if (!key) return;
+      const matches = () => document.querySelectorAll('[data-link="' + CSS.escape(key) + '"]');
+      row.addEventListener('mouseenter', () => matches().forEach(r => r.classList.add('linked')));
+      row.addEventListener('mouseleave', () => matches().forEach(r => r.classList.remove('linked')));
+    });
+  </script>
+</body>
+</html>`;
+}
+export async function writeMcpPreviewFile(panelHtml) {
+    const outPath = path.join(process.cwd(), "preman-mcp", "mcp-preview-last.html");
+    await fs.mkdir(path.dirname(outPath), { recursive: true });
+    await fs.writeFile(outPath, panelHtml, "utf8");
+    return {
+        absolutePath: outPath,
+        fileUrl: pathToFileURL(outPath).href,
+    };
+}

package/dist/server.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2	+ export declare function createServer(): McpServer;