@agentdiscuss/mcp-server 0.1.0

package/dist/mcp/tool-catalog.js.map

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

package/dist/mcp/tools/execute-capability.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+export declare function registerExecuteCapabilityTool(server: McpServer, client: AgenticApiClient): void;

package/dist/mcp/tools/execute-capability.js

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import { EXECUTE_CAPABILITY_INPUT_SCHEMA, EXECUTE_INPUT_EXAMPLES, } from "./schemas.js";
+import { loadCapabilityOperationContext, toCapabilityPreflightError, toCapabilityToolError, toToolSuccess, } from "./utils.js";
+export function registerExecuteCapabilityTool(server, client) {
+    server.registerTool("execute_capability", {
+        title: "Execute capability",
+        description: `Fallback generic tool that proxies an execute request to /domains/{domain}/capabilities/{capabilityId}/execute.\n\nUse explicit capability tools first when they are available. In inspector form mode:\n- put the domain in the domain field\n- put the capabilityId in the capabilityId field\n- put only the inner upstream body in input\n- do not nest { "domain": ..., "capabilityId": ..., "input": ... } inside input\n\nFull tool-call example:\n${JSON.stringify(EXECUTE_INPUT_EXAMPLES[0], null, 2)}`,
+        inputSchema: EXECUTE_CAPABILITY_INPUT_SCHEMA,
+    }, async ({ domain, capabilityId, input }) => {
+        const contractContext = await loadCapabilityOperationContext(client, domain, capabilityId, "execute");
+        const missingRequiredFields = contractContext.operationContract
+            ? contractContext.operationContract.requiredFields.filter((field) => {
+                const value = input[field];
+                if (typeof value === "string") {
+                    return value.trim().length === 0;
+                }
+                return value === undefined || value === null;
+            })
+            : [];
+        if (missingRequiredFields.length > 0) {
+            return toCapabilityPreflightError({
+                client,
+                domain,
+                capability: capabilityId,
+                operation: "execute",
+                payload: input,
+                contract: contractContext.contract,
+                operationContract: contractContext.operationContract,
+                missingRequiredFields,
+            });
+        }
+        try {
+            const result = await client.executeCapability(domain, capabilityId, input);
+            return toToolSuccess(result);
+        }
+        catch (error) {
+            return toCapabilityToolError(error, {
+                client,
+                domain,
+                capability: capabilityId,
+                operation: "execute",
+                payload: input,
+                contract: contractContext.contract,
+                operationContract: contractContext.operationContract,
+            });
+        }
+    });
+}
+//# sourceMappingURL=execute-capability.js.map

package/dist/mcp/tools/execute-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-capability.js","sourceRoot":"","sources":["../../../src/mcp/tools/execute-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,6BAA6B,CAC3C,MAAiB,EACjB,MAAwB;IAExB,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,6bAA6b,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACnf,WAAW,EAAE,+BAA+B;KAC7C,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,MAAM,eAAe,GAAG,MAAM,8BAA8B,CAC1D,MAAM,EACN,MAAM,EACN,YAAY,EACZ,SAAS,CACV,CAAC;QACF,MAAM,qBAAqB,GAAG,eAAe,CAAC,iBAAiB;YAC7D,CAAC,CAAC,eAAe,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBAE3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;gBACnC,CAAC;gBAED,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;YAC/C,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,0BAA0B,CAAC;gBAChC,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;gBACpD,qBAAqB;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAC3C,MAAM,EACN,YAAY,EACZ,KAAK,CACN,CAAC;YAEF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,EAAE;gBAClC,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;aACrD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/generated-capability-tool.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import type { CapabilityToolDefinition } from "../tool-catalog.js";
+export declare function registerGeneratedCapabilityTool(server: McpServer, client: AgenticApiClient, tool: CapabilityToolDefinition): void;

package/dist/mcp/tools/generated-capability-tool.js

