@pipeshub-ai/mcp 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/bin/mcp-server.js +36 -26
  2. package/bin/mcp-server.js.map +4 -4
  3. package/esm/mcp-server/tools/pipeshubChat.d.ts +2 -2
  4. package/esm/mcp-server/tools/pipeshubChat.d.ts.map +1 -1
  5. package/esm/mcp-server/tools/pipeshubChat.js +26 -14
  6. package/esm/mcp-server/tools/pipeshubChat.js.map +1 -1
  7. package/esm/tool-names.js +1 -1
  8. package/esm/tool-names.js.map +1 -1
  9. package/package.json +1 -1
  10. package/src/mcp-server/tools/pipeshubChat.ts +27 -15
  11. package/src/tool-names.ts +1 -1
package/esm/mcp-server/tools/pipeshubChat.d.ts CHANGED
@@ -11,8 +11,8 @@ declare const args: {
11
11
  modelName: z.ZodOptional<z.ZodString>;
12
12
  modelFriendlyName: z.ZodOptional<z.ZodString>;
13
13
  chatMode: z.ZodOptional<z.ZodEnum<{
14
- quick: "quick";
15
- balanced: "balanced";
14
+ web_search: "web_search";
15
+ internal_search: "internal_search";
16
16
  }>>;
17
17
  };
18
18
  export declare const tool$pipeshubChat: ToolDefinition<typeof args>;
package/esm/mcp-server/tools/pipeshubChat.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pipeshubChat.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/pipeshubChat.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmB7C,QAAA,MAAM,IAAI;;;;;;;;;;;;;;CAwBT,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,OAAO,IAAI,CAmJzD,CAAC"}
1
+ {"version":3,"file":"pipeshubChat.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/pipeshubChat.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmB7C,QAAA,MAAM,IAAI;;;;;;;;;;;;;;CA+BT,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,OAAO,IAAI,CAwJzD,CAAC"}
package/esm/mcp-server/tools/pipeshubChat.js CHANGED
@@ -47,25 +47,37 @@ const args = {
47
47
  + "Defaults to the org's default LLM."),
48
48
  modelName: z.string().optional(),
49
49
  modelFriendlyName: z.string().optional(),
50
- chatMode: z.enum(["quick", "balanced"]).optional().describe("`quick` for low-retrieval / fast answers; `balanced` for full RAG. "
51
- + "Default `quick`."),
50
+ chatMode: z.enum(["web_search", "internal_search"]).optional().describe("Controls retrieval source. "
51
+ + "`internal_search` (default) — searches the org's indexed knowledge "
52
+ + "bases (Drive, Confluence, Slack, Gmail, Jira, Box, etc.) and returns "
53
+ + "citations. Use this for questions about internal docs, policies, or "
54
+ + "company data. "
55
+ + "`web_search` — searches the public web instead of internal sources. "
56
+ + "Use only when the user explicitly asks about current events, public "
57
+ + "information, or anything not expected to be in the org's KB. "
58
+ + "Omit this field (or pass `internal_search`) for all normal queries."),
52
59
  };
