npm - @agentdiscuss/mcp-server - Versions diffs - 0.1.0 - Mend

@agentdiscuss/mcp-server 0.1.0

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 (75) hide show

package/.env.example +4 -0
package/README.md +387 -0
package/dist/agentic-api/client.d.ts +34 -0
package/dist/agentic-api/client.js +143 -0
package/dist/agentic-api/client.js.map +1 -0
package/dist/agentic-api/types.d.ts +125 -0
package/dist/agentic-api/types.js +2 -0
package/dist/agentic-api/types.js.map +1 -0
package/dist/catalog/discovery.d.ts +5 -0
package/dist/catalog/discovery.js +83 -0
package/dist/catalog/discovery.js.map +1 -0
package/dist/config/capabilities.d.ts +4 -0
package/dist/config/capabilities.js +881 -0
package/dist/config/capabilities.js.map +1 -0
package/dist/config/constants.d.ts +13 -0
package/dist/config/constants.js +79 -0
package/dist/config/constants.js.map +1 -0
package/dist/config/domains.d.ts +3 -0
package/dist/config/domains.js +79 -0
package/dist/config/domains.js.map +1 -0
package/dist/config/env.d.ts +8 -0
package/dist/config/env.js +26 -0
package/dist/config/env.js.map +1 -0
package/dist/http/app.d.ts +3 -0
package/dist/http/app.js +81 -0
package/dist/http/app.js.map +1 -0
package/dist/http/routes/capabilities.d.ts +3 -0
package/dist/http/routes/capabilities.js +55 -0
package/dist/http/routes/capabilities.js.map +1 -0
package/dist/http/routes/domains.d.ts +3 -0
package/dist/http/routes/domains.js +17 -0
package/dist/http/routes/domains.js.map +1 -0
package/dist/http/routes/health.d.ts +2 -0
package/dist/http/routes/health.js +15 -0
package/dist/http/routes/health.js.map +1 -0
package/dist/http/routes/manifest.d.ts +3 -0
package/dist/http/routes/manifest.js +16 -0
package/dist/http/routes/manifest.js.map +1 -0
package/dist/http/routes/root.d.ts +3 -0
package/dist/http/routes/root.js +338 -0
package/dist/http/routes/root.js.map +1 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +43 -0
package/dist/index.js.map +1 -0
package/dist/mcp/server.d.ts +4 -0
package/dist/mcp/server.js +41 -0
package/dist/mcp/server.js.map +1 -0
package/dist/mcp/tool-catalog.d.ts +27 -0
package/dist/mcp/tool-catalog.js +204 -0
package/dist/mcp/tool-catalog.js.map +1 -0
package/dist/mcp/tools/execute-capability.d.ts +3 -0
package/dist/mcp/tools/execute-capability.js +50 -0
package/dist/mcp/tools/execute-capability.js.map +1 -0
package/dist/mcp/tools/generated-capability-tool.d.ts +4 -0
package/dist/mcp/tools/generated-capability-tool.js +51 -0
package/dist/mcp/tools/generated-capability-tool.js.map +1 -0
package/dist/mcp/tools/get-capability-contract.d.ts +3 -0
package/dist/mcp/tools/get-capability-contract.js +20 -0
package/dist/mcp/tools/get-capability-contract.js.map +1 -0
package/dist/mcp/tools/list-capability-tools.d.ts +3 -0
package/dist/mcp/tools/list-capability-tools.js +36 -0
package/dist/mcp/tools/list-capability-tools.js.map +1 -0
package/dist/mcp/tools/list-domains.d.ts +3 -0
package/dist/mcp/tools/list-domains.js +24 -0
package/dist/mcp/tools/list-domains.js.map +1 -0
package/dist/mcp/tools/recommend-capability-route.d.ts +3 -0
package/dist/mcp/tools/recommend-capability-route.js +50 -0
package/dist/mcp/tools/recommend-capability-route.js.map +1 -0
package/dist/mcp/tools/schemas.d.ts +56 -0
package/dist/mcp/tools/schemas.js +141 -0
package/dist/mcp/tools/schemas.js.map +1 -0
package/dist/mcp/tools/utils.d.ts +58 -0
package/dist/mcp/tools/utils.js +194 -0
package/dist/mcp/tools/utils.js.map +1 -0
package/package.json +49 -0

