@agentdiscuss/mcp-server 0.1.0

package/dist/mcp/tools/utils.js

@@ -0,0 +1,194 @@
+import { AgenticApiClient, AgenticApiClientError, } from "../../agentic-api/client.js";
+export function toToolSuccess(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        structuredContent: payload,
+    };
+}
+export function toToolError(error) {
+    const payload = serializeToolError(error);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        structuredContent: payload,
+        isError: true,
+    };
+}
+export async function toCapabilityToolError(error, context) {
+    const contract = context.contract ??
+        (await safeGetCapabilityContract(context.client, context.domain, context.capability));
+    const operationContract = context.operationContract ??
+        (contract ? selectOperationContract(contract, context.operation) : null);
+    const payload = buildContractAwarePayload(serializeToolError(error), context, contract, operationContract);
+    const inspectorPayloadHint = inferInspectorPayloadHint(error, context.payload);
+    if (inspectorPayloadHint) {
+        payload.inspectorPayloadHint = inspectorPayloadHint;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        structuredContent: payload,
+        isError: true,
+    };
+}
+export async function loadCapabilityOperationContext(client, domain, capability, operation) {
+    const contract = await safeGetCapabilityContract(client, domain, capability);
+    return {
+        contract,
+        operationContract: contract
+            ? selectOperationContract(contract, operation)
+            : null,
+    };
+}
+export function toCapabilityPreflightError(context) {
+    const payload = buildContractAwarePayload({
+        error: `Missing required field${context.missingRequiredFields.length === 1 ? "" : "s"} for ${context.domain}.${context.capability} ${context.operation}: ${context.missingRequiredFields.join(", ")}.`,
+        code: "MISSING_REQUIRED_FIELDS",
+        hint: "Call get_capability_contract for the full request shape before retrying.",
+        status: 400,
+        upstream: false,
+        details: {
+            reason: "Required upstream request fields are missing.",
+            missingRequiredFields: context.missingRequiredFields,
+        },
+    }, context, context.contract ?? null, context.operationContract ?? null);
+    const inspectorPayloadHint = inferInspectorPayloadHint(null, context.payload);
+    if (inspectorPayloadHint) {
+        payload.inspectorPayloadHint = inspectorPayloadHint;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+        structuredContent: payload,
+        isError: true,
+    };
+}
+function serializeToolError(error) {
+    if (error instanceof AgenticApiClientError) {
+        return {
+            error: error.message,
+            code: error.code,
+            hint: error.hint,
+            status: error.status,
+            details: error.details,
+            upstream: error.isUpstream,
+        };
+    }
+    return {
+        error: error instanceof Error ? error.message : String(error),
+        code: "TOOL_EXECUTION_FAILED",
+        status: 500,
+    };
+}
+function buildContractAwarePayload(basePayload, context, contract, operationContract) {
+    const payload = {
+        ...basePayload,
+        domain: context.domain,
+        capability: context.capability,
+        operation: context.operation,
+        suggestedNextTool: "get_capability_contract",
+        contractLookup: {
+            tool: "get_capability_contract",
+            arguments: {
+                domain: context.domain,
+                capabilityId: context.capability,
+            },
+        },
+    };
+    if (contract) {
+        payload.docsUrl = contract.docsUrl;
+        payload.contractStatus = contract.contractStatus;
+    }
+    if (operationContract) {
+        payload.requestContract = {
+            status: operationContract.status,
+            dtoName: operationContract.dtoName,
+            requiredFields: operationContract.requiredFields,
+            optionalFields: operationContract.optionalFields,
+            conditionallyRequiredFields: operationContract.conditionallyRequiredFields,
+            requestExample: operationContract.requestExample,
+        };
+        const missingRequiredFields = findMissingRequiredFields(operationContract, context.payload);
+        if (missingRequiredFields.length > 0) {
+            payload.missingRequiredFields = missingRequiredFields;
+        }
+    }
+    return payload;
+}
+async function safeGetCapabilityContract(client, domain, capability) {
+    try {
+        return await client.getCapabilityContract(domain, capability);
+    }
+    catch {
+        return null;
+    }
+}
+function selectOperationContract(contract, operation) {
+    return operation === "recommend" ? contract.recommend : contract.execute;
+}
+function findMissingRequiredFields(contract, payload) {
+    const requestPayload = payload ?? {};
+    return contract.requiredFields.filter((field) => {
+        const value = requestPayload[field];
+        if (typeof value === "string") {
+            return value.trim().length === 0;
+        }
+        return value === undefined || value === null;
+    });
+}
+function inferInspectorPayloadHint(error, payload) {
+    if (looksLikeWrappedPayload(payload)) {
+        return "Put domain and capabilityId in their top-level tool fields. In input, send only the inner upstream request body.";
+    }
+    if (!(error instanceof AgenticApiClientError)) {
+        return null;
+    }
+    const messages = extractDetailMessages(error.details);
+    if (messages.some((message) => /property domain should not exist/i.test(message)) ||
+        messages.some((message) => /property capability(Id)? should not exist/i.test(message)) ||
+        messages.some((message) => /property (payload|input) should not exist/i.test(message))) {
+        return "Put domain and capabilityId in their top-level tool fields. In input, send only the inner upstream request body.";
+    }
+    return null;
+}
+function looksLikeWrappedPayload(payload) {
+    if (!payload) {
+        return false;
+    }
+    return (Object.prototype.hasOwnProperty.call(payload, "domain") &&
+        (Object.prototype.hasOwnProperty.call(payload, "capability") ||
+            Object.prototype.hasOwnProperty.call(payload, "capabilityId")) &&
+        (Object.prototype.hasOwnProperty.call(payload, "payload") ||
+            Object.prototype.hasOwnProperty.call(payload, "input")));
+}
+function extractDetailMessages(details) {
+    if (!details || typeof details !== "object" || Array.isArray(details)) {
+        return [];
+    }
+    const message = details.message;
+    if (Array.isArray(message)) {
+        return message.filter((item) => typeof item === "string");
+    }
+    if (typeof message === "string") {
+        return [message];
+    }
+    return [];
+}
+//# sourceMappingURL=utils.js.map

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

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@agentdiscuss/mcp-server",
+  "version": "0.1.0",
+  "description": "Local stdio fallback package for AgentDiscuss MCP",
+  "type": "module",
+  "bin": {
+    "agentdiscuss": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "dev:http": "tsx watch src/index.ts http",
+    "dev:mcp": "tsx watch src/index.ts",
+    "smoke": "npm run build && node --test test/smoke.test.mjs",
+    "start": "node dist/index.js http",
+    "start:http": "node dist/index.js http",
+    "start:mcp": "node dist/index.js"
+  },
+  "keywords": [
+    "agentdiscuss",
+    "mcp",
+    "model-context-protocol",
+    "agentic-api",
+    "stdio"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}