@@ -0,0 +1,51 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import { toCapabilityPreflightError, toCapabilityToolError, toToolSuccess, } from "./utils.js";
+export function registerGeneratedCapabilityTool(server, client, tool) {
+    server.registerTool(tool.name, {
+        title: tool.title,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    }, async (input) => {
+        const payload = input;
+        const missingRequiredFields = tool.operationContract
+            ? tool.operationContract.requiredFields.filter((field) => {
+                const value = payload[field];
+                if (typeof value === "string") {
+                    return value.trim().length === 0;
+                }
+                return value === undefined || value === null;
+            })
+            : [];
+        if (missingRequiredFields.length > 0) {
+            return toCapabilityPreflightError({
+                client,
+                domain: tool.domain,
+                capability: tool.capabilityId,
+                operation: tool.operation,
+                payload,
+                contract: tool.contract ?? null,
+                operationContract: tool.operationContract ?? null,
+                missingRequiredFields,
+            });
+        }
+        try {
+            const result = tool.operation === "recommend"
+                ? await client.recommendCapabilityRoute(tool.domain, tool.capabilityId, payload)
+                : await client.executeCapability(tool.domain, tool.capabilityId, payload);
+            return toToolSuccess(result);
+        }
+        catch (error) {
+            return toCapabilityToolError(error, {
+                client,
+                domain: tool.domain,
+                capability: tool.capabilityId,
+                operation: tool.operation,
+                payload,
+                contract: tool.contract ?? null,
+                operationContract: tool.operationContract ?? null,
+            });
+        }
+    });
+}
+//# sourceMappingURL=generated-capability-tool.js.map

package/dist/mcp/tools/generated-capability-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-capability-tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/generated-capability-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,+BAA+B,CAC7C,MAAiB,EACjB,MAAwB,EACxB,IAA8B;IAE9B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;QACE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,OAAO,GAAG,KAAgC,CAAC;QACjD,MAAM,qBAAqB,GAAG,IAAI,CAAC,iBAAiB;YAClD,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAE7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;gBACnC,CAAC;gBAED,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;YAC/C,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,0BAA0B,CAAC;gBAChC,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,YAAY;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;gBAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;gBACjD,qBAAqB;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GACV,IAAI,CAAC,SAAS,KAAK,WAAW;gBAC5B,CAAC,CAAC,MAAM,MAAM,CAAC,wBAAwB,CACnC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,OAAO,CACR;gBACH,CAAC,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAC5B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,OAAO,CACR,CAAC;YAER,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,EAAE;gBAClC,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,YAAY;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;gBAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/get-capability-contract.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+export declare function registerGetCapabilityContractTool(server: McpServer, client: AgenticApiClient): void;