package/dist/http/routes/root.js ADDED Viewed

@@ -0,0 +1,338 @@
+import { Router } from "express";
+import { FALLBACK_DOMAINS } from "../../config/domains.js";
+import { AGENTIC_API_DOCS_URL, AGENTIC_API_INSTALL_URL, MCP_DOCS_URL, MCP_SERVER_TITLE, MCP_TOOL_DEFINITIONS, PACKAGE_NAME, REMOTE_MCP_ENDPOINT, } from "../../config/constants.js";
+function renderRootPage(toolCatalog) {
+    const discoveryToolsMarkup = MCP_TOOL_DEFINITIONS.map((tool) => `
+      <li>
+        <strong>${tool.name}</strong>
+        <span>${tool.description}</span>
+      </li>
+    `).join("");
+    const capabilityToolPreview = toolCatalog.tools.slice(0, 24);
+    const capabilityToolsMarkup = capabilityToolPreview
+        .map((tool) => `
+      <li>
+        <strong>${tool.name}</strong>
+        <span>${tool.operation} · ${tool.domain}.${tool.capabilityId}</span>
+      </li>
+    `)
+        .join("");
+    const domainsMarkup = FALLBACK_DOMAINS.map((domain) => `
+      <li>
+        <strong>${domain.label}</strong>
+        <span>${domain.domain}</span>
+      </li>
+    `).join("");
+    return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${MCP_SERVER_TITLE}</title>
+    <style>
+      :root {
+        color-scheme: light;
+        --bg: #f5f2ea;
+        --panel: rgba(255, 252, 246, 0.86);
+        --panel-strong: #fffaf0;
+        --ink: #1d1b18;
+        --muted: #62584b;
+        --line: rgba(52, 38, 17, 0.12);
+        --accent: #b8562a;
+        --accent-soft: rgba(184, 86, 42, 0.12);
+        --shadow: 0 24px 60px rgba(71, 48, 20, 0.12);
+      }
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        background:
+          radial-gradient(circle at top left, rgba(184, 86, 42, 0.16), transparent 32%),
+          radial-gradient(circle at bottom right, rgba(35, 78, 112, 0.14), transparent 30%),
+          linear-gradient(180deg, #f8f4ec 0%, var(--bg) 100%);
+        color: var(--ink);
+        font-family: "IBM Plex Sans", "Avenir Next", "Segoe UI", sans-serif;
+      }
+      main {
+        width: min(1100px, calc(100% - 32px));
+        margin: 0 auto;
+        padding: 32px 0 48px;
+      }
+      .hero {
+        display: grid;
+        gap: 20px;
+        padding: 28px;
+        border: 1px solid var(--line);
+        border-radius: 28px;
+        background: var(--panel);
+        box-shadow: var(--shadow);
+        backdrop-filter: blur(18px);
+      }
+      .eyebrow {
+        display: inline-flex;
+        width: fit-content;
+        padding: 6px 10px;
+        border-radius: 999px;
+        border: 1px solid var(--line);
+        background: rgba(255, 255, 255, 0.55);
+        color: var(--muted);
+        font-size: 12px;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+      h1 {
+        margin: 0;
+        font-size: clamp(34px, 6vw, 58px);
+        line-height: 0.98;
+        letter-spacing: -0.04em;
+      }
+      p {
+        margin: 0;
+        color: var(--muted);
+        font-size: 16px;
+        line-height: 1.65;
+      }
+      .command {
+        padding: 18px 20px;
+        border-radius: 20px;
+        background: #161311;
+        color: #fdf2d8;
+        font-family: "JetBrains Mono", "SFMono-Regular", monospace;
+        font-size: 15px;
+        overflow-x: auto;
+      }
+      .grid {
+        display: grid;
+        grid-template-columns: repeat(12, 1fr);
+        gap: 18px;
+        margin-top: 18px;
+      }
+      .card {
+        grid-column: span 12;
+        padding: 24px;
+        border: 1px solid var(--line);
+        border-radius: 24px;
+        background: var(--panel-strong);
+        box-shadow: 0 12px 34px rgba(71, 48, 20, 0.06);
+      }
+      .card h2 {
+        margin: 0 0 12px;
+        font-size: 18px;
+        letter-spacing: -0.02em;
+      }
+      .meta {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 10px;
+      }
+      .meta span {
+        padding: 7px 10px;
+        border-radius: 999px;
+        background: var(--accent-soft);
+        color: var(--accent);
+        font-size: 13px;
+      }
+      ul {
+        margin: 0;
+        padding: 0;
+        list-style: none;
+      }
+      li {
+        display: flex;
+        justify-content: space-between;
+        gap: 16px;
+        padding: 14px 0;
+        border-bottom: 1px solid var(--line);
+      }
+      li:last-child {
+        border-bottom: none;
+        padding-bottom: 0;
+      }
+      li strong {
+        font-size: 14px;
+      }
+      li span {
+        color: var(--muted);
+        text-align: right;
+        font-size: 14px;
+      }
+      a {
+        color: var(--accent);
+        text-decoration: none;
+      }
+      a:hover {
+        text-decoration: underline;
+      }
+      .note {
+        padding: 14px 16px;
+        border-left: 3px solid var(--accent);
+        border-radius: 16px;
+        background: rgba(184, 86, 42, 0.08);
+      }
+      @media (min-width: 900px) {
+        .wide {
+          grid-column: span 7;
+        }
+        .narrow {
+          grid-column: span 5;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <section class="hero">
+        <span class="eyebrow">Local Stdio Fallback</span>
+        <h1>${MCP_SERVER_TITLE}</h1>
+        <p>
+          AgentDiscuss MCP is primarily a hosted remote endpoint at
+          <code>${REMOTE_MCP_ENDPOINT}</code>. This package keeps a local stdio
+          fallback for clients or operators that still need a local process.
+        </p>
+        <div class="command">npx add-mcp ${REMOTE_MCP_ENDPOINT}</div>
+        <p>
+          For local stdio fallback, run <code>npx -y ${PACKAGE_NAME}</code> and
+          provide <code>AGENTIC_API_KEY</code> in the MCP client or process env.
+        </p>
+        <div class="meta">
+          <span>Hosted docs: <a href="${MCP_DOCS_URL}">${MCP_DOCS_URL}</a></span>
+          <span>Get your API key from <a href="${AGENTIC_API_INSTALL_URL}">${AGENTIC_API_INSTALL_URL}</a></span>
+        </div>
+      </section>
+      <section class="grid">
+        <article class="card wide">
+          <h2>What It Does</h2>
+          <p>
+            This package is the local stdio fallback for AgentDiscuss MCP. It does
+            not contain provider routing, recommendation ranking, pricing, payment,
+            or settlement logic. It only translates MCP tool calls into upstream
+            Agentic API requests.
+          </p>
+          <div class="note" style="margin-top: 16px;">
+            The local package builds its capability tools from the backend catalog and
+            contracts whenever the upstream Agentic API is reachable. Current source:
+            <code>${toolCatalog.source}</code>${toolCatalog.fallbackReason ? ` (${toolCatalog.fallbackReason})` : ""}.
+          </div>
+        </article>
+        <article class="card narrow">
+          <h2>Setup</h2>
+          <ul>
+            <li>
+              <strong>Hosted remote</strong>
+              <span><code>npx add-mcp ${REMOTE_MCP_ENDPOINT}</code></span>
+            </li>
+            <li>
+              <strong>Local stdio</strong>
+              <span><code>npx -y ${PACKAGE_NAME}</code></span>
+            </li>
+            <li>
+              <strong>Auth</strong>
+              <span>Provide <code>AGENTIC_API_KEY</code></span>
+            </li>
+            <li>
+              <strong>MCP docs</strong>
+              <span><a href="${MCP_DOCS_URL}">docs.agentdiscuss.com/integrations/mcp</a></span>
+            </li>
+            <li>
+              <strong>Key Source</strong>
+              <span><a href="${AGENTIC_API_INSTALL_URL}">agentdiscuss.com/agentic-api/install</a></span>
+            </li>
+            <li>
+              <strong>Docs</strong>
+              <span><a href="${AGENTIC_API_DOCS_URL}">${AGENTIC_API_DOCS_URL}</a></span>
+            </li>
+          </ul>
+        </article>
+        <article class="card wide">
+          <h2>Discovery And Fallback Tools</h2>
+          <ul>${discoveryToolsMarkup}</ul>
+        </article>
+        <article class="card narrow">
+          <h2>Generated Capability Tools</h2>
+          <p>
+            The package currently exposes <strong>${toolCatalog.tools.length}</strong>
+            explicit capability tools generated from the backend catalog.
+          </p>
+          <ul style="margin-top: 16px;">${capabilityToolsMarkup || `
+            <li>
+              <strong>No explicit tools cached</strong>
+              <span>Check upstream catalog connectivity.</span>
+            </li>
+          `}</ul>
+        </article>
+        <article class="card narrow">
+          <h2>Debug Endpoints</h2>
+          <ul>
+            <li><strong>Health</strong><span><code>GET /health</code></span></li>
+            <li><strong>Manifest</strong><span><code>GET /manifest</code></span></li>
+            <li><strong>Domains</strong><span><code>GET /api/domains</code></span></li>
+            <li><strong>Capabilities</strong><span><code>GET /api/capabilities</code></span></li>
+          </ul>
+        </article>
+        <article class="card wide">
+          <h2>Example Payloads</h2>
+          <p>
+            Explicit tools use only the upstream business fields. The generic fallback
+            tools use <code>domain</code>, <code>capabilityId</code>, and
+            <code>input</code>, then forward the inner request body upstream unchanged.
+          </p>
+          <div class="command" style="margin-top: 16px;">recommend_capability_route({
+  "domain": "search",
+  "capabilityId": "answer",
+  "input": {
+    "query": "What changed in AI infrastructure this week?",
+    "optimizationPreferences": ["quality", "speed"]
+  }
+})</div>
+        </article>
+        <article class="card" style="grid-column: span 12;">
+          <h2>Initial Domain Surface</h2>
+          <ul>${domainsMarkup}</ul>
+        </article>
+      </section>
+    </main>
+  </body>
+</html>`;
+}
+export function createRootRouter(getToolCatalog) {
+    const router = Router();
+    router.get("/", async (_request, response) => {
+        const toolCatalog = await getToolCatalog();
+        response.setHeader("Content-Type", "text/html; charset=utf-8");
+        response.send(renderRootPage(toolCatalog));
+    });
+    return router;
+}
+//# sourceMappingURL=root.js.map

package/dist/http/routes/root.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/http/routes/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAGnC,SAAS,cAAc,CAAC,WAAwB;IAC9C,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,GAAG,CACnD,CAAC,IAAI,EAAE,EAAE,CAAC;;kBAEI,IAAI,CAAC,IAAI;gBACX,IAAI,CAAC,WAAW;;KAE3B,CACF,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,MAAM,qBAAqB,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,qBAAqB,GAAG,qBAAqB;SAChD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CAAC;;kBAEE,IAAI,CAAC,IAAI;gBACX,IAAI,CAAC,SAAS,MAAM,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY;;KAE/D,CACA;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CACxC,CAAC,MAAM,EAAE,EAAE,CAAC;;kBAEE,MAAM,CAAC,KAAK;gBACd,MAAM,CAAC,MAAM;;KAExB,CACF,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEX,OAAO;;;;;aAKI,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoLf,gBAAgB;;;kBAGZ,mBAAmB;;;2CAGM,mBAAmB;;uDAEP,YAAY;;;;wCAI3B,YAAY,KAAK,YAAY;iDACpB,uBAAuB,KAAK,uBAAuB;;;;;;;;;;;;;;;;oBAgBhF,WAAW,CAAC,MAAM,UAAU,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;;;wCAS5E,mBAAmB;;;;mCAIxB,YAAY;;;;;;;;+BAQhB,YAAY;;;;+BAIZ,uBAAuB;;;;+BAIvB,oBAAoB,KAAK,oBAAoB;;;;;;;gBAO5D,oBAAoB;;;;;;oDAMgB,WAAW,CAAC,KAAK,CAAC,MAAM;;;0CAGlC,qBAAqB,IAAI;;;;;WAKxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAgCK,aAAa;;;;;QAKrB,CAAC;AACT,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,cAAiC;IAChE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QAC3C,MAAM,WAAW,GAAG,MAAM,cAAc,EAAE,CAAC;QAC3C,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;QAC/D,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ #!/usr/bin/env node
2	+ export {};

package/dist/index.js ADDED Viewed

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { APP_VERSION, MCP_SERVER_NAME, } from "./config/constants.js";
+import { startHttpServer } from "./http/app.js";
+import { runMcpServer } from "./mcp/server.js";
+function printHelp() {
+    process.stdout.write([
+        "AgentDiscuss MCP",
+        "",
+        "Usage:",
+        "  agentdiscuss                Start the MCP server over stdio",
+        "  agentdiscuss mcp            Start the MCP server over stdio",
+        "  agentdiscuss http           Start the local HTTP helper service",
+        "  agentdiscuss --help         Show this help text",
+        "  agentdiscuss --version      Show the current version",
+        "",
+    ].join("\n"));
+}
+async function main() {
+    const mode = process.argv[2]?.trim();
+    if (!mode || mode === "mcp") {
+        await runMcpServer();
+        return;
+    }
+    if (mode === "http") {
+        await startHttpServer();
+        return;
+    }
+    if (mode === "--help" || mode === "-h") {
+        printHelp();
+        return;
+    }
+    if (mode === "--version" || mode === "-v") {
+        process.stdout.write(`${APP_VERSION}\n`);
+        return;
+    }
+    throw new Error(`Unknown mode "${mode}". Expected "mcp" or "http".`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`[${MCP_SERVER_NAME}] ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,WAAW,EACX,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,kBAAkB;QAClB,EAAE;QACF,QAAQ;QACR,+DAA+D;QAC/D,+DAA+D;QAC/D,mEAAmE;QACnE,mDAAmD;QACnD,wDAAwD;QACxD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAErC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,YAAY,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,eAAe,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACvC,SAAS,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,8BAA8B,CAAC,CAAC;AACvE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,eAAe,KAAK,OAAO,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/server.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../agentic-api/client.js";
+export declare function createMcpServer(client: AgenticApiClient): Promise<McpServer>;
+export declare function runMcpServer(): Promise<void>;

package/dist/mcp/server.js ADDED Viewed

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AgenticApiClient } from "../agentic-api/client.js";
+import { APP_VERSION, MCP_SERVER_NAME, } from "../config/constants.js";
+import { readEnv } from "../config/env.js";
+import { createToolCatalogLoader } from "./tool-catalog.js";
+import { registerExecuteCapabilityTool } from "./tools/execute-capability.js";
+import { registerGeneratedCapabilityTool } from "./tools/generated-capability-tool.js";
+import { registerGetCapabilityContractTool } from "./tools/get-capability-contract.js";
+import { registerListCapabilityToolsTool } from "./tools/list-capability-tools.js";
+import { registerListDomainsTool } from "./tools/list-domains.js";
+import { registerRecommendCapabilityRouteTool } from "./tools/recommend-capability-route.js";
+export async function createMcpServer(client) {
+    const getToolCatalog = createToolCatalogLoader(client);
+    const toolCatalog = await getToolCatalog();
+    const server = new McpServer({
+        name: MCP_SERVER_NAME,
+        version: APP_VERSION,
+    });
+    registerListDomainsTool(server, client);
+    registerListCapabilityToolsTool(server, getToolCatalog);
+    registerGetCapabilityContractTool(server, client);
+    registerRecommendCapabilityRouteTool(server, client);
+    registerExecuteCapabilityTool(server, client);
+    for (const tool of toolCatalog.tools) {
+        registerGeneratedCapabilityTool(server, client, tool);
+    }
+    return server;
+}
+export async function runMcpServer() {
+    const env = readEnv();
+    const client = new AgenticApiClient({
+        baseUrl: env.agenticApiBaseUrl,
+        apiKey: env.agenticApiKey,
+    });
+    const server = await createMcpServer(client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[${MCP_SERVER_NAME}] MCP server connected over stdio.\n`);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAE7F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAwB;IAC5D,MAAM,cAAc,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,cAAc,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IAEH,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,+BAA+B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxD,iCAAiC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,oCAAoC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACrC,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC;QAClC,OAAO,EAAE,GAAG,CAAC,iBAAiB;QAC9B,MAAM,EAAE,GAAG,CAAC,aAAa;KAC1B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,eAAe,sCAAsC,CAC1D,CAAC;AACJ,CAAC"}

package/dist/mcp/tool-catalog.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { AgenticApiClient } from "../agentic-api/client.js";
+import type { CapabilityContract, CapabilityOperationContract, DiscoverySource } from "../agentic-api/types.js";
+export type CapabilityToolDefinition = {
+    kind: "capability";
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    domain: string;
+    capabilityId: string;
+    capabilityKey: string;
+    operation: "recommend" | "execute";
+    docsUrl?: string | null;
+    contract?: CapabilityContract | null;
+    operationContract?: CapabilityOperationContract | null;
+};
+export type ToolCatalog = {
+    builtAt: number;
+    source: DiscoverySource;
+    fallbackReason?: string;
+    tools: CapabilityToolDefinition[];
+    byName: Map<string, CapabilityToolDefinition>;
+};
+export type ToolCatalogLoader = () => Promise<ToolCatalog>;
+export declare function createToolCatalogLoader(client: AgenticApiClient): ToolCatalogLoader;
+export declare function buildToolCatalog(client: AgenticApiClient): Promise<ToolCatalog>;

package/dist/mcp/tool-catalog.js ADDED Viewed

@@ -0,0 +1,204 @@
+import { z } from "zod";
+import { AgenticApiClient } from "../agentic-api/client.js";
+import { discoverAllCapabilities } from "../catalog/discovery.js";
+const TOOL_BUILD_CONCURRENCY = 12;
+export function createToolCatalogLoader(client) {
+    let cachedPromise = null;
+    return () => {
+        cachedPromise ??= buildToolCatalog(client);
+        return cachedPromise;
+    };
+}
+export async function buildToolCatalog(client) {
+    const discoveredCapabilities = await discoverAllCapabilities(client);
+    const liveCapabilities = discoveredCapabilities.items.filter((capability) => capability.status !== "planned");
+    const toolEntries = await mapWithConcurrency(liveCapabilities, TOOL_BUILD_CONCURRENCY, async (capability) => buildCapabilityTools(client, capability));
+    const tools = toolEntries.flat();
+    return {
+        builtAt: Date.now(),
+        source: discoveredCapabilities.source,
+        fallbackReason: discoveredCapabilities.fallbackReason,
+        tools,
+        byName: new Map(tools.map((tool) => [tool.name, tool])),
+    };
+}
+async function buildCapabilityTools(client, capability) {
+    if (!capability.recommendEndpoint && !capability.executeEndpoint) {
+        return [];
+    }
+    const contract = await safeGetCapabilityContract(client, capability.domain, capability.capability);
+    const tools = [];
+    if (capability.recommendEndpoint) {
+        tools.push(buildCapabilityTool(capability, contract, "recommend"));
+    }
+    if (capability.executeEndpoint) {
+        tools.push(buildCapabilityTool(capability, contract, "execute"));
+    }
+    return tools;
+}
+function buildCapabilityTool(capability, contract, operation) {
+    const capabilityKey = capability.key ?? `${capability.domain}.${capability.capability}`;
+    const operationContract = operation === "recommend" ? contract?.recommend ?? null : contract?.execute ?? null;
+    return {
+        kind: "capability",
+        name: `${normalizeToolName(capabilityKey)}_${operation}`,
+        title: `${capability.label ?? humanizeIdentifier(capability.capability)} ${capitalize(operation)}`,
+        description: [
+            capability.description ?? `${humanizeIdentifier(capability.capability)} in ${capability.domain}.`,
+            operation === "recommend"
+                ? "Use this tool to choose the best AgentDiscuss route before execution."
+                : "Use this tool to run the AgentDiscuss capability.",
+            capability.docsUrl ? `Docs: ${capability.docsUrl}.` : null,
+        ]
+            .filter(Boolean)
+            .join(" "),
+        inputSchema: buildOperationInputSchema(operationContract),
+        domain: capability.domain,
+        capabilityId: capability.capability,
+        capabilityKey,
+        operation,
+        docsUrl: capability.docsUrl,
+        contract,
+        operationContract,
+    };
+}
+function buildOperationInputSchema(operationContract) {
+    if (!operationContract || operationContract.fields.length === 0) {
+        const fallbackSchema = z.object({}).catchall(z.unknown());
+        return operationContract?.requestExample
+            ? fallbackSchema.meta({
+                examples: [operationContract.requestExample],
+            })
+            : fallbackSchema.describe("The upstream AgentDiscuss capability catalog has not published a field-level contract for this operation yet.");
+    }
+    const shape = {};
+    for (const field of operationContract.fields) {
+        const fieldSchema = buildFieldSchema(field);
+        shape[field.name] = field.required ? fieldSchema : fieldSchema.optional();
+    }
+    let schema = z.object(shape).strict();
+    if (operationContract.notes.length > 0) {
+        schema = schema.describe(operationContract.notes.join(" "));
+    }
+    if (operationContract.requestExample) {
+        schema = schema.meta({
+            examples: [operationContract.requestExample],
+        });
+    }
+    return schema;
+}
+function buildFieldSchema(field) {
+    let schema;
+    if (field.enumValues?.length) {
+        schema = z.enum(field.enumValues);
+    }
+    else {
+        switch (field.type) {
+            case "string":
+                schema = z.string();
+                break;
+            case "number":
+                schema = z.number();
+                break;
+            case "integer":
+                schema = z.number().int();
+                break;
+            case "boolean":
+                schema = z.boolean();
+                break;
+            case "array":
+                schema = z.array(buildArrayItemSchema(field));
+                break;
+            case "object": {
+                const shape = {};
+                for (const nestedField of field.fields ?? []) {
+                    const nestedSchema = buildFieldSchema(nestedField);
+                    shape[nestedField.name] = nestedField.required
+                        ? nestedSchema
+                        : nestedSchema.optional();
+                }
+                schema = z.object(shape).strict();
+                break;
+            }
+            default:
+                schema = z.unknown();
+                break;
+        }
+    }
+    if (field.type === "string" && typeof field.maxLength === "number") {
+        schema = schema.max(field.maxLength);
+    }
+    if ((field.type === "number" || field.type === "integer") &&
+        typeof field.min === "number") {
+        schema = schema.min(field.min);
+    }
+    if ((field.type === "number" || field.type === "integer") &&
+        typeof field.max === "number") {
+        schema = schema.max(field.max);
+    }
+    if (field.notes?.length) {
+        schema = schema.describe(field.notes.join(" "));
+    }
+    return schema;
+}
+function buildArrayItemSchema(field) {
+    switch (field.itemsType) {
+        case "string":
+            return z.string();
+        case "number":
+            return z.number();
+        case "integer":
+            return z.number().int();
+        case "boolean":
+            return z.boolean();
+        case "object":
+            return z.object({}).catchall(z.unknown());
+        default:
+            return z.unknown();
+    }
+}
+async function safeGetCapabilityContract(client, domain, capabilityId) {
+    try {
+        return await client.getCapabilityContract(domain, capabilityId);
+    }
+    catch {
+        return null;
+    }
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const workers = Array.from({
+        length: Math.max(1, Math.min(concurrency, items.length || 1)),
+    }, async () => {
+        while (nextIndex < items.length) {
+            const currentIndex = nextIndex;
+            const item = items[currentIndex];
+            if (item === undefined) {
+                return;
+            }
+            nextIndex += 1;
+            results[currentIndex] = await mapper(item, currentIndex);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+function capitalize(value) {
+    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+}
+function humanizeIdentifier(value) {
+    return value
+        .replace(/[._-]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (match) => match.toUpperCase());
+}
+function normalizeToolName(capabilityKey) {
+    return capabilityKey
+        .replace(/[^a-zA-Z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_+/g, "_")
+        .toLowerCase();
+}
+//# sourceMappingURL=tool-catalog.js.map