@pipeshub-ai/mcp 2.1.0 → 2.2.0

package/bin/mcp-server.js

@@ -50394,14 +50394,35 @@ PipesHub is the user's workplace AI platform. It indexes their documents,
 knowledge base content, and connector sources (Drive, Box, Confluence,
 Slack, Jira, Gmail, ...). When in doubt, the answer is in PipesHub.
 
+## Full-document tasks: \`pipeshub_search\` → \`pipeshub_get_record_content\`
+
+\`pipeshub_chat\` answers from a handful of retrieved passages — it never
+reads a whole document. Whenever the task depends on a document's
+COMPLETE content, fetch the document itself:
+
+1. \`pipeshub_search\` with the document's name / topic.
+2. Take the top hit's \`recordId\`.
+3. \`pipeshub_get_record_content\`, and answer from the returned content.
+
+Tasks that need this path — anything where missing part of the document
+could make the answer wrong:
+
+- Summarize / TL;DR / key points / takeaways / action items of a doc.
+- Extract or list ALL of something (dates, owners, requirements, ...).
+- Check whether / where a doc mentions something.
+- Translate, rewrite, outline, review, or reformat a doc.
+- Compare named docs (fetch each \`recordId\`).
+- Any question explicitly scoped to ONE named document — chat retrieval
+  cannot be restricted to a single record.
+
 ## Default tool: \`pipeshub_chat\`
 
 **Use \`pipeshub_chat\` for any question that could plausibly be answered
-by the user's PipesHub-indexed data.** That includes:
+by the user's PipesHub-indexed data** and is not a full-document task:
 
-- Anything about a specific document, file, report, ticket, message, or
-  page (e.g. "what's in the Q4 sales report?", "summarize the langchain
-  doc", "what did Aashil say about onboarding?").
+- A question that may span several documents, or where you don't yet
+  know which record holds the answer (e.g. "what did Aashil say about
+  onboarding?").
 - Anything about company / org policies, processes, decisions, or
   history (e.g. "what's our vacation policy?", "who owns the auth
   service?").
@@ -50417,15 +50438,17 @@ the user can verify.
 
 ## When to use the other tools
 
-- \`pipeshub_search\` — only when the user asks specifically to **find /
-  locate** a document by name or topic (so you can hand them a list, or
-  resolve a filename to a \`recordId\` for download). For "what does
-  the doc say?" use \`pipeshub_chat\` instead — it does the retrieval
-  internally.
+- \`pipeshub_search\` — locate a document by name or topic and resolve it
+  to a \`recordId\`. To read or summarize one specific document, search,
+  then pass the top hit's \`recordId\` to \`pipeshub_get_record_content\`.
 - \`pipeshub_download_record\` — when the user wants the actual file
   bytes (download, attach, open). Get the \`recordId\` either from
   citations on a prior \`pipeshub_chat\` response or from
   \`pipeshub_search\`.
+- \`pipeshub_get_record_content\` — when you need a record's full parsed
+  content (returned as a single \`content\` string: metadata header plus
+  the document's text) without downloading the original file. Prefer this
+  over download when the question is about what the record says.
 - \`pipeshub_directory\` — people, groups, teams, and \`whoami\` lookups.
   Not for documents.
 - \`pipeshub_sources\` — call once at the start of a session to discover
@@ -50467,8 +50490,110 @@ replay prior messages. Only start a fresh conversation when the user
 explicitly asks to clear context.
 `;
 