package/dist/mcp/tools/get-capability-contract.js

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import { GET_CAPABILITY_CONTRACT_INPUT_SCHEMA } from "./schemas.js";
+import { toToolError, toToolSuccess } from "./utils.js";
+export function registerGetCapabilityContractTool(server, client) {
+    server.registerTool("get_capability_contract", {
+        title: "Get capability contract",
+        description: "Fetch the upstream capability contract, including required fields, optional fields, and generated request examples for recommend and execute.",
+        inputSchema: GET_CAPABILITY_CONTRACT_INPUT_SCHEMA,
+    }, async ({ domain, capabilityId }) => {
+        try {
+            const contract = await client.getCapabilityContract(domain, capabilityId);
+            return toToolSuccess(contract);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-capability-contract.js.map

package/dist/mcp/tools/get-capability-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-capability-contract.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-capability-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,oCAAoC,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,UAAU,iCAAiC,CAC/C,MAAiB,EACjB,MAAwB;IAExB,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,+IAA+I;QACjJ,WAAW,EAAE,oCAAoC;KAClD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAE1E,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/list-capability-tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolCatalogLoader } from "../tool-catalog.js";
+export declare function registerListCapabilityToolsTool(server: McpServer, getToolCatalog: ToolCatalogLoader): void;

package/dist/mcp/tools/list-capability-tools.js

@@ -0,0 +1,36 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LIST_CAPABILITY_TOOLS_INPUT_SCHEMA } from "./schemas.js";
+import { toToolError, toToolSuccess } from "./utils.js";
+export function registerListCapabilityToolsTool(server, getToolCatalog) {
+    server.registerTool("list_capability_tools", {
+        title: "List capability tools",
+        description: "List explicit MCP tools for one domain or one capability without browsing the full server catalog.",
+        inputSchema: LIST_CAPABILITY_TOOLS_INPUT_SCHEMA,
+    }, async ({ domain, capabilityId }) => {
+        try {
+            const toolCatalog = await getToolCatalog();
+            const tools = toolCatalog.tools
+                .filter((tool) => (domain ? tool.domain === domain : true))
+                .filter((tool) => capabilityId ? tool.capabilityId === capabilityId : true)
+                .map((tool) => ({
+                name: tool.name,
+                title: tool.title,
+                description: tool.description,
+                domainKey: tool.domain,
+                capabilityId: tool.capabilityId,
+                capabilityKey: tool.capabilityKey,
+                operation: tool.operation,
+                docsUrl: tool.docsUrl,
+            }));
+            return toToolSuccess({
+                source: toolCatalog.source,
+                fallbackReason: toolCatalog.fallbackReason,
+                tools,
+            });
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=list-capability-tools.js.map

package/dist/mcp/tools/list-capability-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-capability-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/list-capability-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,UAAU,+BAA+B,CAC7C,MAAiB,EACjB,cAAiC;IAEjC,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,oGAAoG;QACtG,WAAW,EAAE,kCAAkC;KAChD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,cAAc,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK;iBAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBAC1D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACf,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CACzD;iBACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,MAAM;gBACtB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC,CAAC;YAEN,OAAO,aAAa,CAAC;gBACnB,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,cAAc,EAAE,WAAW,CAAC,cAAc;gBAC1C,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/list-domains.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+export declare function registerListDomainsTool(server: McpServer, client: AgenticApiClient): void;

package/dist/mcp/tools/list-domains.js

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import { discoverDomains } from "../../catalog/discovery.js";
+import { toToolError, toToolSuccess } from "./utils.js";
+export function registerListDomainsTool(server, client) {
+    server.registerTool("list_domains", {
+        title: "List domains",
+        description: "List supported AgentDiscuss domains exposed through AgentDiscuss MCP.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const result = await discoverDomains(client);
+            return toToolSuccess({
+                source: result.source,
+                fallbackReason: result.fallbackReason,
+                domains: result.items,
+            });
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=list-domains.js.map

package/dist/mcp/tools/list-domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-domains.js","sourceRoot":"","sources":["../../../src/mcp/tools/list-domains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,MAAwB;IAExB,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,uEAAuE;QACzE,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;YAE7C,OAAO,aAAa,CAAC;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,OAAO,EAAE,MAAM,CAAC,KAAK;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/recommend-capability-route.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+export declare function registerRecommendCapabilityRouteTool(server: McpServer, client: AgenticApiClient): void;

package/dist/mcp/tools/recommend-capability-route.js

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import { RECOMMEND_CAPABILITY_ROUTE_INPUT_SCHEMA, RECOMMEND_INPUT_EXAMPLES, } from "./schemas.js";
+import { loadCapabilityOperationContext, toCapabilityPreflightError, toCapabilityToolError, toToolSuccess, } from "./utils.js";
+export function registerRecommendCapabilityRouteTool(server, client) {
+    server.registerTool("recommend_capability_route", {
+        title: "Recommend capability route",
+        description: `Fallback generic tool that proxies a recommend request to /domains/{domain}/capabilities/{capabilityId}/recommend.\n\nUse explicit capability tools first when they are available. In inspector form mode:\n- put "email" in the domain field\n- put "send" in the capabilityId field\n- put only the inner upstream body in input\n- do not nest { "domain": ..., "capabilityId": ..., "input": ... } inside input\n\nFull tool-call example:\n${JSON.stringify(RECOMMEND_INPUT_EXAMPLES[0], null, 2)}`,
+        inputSchema: RECOMMEND_CAPABILITY_ROUTE_INPUT_SCHEMA,
+    }, async ({ domain, capabilityId, input }) => {
+        const contractContext = await loadCapabilityOperationContext(client, domain, capabilityId, "recommend");
+        const missingRequiredFields = contractContext.operationContract
+            ? contractContext.operationContract.requiredFields.filter((field) => {
+                const value = input[field];
+                if (typeof value === "string") {
+                    return value.trim().length === 0;
+                }
+                return value === undefined || value === null;
+            })
+            : [];
+        if (missingRequiredFields.length > 0) {
+            return toCapabilityPreflightError({
+                client,
+                domain,
+                capability: capabilityId,
+                operation: "recommend",
+                payload: input,
+                contract: contractContext.contract,
+                operationContract: contractContext.operationContract,
+                missingRequiredFields,
+            });
+        }
+        try {
+            const result = await client.recommendCapabilityRoute(domain, capabilityId, input);
+            return toToolSuccess(result);
+        }
+        catch (error) {
+            return toCapabilityToolError(error, {
+                client,
+                domain,
+                capability: capabilityId,
+                operation: "recommend",
+                payload: input,
+                contract: contractContext.contract,
+                operationContract: contractContext.operationContract,
+            });
+        }
+    });
+}
+//# sourceMappingURL=recommend-capability-route.js.map

package/dist/mcp/tools/recommend-capability-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend-capability-route.js","sourceRoot":"","sources":["../../../src/mcp/tools/recommend-capability-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,uCAAuC,EACvC,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,oCAAoC,CAClD,MAAiB,EACjB,MAAwB;IAExB,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,mbAAmb,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAC3e,WAAW,EAAE,uCAAuC;KACrD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,MAAM,eAAe,GAAG,MAAM,8BAA8B,CAC1D,MAAM,EACN,MAAM,EACN,YAAY,EACZ,WAAW,CACZ,CAAC;QACF,MAAM,qBAAqB,GAAG,eAAe,CAAC,iBAAiB;YAC7D,CAAC,CAAC,eAAe,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBAE3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;gBACnC,CAAC;gBAED,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;YAC/C,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,0BAA0B,CAAC;gBAChC,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;gBACpD,qBAAqB;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAClD,MAAM,EACN,YAAY,EACZ,KAAK,CACN,CAAC;YAEF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,KAAK,EAAE;gBAClC,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;aACrD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/schemas.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const LIST_CAPABILITY_TOOLS_INPUT_SCHEMA: z.ZodObject<{
+    domain: z.ZodOptional<z.ZodString>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GET_CAPABILITY_CONTRACT_INPUT_SCHEMA: z.ZodObject<{
+    domain: z.ZodString;
+    capabilityId: z.ZodString;
+}, z.core.$strip>;
+export declare const RECOMMEND_INPUT_EXAMPLES: readonly [{
+    readonly domain: "search";
+    readonly capabilityId: "answer";
+    readonly input: {
+        readonly query: "What changed in AI infrastructure this week?";
+        readonly optimizationPreferences: readonly ["quality", "speed"];
+    };
+}, {
+    readonly domain: "email";
+    readonly capabilityId: "send";
+    readonly input: {
+        readonly agentName: "alpha_agent";
+        readonly optimizationPreferences: readonly ["cost", "quality"];
+        readonly sender: {
+            readonly mode: "platform_managed";
+            readonly replyTo: "ops@example.com";
+        };
+    };
+}];
+export declare const EXECUTE_INPUT_EXAMPLES: readonly [{
+    readonly domain: "web";
+    readonly capabilityId: "extract";
+    readonly input: {
+        readonly url: "https://example.com/docs";
+        readonly fields: readonly ["title", "pricing", "authentication"];
+    };
+}, {
+    readonly domain: "email";
+    readonly capabilityId: "send";
+    readonly input: {
+        readonly to: "maya@example.com";
+        readonly subject: "Hello from AgentDiscuss";
+        readonly html: "<p>Hello</p>";
+        readonly provider: "resend";
+        readonly allowFallback: true;
+    };
+}];
+export declare const RECOMMEND_CAPABILITY_ROUTE_INPUT_SCHEMA: z.ZodObject<{
+    domain: z.ZodString;
+    capabilityId: z.ZodString;
+    input: z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const EXECUTE_CAPABILITY_INPUT_SCHEMA: z.ZodObject<{
+    domain: z.ZodString;
+    capabilityId: z.ZodString;
+    input: z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;

package/dist/mcp/tools/schemas.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+export const LIST_CAPABILITY_TOOLS_INPUT_SCHEMA = z.object({
+    domain: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("Optional domain identifier such as search, email, web, enrichment, travel, or speech.")
+        .meta({
+        examples: ["search", "email", "web"],
+    }),
+    capabilityId: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("Optional capability identifier inside the selected domain, such as send, answer, people-search, or profile-lookup.")
+        .meta({
+        examples: ["send", "answer", "people-search"],
+    }),
+});
+export const GET_CAPABILITY_CONTRACT_INPUT_SCHEMA = z.object({
+    domain: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Domain identifier such as email, search, web, enrichment, or social.")
+        .meta({
+        examples: ["email", "search", "enrichment"],
+    }),
+    capabilityId: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Capability identifier inside the selected domain, such as send, answer, people-search, or profile-lookup.")
+        .meta({
+        examples: ["send", "answer", "people-search"],
+    }),
+});
+export const RECOMMEND_INPUT_EXAMPLES = [
+    {
+        domain: "search",
+        capabilityId: "answer",
+        input: {
+            query: "What changed in AI infrastructure this week?",
+            optimizationPreferences: ["quality", "speed"],
+        },
+    },
+    {
+        domain: "email",
+        capabilityId: "send",
+        input: {
+            agentName: "alpha_agent",
+            optimizationPreferences: ["cost", "quality"],
+            sender: {
+                mode: "platform_managed",
+                replyTo: "ops@example.com",
+            },
+        },
+    },
+];
+export const EXECUTE_INPUT_EXAMPLES = [
+    {
+        domain: "web",
+        capabilityId: "extract",
+        input: {
+            url: "https://example.com/docs",
+            fields: ["title", "pricing", "authentication"],
+        },
+    },
+    {
+        domain: "email",
+        capabilityId: "send",
+        input: {
+            to: "maya@example.com",
+            subject: "Hello from AgentDiscuss",
+            html: "<p>Hello</p>",
+            provider: "resend",
+            allowFallback: true,
+        },
+    },
+];
+export const RECOMMEND_CAPABILITY_ROUTE_INPUT_SCHEMA = z
+    .object({
+    domain: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Domain identifier such as search, email, web, enrichment, travel, or speech.")
+        .meta({
+        examples: ["search", "email"],
+    }),
+    capabilityId: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Capability identifier inside the selected domain, such as answer, send, scrape, or transcribe.")
+        .meta({
+        examples: ["answer", "send", "extract"],
+    }),
+    input: z
+        .object({})
+        .catchall(z.unknown())
+        .describe("Only the inner upstream request body. Do not repeat domain, capabilityId, or input inside this object.")
+        .meta({
+        examples: RECOMMEND_INPUT_EXAMPLES.map((example) => example.input),
+    }),
+})
+    .meta({
+    examples: RECOMMEND_INPUT_EXAMPLES,
+});
+export const EXECUTE_CAPABILITY_INPUT_SCHEMA = z
+    .object({
+    domain: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Domain identifier such as search, email, web, enrichment, travel, or speech.")
+        .meta({
+        examples: ["search", "web"],
+    }),
+    capabilityId: z
+        .string()
+        .trim()
+        .min(1)
+        .describe("Capability identifier inside the selected domain, such as answer, send, extract, or transcribe.")
+        .meta({
+        examples: ["answer", "extract", "send"],
+    }),
+    input: z
+        .object({})
+        .catchall(z.unknown())
+        .describe("Only the inner upstream request body. Do not repeat domain, capabilityId, or input inside this object.")
+        .meta({
+        examples: EXECUTE_INPUT_EXAMPLES.map((example) => example.input),
+    }),
+})
+    .meta({
+    examples: EXECUTE_INPUT_EXAMPLES,
+});
+//# sourceMappingURL=schemas.js.map

package/dist/mcp/tools/schemas.js.map

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

package/dist/mcp/tools/utils.d.ts

@@ -0,0 +1,58 @@
+import { AgenticApiClient } from "../../agentic-api/client.js";
+import type { CapabilityContract, CapabilityOperationContract } from "../../agentic-api/types.js";
+type ToolPayload = Record<string, unknown>;
+type SerializedToolError = {
+    error: string;
+    code?: string;
+    hint?: string;
+    status: number;
+    details?: unknown;
+    upstream?: boolean;
+};
+type CapabilityToolContext = {
+    client: AgenticApiClient;
+    domain: string;
+    capability: string;
+    operation: "recommend" | "execute";
+    payload?: Record<string, unknown>;
+    contract?: CapabilityContract | null;
+    operationContract?: CapabilityOperationContract | null;
+};
+export declare function toToolSuccess<T extends ToolPayload>(payload: T): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: T;
+};
+export declare function toToolError(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: SerializedToolError;
+    isError: boolean;
+};
+export declare function toCapabilityToolError(error: unknown, context: CapabilityToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: ToolPayload;
+    isError: boolean;
+}>;
+export declare function loadCapabilityOperationContext(client: AgenticApiClient, domain: string, capability: string, operation: CapabilityToolContext["operation"]): Promise<{
+    contract: CapabilityContract | null;
+    operationContract: CapabilityOperationContract | null;
+}>;
+export declare function toCapabilityPreflightError(context: CapabilityToolContext & {
+    missingRequiredFields: string[];
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: ToolPayload;
+    isError: boolean;
+};
+export {};