@great-detail/support-mcp 0.3.0 → 0.4.0

package/README.md

@@ -2,7 +2,20 @@
 
 [![NPM package @great-detail/support-mcp version](https://img.shields.io/npm/v/%40great-detail/support-mcp)](https://npmjs.com/package/@great-detail/support-mcp)
 
-TODO :)
+```json
+{
+  "mcpServers": {
+    "support": {
+      "command": "npx",
+      "args": ["@great-detail/support-mcp"],
+      "env": {
+        "SUPPORT_KEY_NAME": "...",
+        "SUPPORT_KEY_PASSWORD": "..."
+      }
+    }
+  }
+}
+```
 
 ## License
 

package/dist/cli.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-import{McpServer as m}from"@modelcontextprotocol/sdk/server/mcp.js";import u,{SDK_VERSION as h,SupportError as g}from"@great-detail/support-sdk";import{z as o}from"zod";import{outdent as r}from"outdent";var f=new u.BasicAuthentication,i=new u(f),a=new m({name:"support",version:h,capabilities:{resources:{},tools:{}}});a.registerTool("list-messages",{title:"List Support Messages",description:"List the stored Support Messages"},async()=>{let e=await i.message.list().json(),n=[];for(let{message:s}of e.data)s.type==="text"&&n.push({type:"text",text:`${s.messageText.body}`});return{content:n}});a.registerTool("list-conversations",{title:"List Support Conversations",description:"List the stored Support Conversations",inputSchema:{filter:o.enum(["unresolved","awaitingContact","awaitingAgent","escalated"]).optional().describe(r`filter the conversations by type, optional
+import{McpServer as A}from"@modelcontextprotocol/sdk/server/mcp.js";import $ from"@great-detail/support-sdk";import w from"zod";function i(s){return s}var f=i(function(r,{cache:a,client:n}){r.registerTool("list-messages",{title:"List Support Messages",description:"List the stored Support Messages"},async()=>{let e=await n.message.list().json(),t=[];for(let{message:p}of e.data)p.type==="text"&&t.push({type:"text",text:`${p.messageText.body}`});return{content:t}}),r.registerTool("get-message",{title:"Get a Support Message by ID",description:"Get a stored Support Message with its ID",inputSchema:{id:w.string().describe("the message's id")}},async({id:e})=>{let{data:{message:t}}=await a.wrap(`messages:${e}`,()=>n.message.get(e).json(),{ttl:3e4});return t.type==="email"?{content:[{type:"text",text:`${t.messageEmail.bodyText}`}]}:t.type==="text"?{content:[{type:"text",text:`${t.messageText.body}`}]}:(console.error("Cannot format message into MCP content for type:",t.type),{content:[]})})});import{outdent as h}from"outdent";import m from"zod";var y=i(function(r,{cache:a,client:n}){r.registerTool("list-conversations",{title:"List Support Conversations",description:"List the stored Support Conversations",inputSchema:{filter:m.enum(["unresolved","awaitingContact","awaitingAgent","escalated"]).optional().describe(h`filter the conversations by type, optional
           - unresolved: conversations that haven't been closed or resolved, includes both awaitingContact and awaitingAgent
           - awaitingContact: conversations that are waiting from a response from the contact
           - awaitingAgent: conversations that are waiting from a response from an agent
-          - escalated: conversations that have been marked for escalation`),query:o.string().optional().describe(r`search query for conversations, optional
-          Searches through titles, contacts, and messages that are linked to the conversation`)}},async({filter:e,query:n})=>({content:(await i.conversation.list({filter:{filter:e,query:n}}).json()).data.map(({conversation:t})=>({type:"text",text:`${t.name??"Un-named Conversation"} - Opened ${new Date(t.createdAt).toDateString()}${t.createdAt===t.updatedAt?"":`, Last Updated ${new Date(t.updatedAt).toDateString()}`} (${t.status})`}))}));a.registerTool("list-contacts",{title:"List Support Contacts",description:"List the stored Support Contacts",inputSchema:{type:o.enum(["consumer","representative","assistant"]).optional().describe(r`filter the contacts by type, optional
+          - escalated: conversations that have been marked for escalation`),query:m.string().optional().describe(h`search query for conversations, optional
+          Searches through titles, contacts, and messages that are linked to the conversation`)}},async({filter:e,query:t})=>({content:(await n.conversation.list({filter:{filter:e,query:t}}).json()).data.map(({conversation:o})=>({type:"text",text:`${o.name??"Un-named Conversation"} - Opened ${new Date(o.createdAt).toDateString()}${o.createdAt===o.updatedAt?"":`, Last Updated ${new Date(o.updatedAt).toDateString()}`} (${o.status})`}))})),r.registerTool("get-conversation",{title:"Get a Support Conversation by ID",description:"Get a stored Support Conversations with its ID",inputSchema:{id:m.string().describe("the conversation's id")}},async({id:e})=>{let{data:{conversation:t}}=await a.wrap(`conversations:${e}`,()=>n.conversation.get(e).json(),{ttl:3e4});return{content:[{type:"text",text:`${t.name??"Un-named Conversation"} - Opened ${new Date(t.createdAt).toDateString()}${t.createdAt===t.updatedAt?"":`, Last Updated ${new Date(t.updatedAt).toDateString()}`} (${t.status})`}]}})});import{SupportError as b}from"@great-detail/support-sdk";import{outdent as S}from"outdent";import c from"zod";var v=i(function(r,{cache:a,client:n}){r.registerTool("list-contacts",{title:"List Support Contacts",description:"List the stored Support Contacts",inputSchema:{type:c.enum(["consumer","representative","assistant"]).optional().describe(S`filter the contacts by type, optional
           - consumer: contacts for end users and customers
           - representative: contacts for human support agents
-          - assistant: contacts for AI automated support agents`),query:o.string().optional().describe("search query for contacts, optional")}},async({type:e,query:n})=>({content:(await i.contact.list({filter:{type:e,query:n}}).json()).data.map(({contact:t})=>({type:"text",text:`${t.name??"Un-named Contact"}${t.emailAddress?" - "+t.emailAddress:""} (${t.type==="assistant"?"AI Agent":t.type==="representative"?"Human Agent":"Client/Customer"} Contact)`}))}));a.registerTool("create-contact",{title:"Create a Support Contact",description:r`Create a new support contact.
+          - assistant: contacts for AI automated support agents`),query:c.string().optional().describe("search query for contacts, optional")}},async({type:e,query:t})=>({content:(await n.contact.list({filter:{type:e,query:t}}).json()).data.map(({contact:o})=>({type:"text",text:`${o.name??"Un-named Contact"}${o.emailAddress?" - "+o.emailAddress:""} (${o.type==="assistant"?"AI Agent":o.type==="representative"?"Human Agent":"Client/Customer"} Contact)`}))})),r.registerTool("create-contact",{title:"Create a Support Contact",description:S`Create a new support contact.
         Ask the user for a name if they don't provide one.
         Suggest that the user adds contact details if they provide none.
-        Assume that the user wants to create a consumer contact if they don't specify otherwise.`,inputSchema:{type:o.enum(["consumer","assistant","representative"]).optional().default("consumer").describe("the contact's type, consumer if not specified"),name:o.string().min(1).describe("the contact's name, required"),emailAddress:o.string().email().optional().describe("the contact's email address, optional"),telephoneNumber:o.string().optional().describe("the contact's phone number, optional")}},async({type:e,name:n,emailAddress:s,telephoneNumber:t})=>{let c;try{c=await i.contact.create({body:{type:e,name:n,emailAddress:s,telephoneNumber:t}}).json()}catch(p){if(!(p instanceof g))return{content:[{type:"text",text:"Contact could not be created"}]};let d=await p.response.json();return console.error(d),{content:[{type:"text",text:"Contact could not be created: "+d.error.title}]}}return{content:[{type:"text",text:"New contact created with id: "+c.data.contact.id}]}});var l=a;import{StdioServerTransport as y}from"@modelcontextprotocol/sdk/server/stdio.js";try{let e=new y;await l.connect(e),console.error("GD Support MCP Server running on stdio")}catch(e){console.error("Fatal error in main():",e),process.exit(1)}
+        Assume that the user wants to create a consumer contact if they don't specify otherwise.`,inputSchema:{type:c.enum(["consumer","assistant","representative"]).optional().default("consumer").describe("the contact's type, consumer if not specified"),name:c.string().min(1).describe("the contact's name, required"),emailAddress:c.string().email().optional().describe("the contact's email address, optional"),telephoneNumber:c.string().optional().describe("the contact's phone number, optional")}},async({type:e,name:t,emailAddress:p,telephoneNumber:o})=>{let d;try{d=await n.contact.create({body:{type:e,name:t,emailAddress:p,telephoneNumber:o}}).json()}catch(l){if(!(l instanceof b))return{content:[{type:"text",text:"Contact could not be created"}]};let g=await l.response.json();return console.error(g),{content:[{type:"text",text:"Contact could not be created: "+g.error.title}]}}return{content:[{type:"text",text:"New contact created with id: "+d.data.contact.id}]}}),r.registerTool("get-contact",{title:"Get a Support Contact by ID",description:"Get a stored Support Contact with its ID",inputSchema:{id:c.string().describe("the contact's id")}},async({id:e})=>{let{data:{contact:t}}=await a.wrap(`contacts:${e}`,()=>n.contact.get(e).json(),{ttl:3e4});return{content:[{type:"text",text:`${t.name??"Un-named Contact"}${t.emailAddress?" - "+t.emailAddress:""} (${t.type==="assistant"?"AI Agent":t.type==="representative"?"Human Agent":"Client/Customer"} Contact)`}]}})});import G from"keyv";import{createCache as D}from"cache-manager";var x="0.4.0";var C=process.env.npm_package_version??x;function u(){let s=D({stores:[new G]}),r=new $,a=new A({name:"support",title:"Great Detail Support",version:C,capabilities:{resources:{},tools:{}}}),n={client:r,cache:s};return[f,y,v].map(t=>t(a,n)),a}import{StdioServerTransport as I}from"@modelcontextprotocol/sdk/server/stdio.js";try{let s=u(),r=new I;await s.connect(r),console.error("GD Support MCP Server running on stdio")}catch(s){console.error("Fatal error in main():",s),process.exit(1)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-detail/support-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "MCP Server for the Great Detail Support System",
   "author": "Great Detail Ltd <info@greatdetail.com>",
@@ -24,6 +24,8 @@
   "dependencies": {
     "@great-detail/support-sdk": "",
     "@modelcontextprotocol/sdk": "^1.16.0",
+    "cache-manager": "^7.0.1",
+    "keyv": "^5.4.0",
     "outdent": "^0.8.0",
     "zod": "^3.25.76"
   },
@@ -41,7 +43,10 @@
     "provenance": false
   },
   "scripts": {
+    "prebuild": "pnpm run gen",
     "build": "tsup src/entrypoint/cli.ts --format esm --minify",
+    "gen": "pnpm run --parallel /^gen:.*/",
+    "gen:static": "tsx gen-static.ts",
     "test": "node --import tsx --test --experimental-test-coverage src/__tests__/**/*.test.ts src/__tests__/*.test.ts",
     "typecheck": "tsc --noEmit"
   }