+// node_modules/nanoid/url-alphabet/index.js
+var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+
+// node_modules/nanoid/index.js
+import { webcrypto as crypto3 } from "node:crypto";
+function fillPool(bytes) {
+  if (bytes < 0)
+    throw new RangeError("Wrong ID size");
+  try {
+    if (!pool || pool.length < bytes) {
+      pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
+      crypto3.getRandomValues(pool);
+      poolOffset = 0;
+    } else if (poolOffset + bytes > pool.length) {
+      crypto3.getRandomValues(pool);
+      poolOffset = 0;
+    }
+  } catch (e) {
+    pool = undefined;
+    throw e;
+  }
+  poolOffset += bytes;
+}
+function nanoid2(size = 21) {
+  fillPool(size |= 0);
+  let id = "";
+  for (let i = poolOffset - size;i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id;
+}
+var POOL_SIZE_MULTIPLIER = 128, pool, poolOffset;
+var init_nanoid = () => {};
+
+// src/hooks/request-context.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+function bindNewRequestId() {
+  storage.enterWith({ random: nanoid2() });
+}
+function getRequestContextStore() {
+  return storage.getStore();
+}
+function newRequestId() {
+  return `mcp-${nanoid2()}`;
+}
+var storage;
+var init_request_context = __esm(() => {
+  init_nanoid();
+  storage = new AsyncLocalStorage;
+});
+
+// src/hooks/requestid.ts
+function decodeJwtPayload(token) {
+  try {
+    const base64Url = token.split(".")[1];
+    if (!base64Url)
+      return null;
+    const base642 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = base642 + "=".repeat((4 - base642.length % 4) % 4);
+    const claims = JSON.parse(Buffer.from(padded, "base64").toString("utf8"));
+    return typeof claims === "object" && claims !== null ? claims : null;
+  } catch {
+    return null;
+  }
+}
+function userIdFromRequest(request) {
+  const auth = request.headers.get("authorization") ?? "";
+  if (!auth.toLowerCase().startsWith("bearer "))
+    return null;
+  const token = auth.slice(7).trim();
+  const claims = decodeJwtPayload(token);
+  return claims?.["userId"] || null;
+}
+
+class RequestIDHook {
+  beforeRequest(_hookCtx, request) {
+    if (request.headers.get(REQUEST_ID_HEADER)) {
+      return request;
+    }
+    const store = getRequestContextStore();
+    if (!store) {
+      request.headers.set(REQUEST_ID_HEADER, newRequestId());
+      return request;
+    }
+    if (!store.finalId) {
+      const userId = userIdFromRequest(request);
+      store.finalId = userId ? `mcp-${userId}-${store.random}` : `mcp-${store.random}`;
+    }
+    request.headers.set(REQUEST_ID_HEADER, store.finalId);
+    return request;
+  }
+}
+var REQUEST_ID_HEADER = "x-request-id";
+var init_requestid = __esm(() => {
+  init_request_context();
+});
+
 // src/hooks/registration.ts
-function initHooks(hooks) {}
+function initHooks(hooks) {
+  hooks.registerBeforeRequestHook(new RequestIDHook);
+}
+var init_registration = __esm(() => {
+  init_requestid();
+});
 
 // src/lib/base64.ts
 function bytesToBase64(u8arr) {
@@ -51058,6 +51183,7 @@ class SDKHooks {
   }
 }
 var init_hooks = __esm(() => {
+  init_registration();
   init_clientcredentials();
 });
 
@@ -51882,9 +52008,15 @@ async function formatResult(response) {
   } else if (contentType.startsWith("audio/")) {
     const data = await valueToBase64(await response.arrayBuffer());
     content = data == null ? [] : [{ type: "audio", data, mimeType: contentType }];
-  } else {
+  } else if (contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || contentType.includes("yaml")) {
     const text = await response.text();
     content = [{ type: "text", text }];
+  } else {
+    const blob = await valueToBase64(await response.arrayBuffer());
+    content = blob == null ? [] : [{
+      type: "resource",
+      resource: { uri: response.url, mimeType: contentType, blob }
+    }];
   }
   return response.ok ? { content } : { content, isError: true };
 }
@@ -52382,7 +52514,7 @@ async function $do(client$, request, options) {
     options: client$._options,
     baseURL: options?.serverURL ?? client$._baseURL ?? "",
     operationID: "streamConversation",
-    oAuth2Scopes: ["conversation:write"],
+    oAuth2Scopes: ["conversation:chat"],
     resolvedSecurity: requestSecurity,
     securitySource: client$._options.security,
     retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
@@ -53202,6 +53334,9 @@ the user asks about their documents, files, knowledge base, company policies,
 or anything that could plausibly be answered by content in their PipesHub-indexed
 sources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).
 Grounds the answer in the user's actual data and returns citations.