53
60
  export const tool$pipeshubChat = {
54
61
  name: "pipeshub_chat",
55
- description: `**Default tool for anything PipesHub-related.** Use this whenever the
56
- user asks about their documents, files, knowledge base, company
57
- policies, or anything that could plausibly be answered by content in
58
- their PipesHub-indexed sources (Drive, Box, Confluence, Slack, Gmail,
59
- Jira, the org's KB, ...). Do NOT answer those from your own knowledge —
60
- \`pipeshub_chat\` grounds the answer in the user's actual data and
61
- returns citations.
62
+ description: `**Primary chat tool — handles both internal knowledge queries and web search.**
63
+
64
+ **Internal search** (default, \`chatMode: "internal_search"\`): Use whenever
65
+ the user asks about their documents, files, knowledge base, company policies,
66
+ or anything that could plausibly be answered by content in their PipesHub-indexed
67
+ sources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).
68
+ Grounds the answer in the user's actual data and returns citations.
69
+
70
+ **Web search** (\`chatMode: "web_search"\`): Use when the user asks about
71
+ current events, public information, or anything unlikely to be in the org's
72
+ internal knowledge base. Pass \`chatMode: "web_search"\` and this tool will
73
+ search the public web instead.
62
74
 
63
75
  **When to pick this over other tools:**
64
- - "What does <document> say about X?" → \`pipeshub_chat\` (NOT search;
65
- search is only for locating files by name).
66
- - "Summarize <topic / doc>." → \`pipeshub_chat\`.
67
- - "What's our policy on Y?" → \`pipeshub_chat\`.
68
- - "What do we know about Z?" → \`pipeshub_chat\`.
76
+ - "What does <document> say about X?" → \`pipeshub_chat\` (internal_search)
77
+ - "Summarize <topic / doc>." → \`pipeshub_chat\` (internal_search)
78
+ - "What's our policy on Y?" → \`pipeshub_chat\` (internal_search)
79
+ - "What's in the news about Z?" → \`pipeshub_chat\` (web_search)
80
+ - "What is the latest version of <library>?" → \`pipeshub_chat\` (web_search)
69
81
  - "Find / locate the file named X" → \`pipeshub_search\` (then
70
82
  \`pipeshub_download_record\` if the user wants the bytes).
71
83
 
package/esm/mcp-server/tools/pipeshubChat.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pipeshubChat.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/pipeshubChat.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pipeshubChat.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/pipeshubChat.ts"],"names":[],"mappings":"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"}
package/esm/tool-names.js CHANGED
@@ -6,7 +6,7 @@ export const toolNames = [
6
6
  },
7
7
  {
8
8
  "name": "pipeshub_chat",
9
- "description": "**Default tool for anything PipesHub-related.** Use this whenever the\nuser asks about their documents, files, knowledge base, company\npolicies, or anything that could plausibly be answered by content in\ntheir PipesHub-indexed sources (Drive, Box, Confluence, Slack, Gmail,\nJira, the org's KB, ...). Do NOT answer those from your own knowledge —\n`pipeshub_chat` grounds the answer in the user's actual data and\nreturns citations.\n\n**When to pick this over other tools:**\n- \"What does <document> say about X?\" → `pipeshub_chat` (NOT search;\n search is only for locating files by name).\n- \"Summarize <topic / doc>.\" → `pipeshub_chat`.\n- \"What's our policy on Y?\" → `pipeshub_chat`.\n- \"What do we know about Z?\" → `pipeshub_chat`.\n- \"Find / locate the file named X\" → `pipeshub_search` (then\n `pipeshub_download_record` if the user wants the bytes).\n\n**Conversation lifecycle** — one tool, both start and continue:\n\n- **First turn**: omit `conversationId`. The server creates a new\n conversation; capture `conversationId` from the response.\n- **Follow-up turn**: pass the `conversationId` from the previous\n response. Server-side context is preserved — do NOT replay earlier\n messages, and `filters` is ignored on follow-ups (set once at\n creation).\n\nOnly re-omit `conversationId` (start a fresh conversation) when the\nuser explicitly asks to start over / clear context.\n\nThe response contains the AI's `answer` plus `citations`. To download a\ncited document, take `citations[*].recordId` and call\n`pipeshub_download_record`."
9
+ "description": "**Primary chat tool — handles both internal knowledge queries and web search.**\n\n**Internal search** (default, `chatMode: \"internal_search\"`): Use whenever\nthe user asks about their documents, files, knowledge base, company policies,\nor anything that could plausibly be answered by content in their PipesHub-indexed\nsources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).\nGrounds the answer in the user's actual data and returns citations.\n\n**Web search** (`chatMode: \"web_search\"`): Use when the user asks about\ncurrent events, public information, or anything unlikely to be in the org's\ninternal knowledge base. Pass `chatMode: \"web_search\"` and this tool will\nsearch the public web instead.\n\n**When to pick this over other tools:**\n- \"What does <document> say about X?\" → `pipeshub_chat` (internal_search)\n- \"Summarize <topic / doc>.\" → `pipeshub_chat` (internal_search)\n- \"What's our policy on Y?\" → `pipeshub_chat` (internal_search)\n- \"What's in the news about Z?\" → `pipeshub_chat` (web_search)\n- \"What is the latest version of <library>?\" → `pipeshub_chat` (web_search)\n- \"Find / locate the file named X\" → `pipeshub_search` (then\n `pipeshub_download_record` if the user wants the bytes).\n\n**Conversation lifecycle** — one tool, both start and continue:\n\n- **First turn**: omit `conversationId`. The server creates a new\n conversation; capture `conversationId` from the response.\n- **Follow-up turn**: pass the `conversationId` from the previous\n response. Server-side context is preserved — do NOT replay earlier\n messages, and `filters` is ignored on follow-ups (set once at\n creation).\n\nOnly re-omit `conversationId` (start a fresh conversation) when the\nuser explicitly asks to start over / clear context.\n\nThe response contains the AI's `answer` plus `citations`. To download a\ncited document, take `citations[*].recordId` and call\n`pipeshub_download_record`."
10
10
  },
11
11
  {
12
12
  "name": "pipeshub_search",
package/esm/tool-names.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,SAAS,GAAgD;IACpE;QACE,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,80BAA80B;KAC91B;IACD;QACE,MAAM,EAAE,eAAe;QACvB,aAAa,EAAE,kiDAAkiD;KACljD;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,uvBAAuvB;KACvwB;IACD;QACE,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,8dAA8d;KAC9e;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,aAAa,EAAE,onBAAonB;KACpoB;CACF,CAAC"}
1
+ {"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../src/tool-names.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,SAAS,GAAgD;IACpE;QACE,MAAM,EAAE,kBAAkB;QAC1B,aAAa,EAAE,80BAA80B;KAC91B;IACD;QACE,MAAM,EAAE,eAAe;QACvB,aAAa,EAAE,65DAA65D;KAC76D;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,uvBAAuvB;KACvwB;IACD;QACE,MAAM,EAAE,0BAA0B;QAClC,aAAa,EAAE,8dAA8d;KAC9e;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,aAAa,EAAE,onBAAonB;KACpoB;CACF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pipeshub-ai/mcp",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "author": "Pipeshub",
5
5
  "type": "module",
6
6
  "sideEffects": false,
package/src/mcp-server/tools/pipeshubChat.ts CHANGED
@@ -68,29 +68,41 @@ const args = {
68
68
  ),
69
69
  modelName: z.string().optional(),
70
70
  modelFriendlyName: z.string().optional(),
71
- chatMode: z.enum(["quick", "balanced"]).optional().describe(
72
- "`quick` for low-retrieval / fast answers; `balanced` for full RAG. "
73
- + "Default `quick`.",
71
+ chatMode: z.enum(["web_search", "internal_search"]).optional().describe(
72
+ "Controls retrieval source. "
73
+ + "`internal_search` (default) — searches the org's indexed knowledge "
74
+ + "bases (Drive, Confluence, Slack, Gmail, Jira, Box, etc.) and returns "
75
+ + "citations. Use this for questions about internal docs, policies, or "
76
+ + "company data. "
77
+ + "`web_search` — searches the public web instead of internal sources. "
78
+ + "Use only when the user explicitly asks about current events, public "
79
+ + "information, or anything not expected to be in the org's KB. "
80
+ + "Omit this field (or pass `internal_search`) for all normal queries.",
74
81
  ),
75
82
  };
76
83
 
77
84
  export const tool$pipeshubChat: ToolDefinition<typeof args> = {
78
85
  name: "pipeshub_chat",
79
86
  description:
80
- `**Default tool for anything PipesHub-related.** Use this whenever the
81
- user asks about their documents, files, knowledge base, company
82
- policies, or anything that could plausibly be answered by content in
83
- their PipesHub-indexed sources (Drive, Box, Confluence, Slack, Gmail,
84
- Jira, the org's KB, ...). Do NOT answer those from your own knowledge —
85
- \`pipeshub_chat\` grounds the answer in the user's actual data and
86
- returns citations.
87
+ `**Primary chat tool — handles both internal knowledge queries and web search.**
88
+
89
+ **Internal search** (default, \`chatMode: "internal_search"\`): Use whenever
90
+ the user asks about their documents, files, knowledge base, company policies,
91
+ or anything that could plausibly be answered by content in their PipesHub-indexed
92
+ sources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).
93
+ Grounds the answer in the user's actual data and returns citations.
94
+
95
+ **Web search** (\`chatMode: "web_search"\`): Use when the user asks about
96
+ current events, public information, or anything unlikely to be in the org's
97
+ internal knowledge base. Pass \`chatMode: "web_search"\` and this tool will
98
+ search the public web instead.
87
99
 
88
100
  **When to pick this over other tools:**
89
- - "What does <document> say about X?" → \`pipeshub_chat\` (NOT search;
90
- search is only for locating files by name).
91
- - "Summarize <topic / doc>." → \`pipeshub_chat\`.
92
- - "What's our policy on Y?" → \`pipeshub_chat\`.
93
- - "What do we know about Z?" → \`pipeshub_chat\`.
101
+ - "What does <document> say about X?" → \`pipeshub_chat\` (internal_search)
102
+ - "Summarize <topic / doc>." → \`pipeshub_chat\` (internal_search)
103
+ - "What's our policy on Y?" → \`pipeshub_chat\` (internal_search)
104
+ - "What's in the news about Z?" → \`pipeshub_chat\` (web_search)
105
+ - "What is the latest version of <library>?" → \`pipeshub_chat\` (web_search)
94
106
  - "Find / locate the file named X" → \`pipeshub_search\` (then
95
107
  \`pipeshub_download_record\` if the user wants the bytes).
96
108
 
package/src/tool-names.ts CHANGED
@@ -6,7 +6,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
6
6
  },
7
7
  {
8
8
  "name": "pipeshub_chat",
9
- "description": "**Default tool for anything PipesHub-related.** Use this whenever the\nuser asks about their documents, files, knowledge base, company\npolicies, or anything that could plausibly be answered by content in\ntheir PipesHub-indexed sources (Drive, Box, Confluence, Slack, Gmail,\nJira, the org's KB, ...). Do NOT answer those from your own knowledge —\n`pipeshub_chat` grounds the answer in the user's actual data and\nreturns citations.\n\n**When to pick this over other tools:**\n- \"What does <document> say about X?\" → `pipeshub_chat` (NOT search;\n search is only for locating files by name).\n- \"Summarize <topic / doc>.\" → `pipeshub_chat`.\n- \"What's our policy on Y?\" → `pipeshub_chat`.\n- \"What do we know about Z?\" → `pipeshub_chat`.\n- \"Find / locate the file named X\" → `pipeshub_search` (then\n `pipeshub_download_record` if the user wants the bytes).\n\n**Conversation lifecycle** — one tool, both start and continue:\n\n- **First turn**: omit `conversationId`. The server creates a new\n conversation; capture `conversationId` from the response.\n- **Follow-up turn**: pass the `conversationId` from the previous\n response. Server-side context is preserved — do NOT replay earlier\n messages, and `filters` is ignored on follow-ups (set once at\n creation).\n\nOnly re-omit `conversationId` (start a fresh conversation) when the\nuser explicitly asks to start over / clear context.\n\nThe response contains the AI's `answer` plus `citations`. To download a\ncited document, take `citations[*].recordId` and call\n`pipeshub_download_record`."
9
+ "description": "**Primary chat tool — handles both internal knowledge queries and web search.**\n\n**Internal search** (default, `chatMode: \"internal_search\"`): Use whenever\nthe user asks about their documents, files, knowledge base, company policies,\nor anything that could plausibly be answered by content in their PipesHub-indexed\nsources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).\nGrounds the answer in the user's actual data and returns citations.\n\n**Web search** (`chatMode: \"web_search\"`): Use when the user asks about\ncurrent events, public information, or anything unlikely to be in the org's\ninternal knowledge base. Pass `chatMode: \"web_search\"` and this tool will\nsearch the public web instead.\n\n**When to pick this over other tools:**\n- \"What does <document> say about X?\" → `pipeshub_chat` (internal_search)\n- \"Summarize <topic / doc>.\" → `pipeshub_chat` (internal_search)\n- \"What's our policy on Y?\" → `pipeshub_chat` (internal_search)\n- \"What's in the news about Z?\" → `pipeshub_chat` (web_search)\n- \"What is the latest version of <library>?\" → `pipeshub_chat` (web_search)\n- \"Find / locate the file named X\" → `pipeshub_search` (then\n `pipeshub_download_record` if the user wants the bytes).\n\n**Conversation lifecycle** — one tool, both start and continue:\n\n- **First turn**: omit `conversationId`. The server creates a new\n conversation; capture `conversationId` from the response.\n- **Follow-up turn**: pass the `conversationId` from the previous\n response. Server-side context is preserved — do NOT replay earlier\n messages, and `filters` is ignored on follow-ups (set once at\n creation).\n\nOnly re-omit `conversationId` (start a fresh conversation) when the\nuser explicitly asks to start over / clear context.\n\nThe response contains the AI's `answer` plus `citations`. To download a\ncited document, take `citations[*].recordId` and call\n`pipeshub_download_record`."
10
10
  },
11
11
  {
12
12
  "name": "pipeshub_search",