@pipeshub-ai/mcp 2.4.0 → 2.4.2

package/bin/mcp-server.js

@@ -50441,16 +50441,18 @@ the user can verify.
 - \`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_download_record\` — when the user wants the file as stored
+  (download, attach, open). Never to read or summarize — that is
+  \`pipeshub_get_record_content\` \`mode:"content"\`, which returns
+  parsed text with a metadata header. Get the \`recordId\` from a chat
+  citation or from \`pipeshub_search\`. \`convertTo\` is only
+  \`application/pdf\`.
 - \`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.
+  Not for documents or files — that is \`pipeshub_search\`.
 - \`pipeshub_sources\` — call once at the start of a session to discover
   which connectors / KB / models are available, then cache the result.
 - \`pipeshub_agents\` — list the org's configured **agents** (specialized
@@ -54205,22 +54207,22 @@ var init_pipeshubDownloadRecord = __esm(() => {
   init__helpers();
   args3 = {
     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."),
-    convertTo: string2().optional().describe("Optional server-side format conversion target (e.g. `pdf`). When " + "omitted, the original file bytes are returned.")
+    convertTo: string2().optional().describe("The only conversion target connectors honour is `application/pdf` " + "(the MIME type, not `pdf`). A bare `pdf` is ignored and the " + "original file is returned with no error. Omit for the file as " + "stored. Does not parse the document — use " + '`pipeshub_get_record_content` `mode:"content"` for that.')
   };
   tool$pipeshubDownloadRecord = {
     name: "pipeshub_download_record",
-    description: `Stream the binary content of a single record from PipesHub.
-
-Typical sources for the \`recordId\`:
-- A chat citation:
-  \`pipeshub_chat\` response → \`citations[*].recordId\`.
-- A search result:
-  \`pipeshub_search\` response → \`hits[*].recordId\` /
-  \`uniqueRecords[*].recordId\`.
-
-Response \`Content-Type\` is forwarded from the upstream service —
-\`application/pdf\`, \`application/octet-stream\`, etc. Binary content is
-returned base64-encoded; text content is returned inline.`,
+    description: `Download the file as stored for one record — not PipesHub's parsed
+content, metadata header, or summary.
+
+Use this when the user wants the file itself (download, attach, open).
+Get \`recordId\` from a chat citation or a \`pipeshub_search\` hit.
+
+Do not use this to read, summarize, or answer "what does this doc
+say?" regardless of format. That is \`pipeshub_get_record_content\`
+\`mode:"content"\`. Text formats come back inline; images, audio, and
+binary as base64.
+
+\`convertTo\` accepts only \`application/pdf\`; anything else is ignored.`,
     scopes: ["read"],
     annotations: {
       title: "Download a document by record id",
@@ -55052,14 +55054,27 @@ var init_teamsGetUserTeams = __esm(() => {
 });
 
 // src/mcp-server/tools/pipeshubDirectory.ts
-var args5, tool$pipeshubDirectory;
+function defaultLimit(schema) {
+  const limit = schema.parse({}).limit;
+  if (typeof limit !== "number") {
+    throw new Error("list request schema is missing a numeric limit default");
+  }
+  return limit;
+}
+var listUsersLimit, listGroupsLimit, listTeamsLimit, args5, tool$pipeshubDirectory;
 var init_pipeshubDirectory = __esm(() => {
   init_zod();
   init_usersGetAllUsers();
   init_usersGetUserById();
   init_userGroupsGetAllUserGroups();
   init_teamsGetUserTeams();
+  init_getallusersop();
+  init_getallusergroupsop();
+  init_getuserteamsop();
   init__helpers();
+  listUsersLimit = defaultLimit(GetAllUsersRequest$zodSchema);
+  listGroupsLimit = defaultLimit(GetAllUserGroupsRequest$zodSchema);
+  listTeamsLimit = defaultLimit(GetUserTeamsRequest$zodSchema);
   args5 = {
     action: _enum([
       "whoami",
@@ -55069,28 +55084,29 @@ var init_pipeshubDirectory = __esm(() => {
       "list_my_teams"
     ]).describe(`What to do:
 ` + "- `whoami` — return the authenticated user's identity, confirmed " + `against the server. No other args needed.
-` + "- `list_users` — paginated list of org users. Optional `page`, " + "`limit`, `search` (substring match against name or email).\n" + "- `get_user` — full profile for one user. Required `userId`. " + "Use `whoami` to find your own id first if needed.\n" + "- `list_groups` — paginated list of user groups (with `userCount`).\n" + "- `list_my_teams` — teams the authenticated user belongs to, with " + "capability flags."),
-    userId: string2().optional().describe("Required when `action` is `get_user`. 24-character ObjectId."),
-    page: number2().int().min(1).optional().describe("Pagination — 1-based page number. Used by list_* actions."),
-    limit: number2().int().min(1).max(100).optional().describe("Pagination — items per page. Used by list_* actions."),
-    search: string2().optional().describe("Substring match against name / email. Used by list_users.")
+` + "- `list_users` — paginated list of org users. Optional `page`, " + "`limit`, `search` (substring match against name or email).\n" + "- `get_user` — full profile for one user. Required `userId`. " + "Use `whoami` to find your own id first if needed.\n" + "- `list_groups` — paginated list of user groups (with `userCount`). " + "Optional `search` matches group name.\n" + "- `list_my_teams` — teams the authenticated user belongs to, with " + "capability flags. Optional `search` matches team name."),
+    userId: string2().optional().describe("Required when `action` is `get_user`. 24-character ObjectId. " + "Take it from `whoami` (yourself) or from a `list_users` hit."),
+    page: number2().int().min(1).optional().describe("1-based page for list_* actions. Omit for page 1."),
+    limit: number2().int().min(1).max(100).optional().describe("Items per page for list_* (1–100). Omit for the action default: " + `${listUsersLimit} users, ${listGroupsLimit} groups, ` + `${listTeamsLimit} teams.`),
+    search: string2().optional().describe("Substring match on list_users (name or email), list_groups (name), " + "and list_my_teams (name). An empty list means no match, not an error.")
   };
   tool$pipeshubDirectory = {
     name: "pipeshub_directory",
-    description: `Look up people, groups, and teams in PipesHub. One tool with five
-actions — pick the right \`action\`:
-
-- \`whoami\` — who is the caller?  Use this whenever you need the
-  authenticated user's own id, email, or full name (e.g. before
-  \`get_user\` on themselves). Errors if the credential is expired
-  or revoked.
-- \`list_users\` — search / page through org users.
-- \`get_user\` — full \`User\` document for one user (requires \`userId\`).
-- \`list_groups\` — list user groups with \`userCount\`.
-- \`list_my_teams\` — teams the caller belongs to, with capability flags
-  (\`canEdit\` / \`canDelete\` / \`canManageMembers\`).
-
-Output shape varies by action; see each action's docs above.`,
+    description: `Look up people, groups, and teams in PipesHub. Five actions — pick
+\`action\`. Not for documents or files: that is \`pipeshub_search\`.
+
+- \`whoami\` — the caller's id, email, full name. Use before \`get_user\`
+  on yourself. Errors if the credential is expired or revoked.
+- \`list_users\` — page org users; \`search\` matches name or email.
+- \`get_user\` — full \`User\` for one \`userId\`.
+- \`list_groups\` — org groups with \`userCount\`; \`search\` matches name.
+- \`list_my_teams\` — teams the caller is on, with \`canEdit\` /
+  \`canDelete\` / \`canManageMembers\`; \`search\` matches name.
+
+Omit \`page\`/\`limit\` for the first page (\`page\` 1). No match is an
+empty \`users\`/\`groups\`/\`teams\` array, not an error.
+\`pagination.hasNextPage\` (teams: \`hasNext\`) says whether to request
+the next page.`,
     scopes: ["read"],
     annotations: {
       title: "PipesHub directory (users / groups / teams / whoami)",
@@ -55636,7 +55652,7 @@ One record can appear in several hits. Link a record by its \`webUrl\`.`
     },
     {
       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."
+      description: 'Download the file as stored for one record — not PipesHub\'s parsed\ncontent, metadata header, or summary.\n\nUse this when the user wants the file itself (download, attach, open).\nGet `recordId` from a chat citation or a `pipeshub_search` hit.\n\nDo not use this to read, summarize, or answer "what does this doc\nsay?" regardless of format. That is `pipeshub_get_record_content`\n`mode:"content"`. Text formats come back inline; images, audio, and\nbinary as base64.\n\n`convertTo` accepts only `application/pdf`; anything else is ignored.'
     },
     {
       name: "pipeshub_get_record_content",
@@ -55717,7 +55733,7 @@ it using the \`Web URL\` from its metadata header (when present).`
     },
     {
       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). Errors if the credential is expired\n  or revoked.\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."
+      description: "Look up people, groups, and teams in PipesHub. Five actions — pick\n`action`. Not for documents or files: that is `pipeshub_search`.\n\n- `whoami` — the caller's id, email, full name. Use before `get_user`\n  on yourself. Errors if the credential is expired or revoked.\n- `list_users` — page org users; `search` matches name or email.\n- `get_user` — full `User` for one `userId`.\n- `list_groups` — org groups with `userCount`; `search` matches name.\n- `list_my_teams` — teams the caller is on, with `canEdit` /\n  `canDelete` / `canManageMembers`; `search` matches name.\n\nOmit `page`/`limit` for the first page (`page` 1). No match is an\nempty `users`/`groups`/`teams` array, not an error.\n`pagination.hasNextPage` (teams: `hasNext`) says whether to request\nthe next page."
     },
     {
       name: "pipeshub_agents",
@@ -59350,5 +59366,5 @@ export {
   app
 };
 
-//# debugId=DFA46931359137F464756E2164756E21
+//# debugId=8B63F04DA907BD3C64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map