+Answers come from a few retrieved passages, not whole documents — for
+any task needing a document's full content, use
+\`pipeshub_get_record_content\` instead.
 
 **Web search** (\`chatMode: "web_search"\`): Use when the user asks about
 current events, public information, or anything unlikely to be in the org's
@@ -53209,8 +53344,11 @@ internal knowledge base. Pass \`chatMode: "web_search"\` and this tool will
 search the public web instead.
 
 **When to pick this over other tools:**
-- "What does <document> say about X?" → \`pipeshub_chat\` (internal_search)
-- "Summarize <topic / doc>." → \`pipeshub_chat\` (internal_search)
+- "Summarize <doc>" / "key points of <doc>" / "what does <document> say
+  about X?" → NOT this tool. Use \`pipeshub_search\` →
+  \`pipeshub_get_record_content\`: answering for a specific document
+  requires its full content, and chat only sees a few retrieved
+  passages, never the whole document.
 - "What's our policy on Y?" → \`pipeshub_chat\` (internal_search)
 - "What's in the news about Z?" → \`pipeshub_chat\` (web_search)
 - "What is the latest version of <library>?" → \`pipeshub_chat\` (web_search)
@@ -53516,12 +53654,16 @@ var init_pipeshubSearch = __esm(() => {
     name: "pipeshub_search",
     description: `Vector / semantic search across the org's indexed documents.
 
-**Use this only when the user wants to LOCATE a document** — by name,
-topic, or a phrase to grep for. For "what does the document say about
-X?" or any open-ended question, use \`pipeshub_chat\` instead, which
-does the retrieval internally and grounds the answer in citations.
+**Use this when the user wants to LOCATE a document** — by name, topic,
+or a phrase to grep for — and to resolve it to a \`recordId\`. For
+open-ended questions across many documents, use \`pipeshub_chat\`
+instead, which does the retrieval internally and grounds the answer in
+citations.
 
 Typical uses:
+- Resolve a doc name / topic into a \`recordId\` for
+  \`pipeshub_get_record_content\` — step 1 of any full-document task
+  (summarize, extract, review, "what does the doc say?").
 - Resolve a filename / phrase into a \`recordId\` for
   \`pipeshub_download_record\`.
 - Show the user a ranked list of matching files when they ask "find /
@@ -53737,6 +53879,154 @@ returned base64-encoded; text content is returned inline.`,
   };
 });
 
