@carbonvoice/cv-mcp-server 2.8.0 → 2.8.15

package/dist/config/env.js

@@ -3,6 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.env = exports.isTestEnvironment = void 0;
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
+const validLogTransports = ['console', 'file', 'cloudwatch'];
+const parseLogTransports = (value) => {
+    const parsedTransports = value
+        .split(',')
+        .map((transport) => transport.trim())
+        .filter(Boolean);
+    if (parsedTransports.length === 0) {
+        throw new Error(`LOG_TRANSPORT must include at least one value: ${validLogTransports.join(', ')}`);
+    }
+    const invalidTransports = parsedTransports.filter((transport) => !validLogTransports.includes(transport));
+    if (invalidTransports.length > 0) {
+        throw new Error(`Invalid LOG_TRANSPORT value(s): ${invalidTransports.join(', ')}. ` +
+            `Allowed values: ${validLogTransports.join(', ')}`);
+    }
+    return [...new Set(parsedTransports)];
+};
 const getRunningEnvironment = () => {
     // App Runner provides service name in environment
     const serviceName = process.env.AWS_APPRUNNER_SERVICE_NAME || '';
@@ -28,14 +44,148 @@ const Environment = zod_1.z.object({
         .optional()
         .transform((val) => val || constants_1.LOG_DIR),
     PORT: zod_1.z.string().optional().default('3005'),
+    MCP_RESOURCE_METADATA_URL: zod_1.z
+        .string()
+        .url()
+        .or(zod_1.z.string().regex(/^\/.*/, 'Must be an absolute path or URL'))
+        .optional()
+        .transform((val) => val || '/.well-known/oauth-protected-resource'),
     LOG_TRANSPORT: zod_1.z
-        .enum(['console', 'file', 'cloudwatch'])
+        .string()
         .optional()
-        .default('file'),
+        .default('file')
+        .transform((val, ctx) => {
+        try {
+            return parseLogTransports(val);
+        }
+        catch (error) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: error instanceof Error
+                    ? error.message
+                    : 'Invalid LOG_TRANSPORT value',
+            });
+            return zod_1.z.NEVER;
+        }
+    }),
     ENVIRONMENT: zod_1.z
         .enum(['dev', 'prod'])
         .optional()
         .default(getRunningEnvironment()),
