Add DHI disclaimer and logs (#41)

* add disclaimers and logs

* update tools

Author: lucadruda

package.json

@@ -13,8 +13,8 @@
         "format:fix": "prettier --write \"**/*.+(ts|json)\"",
         "format:check": "prettier --check \"**/*.+(ts|json)\"",
         "format": "npm run format:fix",
-        "list-tools:check": "node dist/scripts/toolsList.js check-tools-list",
-        "list-tools:update": "node dist/scripts/toolsList.js update-tools-list",
+        "list-tools:check": "npm run build && node dist/scripts/toolsList.js check-tools-list",
+        "list-tools:update": "npm run build && node dist/scripts/toolsList.js update-tools-list",
         "list-tools": "npm run list-tools:check && npm run list-tools:update"
     },
     "keywords": [

src/scout.ts

@@ -19,6 +19,10 @@ import { ScoutClient } from './scout/client';
 import fetch, { RequestInfo, RequestInit } from 'node-fetch';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import z from 'zod';
+import { logger } from './logger';
+
+const DHI_DISCLAIMER = `Docker Hardened Images are available for organizations entitled to DHIs.If you're interested in accessing Docker Hardened Images, please visit:
+https://www.docker.com/products/hardened-images/`;
 
 export class ScoutAPI extends Asset {
     private scoutClient: ScoutClient;
@@ -59,7 +63,7 @@ export class ScoutAPI extends Asset {
                 'docker-hardened-images',
                 {
                     description:
-                        'Docker Hardened Images (DHI) API. This API is used to query for mirrored DHIs in the namespace. It lists all the secure, minimal, production-ready images available to get near-zero CVEs and enterprise-grade SLA.',
+                        'Docker Hardened Images (DHI) API. This API is used to query for mirrored DHIs in the namespace. It lists all the secure, minimal, production ready images available to get near-zero CVEs and enterprise-grade SLA.',
                     inputSchema: z.object({
                         namespace: z
                             .string()
@@ -72,6 +76,7 @@ export class ScoutAPI extends Asset {
                     },
                 },
                 async ({ namespace }) => {
+                    logger.info(`Querying for mirrored DHI images for organization: ${namespace}`);
                     const { data, errors } = await this.scoutClient.query({
                         dhiListMirroredRepositories: {
                             __args: {
@@ -91,16 +96,51 @@ export class ScoutAPI extends Asset {
                         },
                     });
                     if (errors) {
+                        logger.error(
+                            `Error querying for mirrored DHI images: ${JSON.stringify(errors)}`
+                        );
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(errors, null, 2) }],
+                            content: [
+                                { type: 'text', text: JSON.stringify(errors, null, 2) },
+                                {
+                                    type: 'text',
+                                    text: DHI_DISCLAIMER,
+                                },
+                            ],
                             isError: true,
                         };
                     }
+                    if (data.dhiListMirroredRepositories.mirroredRepositories.length === 0) {
+                        logger.info(`No mirrored DHI images found for organization: ${namespace}`);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `There are no mirrored DHI images for the organization '${namespace}'. Could you try again by providing a different organization entitled to DHIs?`,
+                                },
+                                {
+                                    type: 'text',
+                                    text: DHI_DISCLAIMER,
+                                },
+                            ],
+                        };
+                    }
+                    logger.info(
+                        `Found ${data.dhiListMirroredRepositories.mirroredRepositories.length} mirrored DHI images for organization: ${namespace}`
+                    );
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: JSON.stringify(data, null, 2),
+                                text: `Here are the mirrored DHI images for the organization '${namespace}':\n\n${JSON.stringify(
+                                    data.dhiListMirroredRepositories.mirroredRepositories,
+                                    null,
+                                    2
+                                )}`,
+                            },
+                            {
+                                type: 'text',
+                                text: DHI_DISCLAIMER,
                             },
                         ],
                     };

tools.json

@@ -3753,7 +3753,7 @@
         },
         {
             "name": "docker-hardened-images",
-            "description": "Docker Hardened Images (DHI) API. This API is used to query for mirrored DHIs in the namespace. It lists all the secure, minimal, production-ready images available to get near-zero CVEs and enterprise-grade SLA.",
+            "description": "Docker Hardened Images (DHI) API. This API is used to query for mirrored DHIs in the namespace. It lists all the secure, minimal, production ready images available to get near-zero CVEs and enterprise-grade SLA.",
             "inputSchema": {
                 "type": "object",
                 "properties": {