+// src/models/getrecordcontentop.ts
+var GetRecordContentRequest$zodSchema;
+var init_getrecordcontentop = __esm(() => {
+  init_zod();
+  GetRecordContentRequest$zodSchema = object({
+    recordId: string2().describe("Record ID to fetch. Obtain it from a `pipeshub_search` result (`hits[*].recordId`) or a chat citation (`citations[*].recordId`).")
+  });
+});
+
+// src/funcs/connectorGetRecordContent.ts
+function connectorGetRecordContent(client$, request, options) {
+  return new APIPromise($do8(client$, request, options));
+}
+async function $do8(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => GetRecordContentRequest$zodSchema.parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const pathParams$ = {
+    recordId: encodeSimple("recordId", payload$.recordId, {
+      explode: false,
+      charEncoding: "percent"
+    })
+  };
+  const path$ = pathToFunc("/connectors/record/{recordId}/content")(pathParams$);
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "getRecordContent",
+    oAuth2Scopes: ["connector:read"],
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_connectorGetRecordContent = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security2();
+  init_url();
+  init_getrecordcontentop();
+  init_async();
+});
+
+// src/mcp-server/tools/pipeshubGetRecordContent.ts
+var args4, tool$pipeshubGetRecordContent;
+var init_pipeshubGetRecordContent = __esm(() => {
+  init_zod();
+  init_connectorGetRecordContent();
+  init__helpers();
+  args4 = {
+    recordId: string2().min(1).describe("Record identifier — usually a UUID for connector-sourced records or " + "a 24-character ObjectId for uploaded records. Get it from a chat " + "citation (`citations[*].recordId`) or from a `pipeshub_search` hit.")
+  };
+  tool$pipeshubGetRecordContent = {
+    name: "pipeshub_get_record_content",
+    description: `Read a record's full parsed content by \`recordId\` — the only way to
+see a document's COMPLETE text.
+
+Use it whenever the answer depends on a document's full content — any
+task where missing a part could make the answer wrong: summarize / key
+points / action items; extract or list ALL of something; check whether
+or where the doc mentions X; translate, rewrite, outline, or review the
+doc; compare named docs (fetch each); any question scoped to one named
+document. \`pipeshub_chat\` cannot do these — it only sees a few
+retrieved passages, never the whole document. Get the \`recordId\` from
+a \`pipeshub_search\` top hit or a chat citation.
+
+Judge by the user's INTENT, not their keywords: they need not say
+"summarize", "key points", or "extract". Reason about what a good
+answer requires — if it would need the whole document (e.g. "what's
+this doc about?", "walk me through the report", "anything in here
+about Y?"), that is a full-content task, so call this tool.
+
+Returns a single \`content\` string: a short metadata header (title,
+source, key fields, and a pre-generated summary) followed by the
+record's full parsed text — paragraphs, tables, and lists in reading
+order. For a record with no extractable content, \`content\` is the
+literal \`No record found\`. Use \`pipeshub_download_record\` only when
+you need the original file bytes.`,
+    scopes: ["read"],
+    annotations: {
+      title: "Get a record's full parsed content",
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
+    args: args4,
+    tool: async (client, args5, ctx) => {
+      const [result] = await connectorGetRecordContent(client, {
+        recordId: args5.recordId
+      }, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok)
+        return errorResult(result.error.message);
+      const httpErr = await httpErrorResult(result.value, "Get record content");
+      if (httpErr)
+        return httpErr;
+      const parsed = await readJson(result.value);
+      if (!parsed.ok)
+        return parsed.result;
+      return { content: [{ type: "text", text: parsed.value.content ?? "" }] };
+    }
+  };
+});
+
 // src/models/getallusersop.ts
 var GetAllUsersRequest$zodSchema;
 var init_getallusersop = __esm(() => {
@@ -53750,9 +54040,9 @@ var init_getallusersop = __esm(() => {
 
 // src/funcs/usersGetAllUsers.ts
 function usersGetAllUsers(client$, request, options) {
-  return new APIPromise($do8(client$, request, options));
+  return new APIPromise($do9(client$, request, options));
 }
-async function $do8(client$, request, options) {
+async function $do9(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetAllUsersRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -53837,9 +54127,9 @@ var init_getuserbyidop = __esm(() => {
 
 // src/funcs/usersGetUserById.ts
 function usersGetUserById(client$, request, options) {
-  return new APIPromise($do9(client$, request, options));
+  return new APIPromise($do10(client$, request, options));
 }
-async function $do9(client$, request, options) {
+async function $do10(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetUserByIdRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -53926,9 +54216,9 @@ var init_getallusergroupsop = __esm(() => {
 
 // src/funcs/userGroupsGetAllUserGroups.ts
 function userGroupsGetAllUserGroups(client$, request, options) {
-  return new APIPromise($do10(client$, request, options));
+  return new APIPromise($do11(client$, request, options));
 }
-async function $do10(client$, request, options) {
+async function $do11(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetAllUserGroupsRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -53950,7 +54240,7 @@ async function $do10(client$, request, options) {
     options: client$._options,
     baseURL: options?.serverURL ?? client$._baseURL ?? "",
     operationID: "getAllUserGroups",
-    oAuth2Scopes: [],
+    oAuth2Scopes: ["usergroup:read"],
     resolvedSecurity: requestSecurity,
     securitySource: client$._options.security,
     retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
@@ -54018,9 +54308,9 @@ var init_getuserteamsop = __esm(() => {
 
 // src/funcs/teamsGetUserTeams.ts
 function teamsGetUserTeams(client$, request, options) {
-  return new APIPromise($do11(client$, request, options));
+  return new APIPromise($do12(client$, request, options));
 }
-async function $do11(client$, request, options) {
+async function $do12(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetUserTeamsRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54098,7 +54388,7 @@ var init_teamsGetUserTeams = __esm(() => {
 });
 
 // src/mcp-server/tools/pipeshubDirectory.ts
-var args4, tool$pipeshubDirectory;
+var args5, tool$pipeshubDirectory;
 var init_pipeshubDirectory = __esm(() => {
   init_zod();
   init_usersGetAllUsers();
@@ -54106,7 +54396,7 @@ var init_pipeshubDirectory = __esm(() => {
   init_userGroupsGetAllUserGroups();
   init_teamsGetUserTeams();
   init__helpers();
-  args4 = {
+  args5 = {
     action: _enum([
       "whoami",
       "list_users",
@@ -54144,10 +54434,10 @@ Output shape varies by action; see each action's docs above.`,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args4,
-    tool: async (client, args5, ctx) => {
+    args: args5,
+    tool: async (client, args6, ctx) => {
       const fetchOptions = { signal: ctx.signal };
-      switch (args5.action) {
+      switch (args6.action) {
         case "whoami": {
           const claims = await decodeBearer(client);
           if (!claims) {
@@ -54164,9 +54454,9 @@ Output shape varies by action; see each action's docs above.`,
         }
         case "list_users": {
           const [result] = await usersGetAllUsers(client, {
-            page: args5.page,
-            limit: args5.limit,
-            search: args5.search
+            page: args6.page,
+            limit: args6.limit,
+            search: args6.search
           }, { fetchOptions }).$inspect();
           if (!result.ok)
             return errorResult(result.error.message);
@@ -54176,11 +54466,11 @@ Output shape varies by action; see each action's docs above.`,
           return jsonResult(parsed.value);
         }
         case "get_user": {
-          if (!args5.userId) {
+          if (!args6.userId) {
             return errorResult("`userId` is required when `action` is `get_user`. " + "Use `whoami` to find your own id, or `list_users` " + "to look up by name / email.");
           }
           const [result] = await usersGetUserById(client, {
-            id: args5.userId
+            id: args6.userId
           }, { fetchOptions }).$inspect();
           if (!result.ok)
             return errorResult(result.error.message);
@@ -54191,9 +54481,9 @@ Output shape varies by action; see each action's docs above.`,
         }
         case "list_groups": {
           const [result] = await userGroupsGetAllUserGroups(client, {
-            page: args5.page,
-            limit: args5.limit,
-            search: args5.search
+            page: args6.page,
+            limit: args6.limit,
+            search: args6.search
           }, { fetchOptions }).$inspect();
           if (!result.ok)
             return errorResult(result.error.message);
@@ -54204,9 +54494,9 @@ Output shape varies by action; see each action's docs above.`,
         }
         case "list_my_teams": {
           const [result] = await teamsGetUserTeams(client, {
-            page: args5.page,
-            limit: args5.limit,
-            search: args5.search
+            page: args6.page,
+            limit: args6.limit,
+            search: args6.search
           }, { fetchOptions }).$inspect();
           if (!result.ok)
             return errorResult(result.error.message);
@@ -54250,9 +54540,9 @@ var init_getknowledgehubrootnodesop = __esm(() => {
 
 // src/funcs/knowledgeHubGetKnowledgeHubRootNodes.ts
 function knowledgeHubGetKnowledgeHubRootNodes(client$, request, options) {
-  return new APIPromise($do12(client$, request, options));
+  return new APIPromise($do13(client$, request, options));
 }
-async function $do12(client$, request, options) {
+async function $do13(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetKnowledgeHubRootNodesRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54368,9 +54658,9 @@ var init_getavailablemodelsbytypeop = __esm(() => {
 
 // src/funcs/aiModelsProvidersGetAvailableModelsByType.ts
 function aiModelsProvidersGetAvailableModelsByType(client$, request, options) {
-  return new APIPromise($do13(client$, request, options));
+  return new APIPromise($do14(client$, request, options));
 }
-async function $do13(client$, request, options) {
+async function $do14(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetAvailableModelsByTypeRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54445,13 +54735,13 @@ var init_aiModelsProvidersGetAvailableModelsByType = __esm(() => {
 });
 
 // src/mcp-server/tools/pipeshubSources.ts
-var args5, tool$pipeshubSources;
+var args6, tool$pipeshubSources;
 var init_pipeshubSources = __esm(() => {
   init_zod();
   init_knowledgeHubGetKnowledgeHubRootNodes();
   init_aiModelsProvidersGetAvailableModelsByType();
   init__helpers();
-  args5 = {
+  args6 = {
     include: array(_enum(["sources", "llmModels", "embeddingModels"])).optional().describe('Which sections to fetch. Default: `["sources", "llmModels"]`. ' + "Add `embeddingModels` if the user is configuring re-embedding.")
   };
   tool$pipeshubSources = {
@@ -54482,10 +54772,10 @@ are returned by default; pass \`include\` to override.`,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args5,
-    tool: async (client, args6, ctx) => {
+    args: args6,
+    tool: async (client, args7, ctx) => {
       const fetchOptions = { signal: ctx.signal };
-      const include = args6.include ?? ["sources", "llmModels"];
+      const include = args7.include ?? ["sources", "llmModels"];
       const want = (s) => include.includes(s);
       const result = {};
       if (want("sources")) {
@@ -54535,11 +54825,11 @@ are returned by default; pass \`include\` to override.`,
 });
 
 // src/mcp-server/tools/pipeshubAgents.ts
-var args6, tool$pipeshubAgents;
+var args7, tool$pipeshubAgents;
 var init_pipeshubAgents = __esm(() => {
   init_zod();
   init__helpers();
-  args6 = {
+  args7 = {
     search: string2().optional().describe("Optional case-insensitive substring match across agent name, " + "description, and tags. Omit to return every agent.")
   };
   tool$pipeshubAgents = {
@@ -54578,10 +54868,10 @@ specific agent is needed, use \`pipeshub_chat\` WITHOUT \`agentId\` and pick a
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args6,
-    tool: async (client, args7, ctx) => {
+    args: args7,
+    tool: async (client, args8, ctx) => {
       const all = await listAllAgents(client, {
-        search: args7.search,
+        search: args8.search,
         signal: ctx.signal
       });
       if (!all.ok)
@@ -54596,25 +54886,25 @@ specific agent is needed, use \`pipeshub_chat\` WITHOUT \`agentId\` and pick a
 });
 
 // src/mcp-server/prompts/pipeshubAssistant.ts
-var args7, prompt$pipeshubAssistant;
+var args8, prompt$pipeshubAssistant;
 var init_pipeshubAssistant = __esm(() => {
   init_zod();
-  args7 = {
+  args8 = {
     query: string2().optional().describe("Optional. The user's request to route. Provide it to have the guidance " + "applied to a concrete request; omit it to just load the routing " + "guidance as a seed system prompt at the start of a session.")
   };
   prompt$pipeshubAssistant = {
     name: "pipeshub-assistant",
     description: "Load PipesHub tool-routing guidance so the assistant picks the correct " + "tool (pipeshub_chat / search / agents / directory) and lists agents " + "with pipeshub_agents when unsure which route fits the query.",
     scopes: ["read"],
-    args: args7,
-    prompt: (_client, args8, _extra) => {
-      const text = args8.query ? `${PIPESHUB_INSTRUCTIONS}
+    args: args8,
+    prompt: (_client, args9, _extra) => {
+      const text = args9.query ? `${PIPESHUB_INSTRUCTIONS}
 
 ---
 
 Follow the routing rules above to ` + `handle this request, picking the right tool (and listing agents via ` + `\`pipeshub_agents\` if unsure which route fits):
 
-${args8.query}` : PIPESHUB_INSTRUCTIONS;
+${args9.query}` : PIPESHUB_INSTRUCTIONS;
       return {
         messages: [
           {
@@ -54635,17 +54925,21 @@ function createMCPServer(deps) {
   }, {
     instructions: PIPESHUB_INSTRUCTIONS
   });
-  const getClient = deps.getSDK || (() => new PipeshubCore({
+  const resolveClient = deps.getSDK || (() => new PipeshubCore({
     security: deps.security,
     serverURL: deps.serverURL,
     serverIdx: deps.serverIdx,
     instance_url: deps.instance_url,
     debugLogger: deps.logger.level === "debug" ? {
-      log: (...args8) => console.log(...args8),
-      group: (...args8) => console.group(...args8),
-      groupEnd: (...args8) => console.groupEnd(...args8)
+      log: (...args9) => console.log(...args9),
+      group: (...args9) => console.group(...args9),
+      groupEnd: (...args9) => console.groupEnd(...args9)
     } : undefined
   }));
+  const getClient = () => {
+    bindNewRequestId();
+    return resolveClient();
+  };
   const scopes = new Set(deps.scopes);
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
   const [tool, tools, toolMap] = createRegisterTool(deps.logger, server, getClient, scopes, allowedTools, deps.dynamic);
@@ -54657,6 +54951,7 @@ function createMCPServer(deps) {
   tool(tool$pipeshubChat);
   tool(tool$pipeshubSearch);
   tool(tool$pipeshubDownloadRecord);
+  tool(tool$pipeshubGetRecordContent);
   tool(tool$pipeshubDirectory);
   tool(tool$pipeshubAgents);
   prompt(prompt$pipeshubAssistant);
@@ -54668,11 +54963,13 @@ function createMCPServer(deps) {
 var init_server2 = __esm(() => {
   init_mcp();
   init_core3();
+  init_request_context();
   init_resources();
   init_tools();
   init_pipeshubChat();
   init_pipeshubSearch();
   init_pipeshubDownloadRecord();
+  init_pipeshubGetRecordContent();
   init_pipeshubDirectory();
   init_pipeshubSources();
   init_pipeshubAgents();
@@ -54696,6 +54993,9 @@ the user asks about their documents, files, knowledge base, company policies,
 or anything that could plausibly be answered by content in their PipesHub-indexed
 sources (Drive, Box, Confluence, Slack, Gmail, Jira, the org's KB, ...).
 Grounds the answer in the user's actual data and returns citations.
+Answers come from a few retrieved passages, not whole documents — for
+any task needing a document's full content, use
+\`pipeshub_get_record_content\` instead.
 
 **Web search** (\`chatMode: "web_search"\`): Use when the user asks about
 current events, public information, or anything unlikely to be in the org's
@@ -54703,8 +55003,11 @@ internal knowledge base. Pass \`chatMode: "web_search"\` and this tool will
 search the public web instead.
 
 **When to pick this over other tools:**
-- "What does <document> say about X?" → \`pipeshub_chat\` (internal_search)
-- "Summarize <topic / doc>." → \`pipeshub_chat\` (internal_search)
+- "Summarize <doc>" / "key points of <doc>" / "what does <document> say
+  about X?" → NOT this tool. Use \`pipeshub_search\` →
+  \`pipeshub_get_record_content\`: answering for a specific document
+  requires its full content, and chat only sees a few retrieved
+  passages, never the whole document.
 - "What's our policy on Y?" → \`pipeshub_chat\` (internal_search)
 - "What's in the news about Z?" → \`pipeshub_chat\` (web_search)
 - "What is the latest version of <library>?" → \`pipeshub_chat\` (web_search)
@@ -54731,12 +55034,16 @@ cited document, take \`citations[*].recordId\` and call
       name: "pipeshub_search",
       description: `Vector / semantic search across the org's indexed documents.
 
-**Use this only when the user wants to LOCATE a document** — by name,
-topic, or a phrase to grep for. For "what does the document say about
-X?" or any open-ended question, use \`pipeshub_chat\` instead, which
-does the retrieval internally and grounds the answer in citations.
+**Use this when the user wants to LOCATE a document** — by name, topic,
+or a phrase to grep for — and to resolve it to a \`recordId\`. For
+open-ended questions across many documents, use \`pipeshub_chat\`
+instead, which does the retrieval internally and grounds the answer in
+citations.
 
 Typical uses:
+- Resolve a doc name / topic into a \`recordId\` for
+  \`pipeshub_get_record_content\` — step 1 of any full-document task
+  (summarize, extract, review, "what does the doc say?").
 - Resolve a filename / phrase into a \`recordId\` for
   \`pipeshub_download_record\`.
 - Show the user a ranked list of matching files when they ask "find /
@@ -54751,6 +55058,33 @@ Highest \`score\` first; multiple hits may share the same \`recordId\`
       name: "pipeshub_download_record",
       description: "Stream the binary content of a single record from PipesHub.\n\nTypical sources for the `recordId`:\n- A chat citation:\n  `pipeshub_chat` response → `citations[*].recordId`.\n- A search result:\n  `pipeshub_search` response → `hits[*].recordId` /\n  `uniqueRecords[*].recordId`.\n\nResponse `Content-Type` is forwarded from the upstream service —\n`application/pdf`, `application/octet-stream`, etc. Binary content is\nreturned base64-encoded; text content is returned inline."
     },
+    {
+      name: "pipeshub_get_record_content",
+      description: `Read a record's full parsed content by \`recordId\` — the only way to
+see a document's COMPLETE text.
+
+Use it whenever the answer depends on a document's full content — any
+task where missing a part could make the answer wrong: summarize / key
+points / action items; extract or list ALL of something; check whether
+or where the doc mentions X; translate, rewrite, outline, or review the
+doc; compare named docs (fetch each); any question scoped to one named
+document. \`pipeshub_chat\` cannot do these — it only sees a few
+retrieved passages, never the whole document. Get the \`recordId\` from
+a \`pipeshub_search\` top hit or a chat citation.
+
+Judge by the user's INTENT, not their keywords: they need not say
+"summarize", "key points", or "extract". Reason about what a good
+answer requires — if it would need the whole document (e.g. "what's
+this doc about?", "walk me through the report", "anything in here
+about Y?"), that is a full-content task, so call this tool.
+
+Returns a single \`content\` string: a short metadata header (title,
+source, key fields, and a pre-generated summary) followed by the
+record's full parsed text — paragraphs, tables, and lists in reading
+order. For a record with no extractable content, \`content\` is the
+literal \`No record found\`. Use \`pipeshub_download_record\` only when
+you need the original file bytes.`
+    },
     {
       name: "pipeshub_directory",
       description: "Look up people, groups, and teams in PipesHub. One tool with five\nactions — pick the right `action`:\n\n- `whoami` — who is the caller?  Use this whenever you need the\n  authenticated user's own id, email, or full name (e.g. before\n  `get_user` on themselves).\n- `list_users` — search / page through org users.\n- `get_user` — full `User` document for one user (requires `userId`).\n- `list_groups` — list user groups with `userCount`.\n- `list_my_teams` — teams the caller belongs to, with capability flags\n  (`canEdit` / `canDelete` / `canManageMembers`).\n\nOutput shape varies by action; see each action's docs above."
@@ -58386,5 +58720,5 @@ export {
   app
 };
 
-//# debugId=E589470B4E3C258364756E2164756E21
+//# debugId=59975E6F38134B6C64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map