+    /** Idle TTL (ms): session is destroyed after this long without activity; refreshed on each interaction. */
+    MCP_SESSION_TTL_MS: zod_1.z
+        .string()
+        .optional()
+        .default(String(1000 * 60 * 60))
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0) {
+            throw new Error('MCP_SESSION_TTL_MS must be a positive number');
+        }
+        return n;
+    }),
+    MCP_SESSION_MAX_SESSIONS: zod_1.z
+        .string()
+        .optional()
+        .default('2000')
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+            throw new Error('MCP_SESSION_MAX_SESSIONS must be a positive integer');
+        }
+        return n;
+    }),
+    MCP_SESSION_CLEANUP_INTERVAL_MS: zod_1.z
+        .string()
+        .optional()
+        .default(String(1000 * 60 * 5))
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0) {
+            throw new Error('MCP_SESSION_CLEANUP_INTERVAL_MS must be a positive number');
+        }
+        return n;
+    }),
+    /**
+     * Optional absolute max session lifetime (ms) from createdAt.
+     * 0 = disabled (sliding idle only). When set, idle extension cannot push expiresAt past createdAt + max age.
+     */
+    MCP_SESSION_MAX_AGE_MS: zod_1.z
+        .string()
+        .optional()
+        .default('0')
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n < 0 || !Number.isInteger(n)) {
+            throw new Error('MCP_SESSION_MAX_AGE_MS must be a non-negative integer (0 disables)');
+        }
+        return n;
+    }),
+    /**
+     * When false, suppresses all session-lifecycle log events
+     * (SESSION_CREATED, SESSION_DESTROYED, SESSION_METRICS, SESSION_REQUEST_QUEUE_ACQUIRED, etc.).
+     * Set to false when running the stateless transport so CloudWatch and local
+     * logs stay free of session noise.  Defaults to true for the session transport.
+     */
+    MCP_SESSION_LOGS_ENABLED: zod_1.z
+        .string()
+        .optional()
+        .default('true')
+        .transform((value) => value.toLowerCase() === 'true'),
+    /**
+     * TEMPORARY incident diagnostics toggle for MCP transport send path.
+     * Keep disabled by default and enable only during active production investigation.
+     */
+    MCP_TRANSPORT_DIAGNOSTICS_ENABLED: zod_1.z
+        .string()
+        .optional()
+        .default('true')
+        .transform((value) => value.toLowerCase() === 'true'),
+    /**
+     * Phase 1 mitigation: max time (ms) a tools/call request can wait in the per-session queue.
+     * Requests exceeding this wait fail fast with a deterministic JSON-RPC timeout error.
+     */
+    MCP_TOOL_CALL_QUEUE_TIMEOUT_MS: zod_1.z
+        .string()
+        .optional()
+        .default('15000')
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+            throw new Error('MCP_TOOL_CALL_QUEUE_TIMEOUT_MS must be a positive integer');
+        }
+        return n;
+    }),
+    /**
+     * Max time (ms) any session-bound POST request can wait in the per-session queue.
+     * Defaults to MCP_TOOL_CALL_QUEUE_TIMEOUT_MS behavior for backward compatibility.
+     */
+    MCP_SESSION_REQUEST_QUEUE_TIMEOUT_MS: zod_1.z
+        .string()
+        .optional()
+        .default(process.env.MCP_TOOL_CALL_QUEUE_TIMEOUT_MS || '15000')
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+            throw new Error('MCP_SESSION_REQUEST_QUEUE_TIMEOUT_MS must be a positive integer');
+        }
+        return n;
+    }),
+    /**
+     * Safety timeout for transport execution after a queue slot is acquired.
+     * Prevents indefinite hangs inside transport.handleRequest for a reused session.
+     */
+    MCP_TRANSPORT_EXECUTION_TIMEOUT_MS: zod_1.z
+        .string()
+        .optional()
+        .default('30000')
+        .transform((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+            throw new Error('MCP_TRANSPORT_EXECUTION_TIMEOUT_MS must be a positive integer');
+        }
+        return n;
+    }),
 });
 const getEnvironment = () => {
     try {

package/dist/config/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,4CAAwD;AAExD,MAAM,qBAAqB,GAAG,GAAmB,EAAE;IACjD,kDAAkD;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC;IAEjE,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,qBAAqB,EAAE,OAAC;SACrB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,2BAAe,CAAC;IAC7C,oBAAoB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,OAAC;SACT,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAClB,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,mBAAO,CAAC;IACrC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,OAAC;SACb,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAClB,WAAW,EAAE,OAAC;SACX,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SACrB,QAAQ,EAAE;SACV,OAAO,CAAC,qBAAqB,EAAE,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,GAAgC,EAAE;IACvD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,iBAAiB,GAAG,GAAG,EAAE;;IACpC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,GAAG,CAAC,QAAQ,0CAAE,WAAW,EAAE,CAAC;IAEpD,OAAO,OAAO,KAAK,MAAM,CAAC;AAC5B,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AAEW,QAAA,GAAG,GAAG,cAAc,EAAE,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"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"}

package/dist/cv-api.js

@@ -4,11 +4,26 @@ exports.getCarbonVoiceApiStatus = exports.getCarbonVoiceAPI = void 0;
 const config_1 = require("./config");
 const utils_1 = require("./utils");
 const axios_instance_1 = require("./utils/axios-instance");
+const mapContactToUserInfo = (contact) => {
+    const { user_guid, workspace_guids, ...rest } = contact;
+    return {
+        ...rest,
+        id: user_guid,
+        workspace_ids: workspace_guids,
+    };
+};
 const getCarbonVoiceAPI = () => {
     return {
         getWhoAmI: async (options) => {
             return (0, axios_instance_1.mutator)({ url: `/whoami`, method: 'GET' }, options);
         },
+        getContacts: async (userIds, options) => {
+            if (userIds.length === 0) {
+                throw new Error('getContacts requires at least one user ID');
+            }
+            const contacts = await (0, axios_instance_1.mutator)({ url: '/contacts', method: 'POST', data: { user_guids: userIds } }, options);
+            return contacts.map(mapContactToUserInfo);
+        },
     };
 };
 exports.getCarbonVoiceAPI = getCarbonVoiceAPI;

package/dist/cv-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"cv-api.js","sourceRoot":"","sources":["../src/cv-api.ts"],"names":[],"mappings":";;;AAEA,qCAA+B;AAC/B,mCAAiC;AACjC,2DAAiD;AAE1C,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,OAA4B,EAAoB,EAAE;YAClE,OAAO,IAAA,wBAAO,EAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B;AAEK,MAAM,uBAAuB,GAAG,KAAK,IAIzC,EAAE;IACH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAO,EAE3B,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;YACnC,MAAM,EAAE,YAAG,CAAC,qBAAqB;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,YAAG,CAAC,qBAAqB;YACjC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAtBW,QAAA,uBAAuB,2BAsBlC"}
+{"version":3,"file":"cv-api.js","sourceRoot":"","sources":["../src/cv-api.ts"],"names":[],"mappings":";;;AAEA,qCAA+B;AAE/B,mCAAiC;AACjC,2DAAiD;AAkBjD,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAY,EAAE;IAC1D,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACxD,OAAO;QACL,GAAG,IAAI;QACP,EAAE,EAAE,SAAS;QACb,aAAa,EAAE,eAAe;KAC/B,CAAC;AACJ,CAAC,CAAC;AAEK,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,OAA4B,EAAoB,EAAE;YAClE,OAAO,IAAA,wBAAO,EAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAED,WAAW,EAAE,KAAK,EAChB,OAAiB,EACjB,OAA4B,EACP,EAAE;YACvB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAO,EAC5B,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EACnE,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,iBAAiB,qBAoB5B;AAEK,MAAM,uBAAuB,GAAG,KAAK,IAIzC,EAAE;IACH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAO,EAE3B,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;YACnC,MAAM,EAAE,YAAG,CAAC,qBAAqB;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,YAAG,CAAC,qBAAqB;YACjC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAtBW,QAAA,uBAAuB,2BAsBlC"}

package/dist/interfaces/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./mcp-tool-response.interface"), exports);
 __exportStar(require("./message.interface"), exports);
 __exportStar(require("./get-by-id.interface"), exports);
 __exportStar(require("./folder.interface"), exports);
+__exportStar(require("./user-info.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,sDAAoC;AACpC,wDAAsC;AACtC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,sDAAoC;AACpC,wDAAsC;AACtC,qDAAmC;AACnC,wDAAsC"}

package/dist/interfaces/user-info.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user-info.interface.js.map

package/dist/interfaces/user-info.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-info.interface.js","sourceRoot":"","sources":["../../src/interfaces/user-info.interface.ts"],"names":[],"mappings":""}