@pipeshub-ai/mcp 2.3.3 → 2.4.1

package/bin/mcp-server.js

@@ -50441,10 +50441,12 @@ 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
@@ -50482,8 +50484,9 @@ external ID → \`mode:"lookup"\` FIRST. It returns that record's metadata (for
 ticket: status, assignee, priority, dates) plus its \`recordId\`, which often
 answers the question outright. Never guess a \`recordId\`.
 
-Pass a source's id from \`pipeshub_sources\` as \`apps: ["<id>"]\` to search or
-chat, and as \`nodeId\` to navigate. Navigate and lookup end in a \`Next:\` line
+For search, pass a connector id from \`pipeshub_sources\` as \`apps: ["<id>"]\`
+and a collection id (\`kind: "knowledgeBase"\`) as \`kb: ["<id>"]\`. Any source
+id works as \`nodeId\` to navigate. Navigate and lookup end in a \`Next:\` line
 naming the exact follow-up call — follow it.
 
 ## Agents
@@ -53097,6 +53100,125 @@ var init_agentsListAgents = __esm(() => {
   init_async();
 });
 
+// src/models/getknowledgehubrootnodesop.ts
+var SortOrder$zodSchema, GetKnowledgeHubRootNodesRequest$zodSchema;
+var init_getknowledgehubrootnodesop = __esm(() => {
+  init_zod();
+  SortOrder$zodSchema = _enum([
+    "asc",
+    "desc"
+  ]).describe("Sort order.");
+  GetKnowledgeHubRootNodesRequest$zodSchema = object({
+    connectorIds: string2().describe("Comma-separated connector instance ids to scope to.").optional(),
+    createdAt: string2().describe("Created date range as `gte:<ms>,lte:<ms>`.").optional(),
+    flattened: boolean2().default(false).describe("Return flattened view with all nested children."),
+    include: string2().describe("Comma-separated includes — any of `breadcrumbs`, `counts`,\n`availableFilters`, `permissions`.\n").optional(),
+    indexingStatus: string2().describe("Comma-separated indexing statuses.").optional(),
+    limit: int().default(50).describe("Items per page."),
+    nodeTypes: string2().describe("Comma-separated node types (`app`, `recordGroup`, `folder`, `record`).").optional(),
+    only_containers: boolean2().default(false).describe("Only return nodes with children (for sidebar UIs)."),
+    origins: string2().describe("Comma-separated origins (`COLLECTION`, `CONNECTOR`).").optional(),
+    page: int().default(1).describe("Page number (1-indexed)."),
+    q: string2().describe("Full-text search query against node names.").optional(),
+    recordTypes: string2().describe("Comma-separated record types.").optional(),
+    size: string2().describe("Size range as `gte:<bytes>,lte:<bytes>`.").optional(),
+    sortBy: string2().default("updatedAt").describe("Sort field — one of `name`, `createdAt`, `updatedAt`, `size`, `type`."),
+    sortOrder: SortOrder$zodSchema.default("desc"),
+    updatedAt: string2().describe("Updated date range as `gte:<ms>,lte:<ms>`.").optional()
+  });
+});
+
+// src/funcs/knowledgeHubGetKnowledgeHubRootNodes.ts
+function knowledgeHubGetKnowledgeHubRootNodes(client$, request, options) {
+  return new APIPromise($do6(client$, request, options));
+}
+async function $do6(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => GetKnowledgeHubRootNodesRequest$zodSchema.optional().parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const path$ = pathToFunc("/knowledgeBase/knowledge-hub/nodes")();
+  const query$ = encodeFormQuery({
+    connectorIds: payload$?.connectorIds,
+    createdAt: payload$?.createdAt,
+    flattened: payload$?.flattened,
+    include: payload$?.include,
+    indexingStatus: payload$?.indexingStatus,
+    limit: payload$?.limit,
+    nodeTypes: payload$?.nodeTypes,
+    only_containers: payload$?.only_containers,
+    origins: payload$?.origins,
+    page: payload$?.page,
+    q: payload$?.q,
+    recordTypes: payload$?.recordTypes,
+    size: payload$?.size,
+    sortBy: payload$?.sortBy,
+    sortOrder: payload$?.sortOrder,
+    updatedAt: payload$?.updatedAt
+  });
+  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: "getKnowledgeHubRootNodes",
+    oAuth2Scopes: ["kb: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$,
+    query: query$,
+    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_knowledgeHubGetKnowledgeHubRootNodes = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security2();
+  init_url();
+  init_getknowledgehubrootnodesop();
+  init_async();
+});
+
 // src/mcp-server/tools/_helpers.ts
 async function readJson(response, context = "PipesHub request") {
   const httpErr = await httpErrorResult(response, context);
@@ -53409,9 +53531,123 @@ function trimSearchHit(hit) {
     pageNum: md.pageNum
   };
 }
+function toSource(n) {
+  return {
+    id: n?.id,
+    name: n?.name,
+    kind: n?.connector === "KB" ? "knowledgeBase" : "connector",
+    connector: n?.connector,
+    hasChildren: n?.hasChildren
+  };
+}
+async function listAllSources(client, opts = {}) {
+  const PAGE_SIZE = 200;
+  const maxPages = opts.maxPages ?? 5;
+  const reqOptions = opts.signal ? { fetchOptions: { signal: opts.signal } } : {};
+  const all = [];
+  for (let page = 1;page <= maxPages; page++) {
+    const [r] = await knowledgeHubGetKnowledgeHubRootNodes(client, {
+      page,
+      limit: PAGE_SIZE
+    }, reqOptions).$inspect();
+    if (!r.ok) {
+      return {
+        ok: false,
+        result: errorResult(`sources: ${r.error.message}`),
+        reason: r.error.message
+      };
+    }
+    const status = r.value.status;
+    const httpOk = r.value.ok;
+    const parsed = await readJson(r.value, "Knowledge base listing");
+    if (!parsed.ok) {
+      return {
+        ok: false,
+        result: parsed.result,
+        reason: httpOk ? "unreadable response" : `HTTP ${status}`
+      };
+    }
+    const items = parsed.value.items ?? [];
+    all.push(...items.map(toSource));
+    const hasNext = parsed.value.pagination?.hasNext ?? items.length >= PAGE_SIZE;
+    if (!hasNext || items.length === 0) {
+      return { ok: true, sources: all, truncated: false };
+    }
+  }
+  return { ok: true, sources: all, truncated: true };
+}
+function routeSourceScope(apps, kb, kinds) {
+  const appIds = dedupe(apps ?? []);
+  const kbIds = dedupe(kb ?? []);
+  const movedToKb = appIds.filter((id) => kinds.get(id) === "knowledgeBase");
+  const movedToApps = kbIds.filter((id) => kinds.get(id) === "connector");
+  return {
+    apps: dedupe([
+      ...appIds.filter((id) => kinds.get(id) !== "knowledgeBase"),
+      ...movedToApps
+    ]),
+    kb: dedupe([
+      ...movedToKb,
+      ...kbIds.filter((id) => kinds.get(id) !== "connector")
+    ]),
+    movedToKb,
+    movedToApps
+  };
+}
+function searchFilters(scope) {
+  if (scope.apps.length === 0 && scope.kb.length === 0)
+    return;
+  return { apps: scope.apps, kb: scope.kb };
+}
+function sourceScopeNotes(input) {
+  const notes = [];
+  if (input.movedToKb.length > 0) {
+    notes.push(`Moved ${input.movedToKb.length} collection id(s) from apps to kb: ` + `${input.movedToKb.join(", ")}. Collection ids belong in kb.`);
+  }
+  if (input.movedToApps.length > 0) {
+    notes.push(`Moved ${input.movedToApps.length} connector id(s) from kb to apps: ` + `${input.movedToApps.join(", ")}. Connector ids belong in apps.`);
+  }
+  if (input.lookupError) {
+    notes.push("Could not check the ids against the source list " + `(${input.lookupError}); sent them unchanged. If this finds nothing, ` + "check that collection ids are in kb and connector ids in apps.");
+  }
+  if (input.unlisted && input.unlisted.length > 0) {
+    notes.push(`Source list was incomplete; ${input.unlisted.join(", ")} were not ` + "found and were sent unchanged.");
+  }
+  return notes;
+}
+async function resolveSourceScope(client, apps, kb, opts = {}) {
+  const unchecked = routeSourceScope(apps, kb, new Map);
+  if (unchecked.apps.length === 0 && unchecked.kb.length === 0) {
+    return { scope: unchecked, notes: [] };
+  }
+  const listed = await listAllSources(client, opts);
+  if (!listed.ok) {
+    return {
+      scope: unchecked,
+      notes: sourceScopeNotes({
+        movedToKb: [],
+        movedToApps: [],
+        lookupError: listed.reason
+      })
+    };
+  }
+  const kinds = new Map(listed.sources.map((s) => [s.id, s.kind]));
+  const scope = routeSourceScope(apps, kb, kinds);
+  const unlisted = listed.truncated ? [...scope.apps, ...scope.kb].filter((id) => !kinds.has(id)) : [];
+  return {
+    scope,
+    notes: sourceScopeNotes({
+      movedToKb: scope.movedToKb,
+      movedToApps: scope.movedToApps,
+      unlisted
+    })
+  };
+}
+var dedupe = (ids) => [...new Set(ids)];
 var init__helpers = __esm(() => {
   init_zod();
   init_agentsListAgents();
+  init_knowledgeHubGetKnowledgeHubRootNodes();
   init_agentops();
 });
 
@@ -53426,13 +53662,13 @@ var init_pipeshubChat = __esm(() => {
   init__agui();
   init__helpers();
   FiltersShape = object({
-    apps: array(string2()).optional().describe("Source-scoping ids from `pipeshub_sources` — connector instance and / " + "or knowledge base ids, mixed freely. The legacy org-wide " + "`knowledgeBase_<orgId>` id is still accepted on deployments that " + "predate per-KB sources. Empty / omitted means no app-side " + "restriction."),
-    kb: array(string2()).optional().describe("Legacy / unused. Leave empty.")
+    apps: array(string2()).optional().describe("Connector ids to use. Get them from `pipeshub_sources`, where `kind` is " + '"connector". Collection ids go in `kb`, not here.'),
+    kb: array(string2()).optional().describe("Collection (knowledge base) ids to use. Get them from " + '`pipeshub_sources`, where `kind` is "knowledgeBase".')
   }).optional();
   args = {
     query: string2().min(1).describe("The user's question or message for this turn."),
     conversationId: string2().optional().describe("Existing conversation id to continue. Omit on the FIRST turn; on every " + "subsequent turn pass the `conversationId` returned by the previous " + "call. Server-side message history is preserved — do NOT replay " + "prior messages."),
-    filters: FiltersShape.describe("Source scoping for retrieval. Pass `apps` ids from `pipeshub_sources`. " + "Only meaningful on the FIRST turn (when starting a new conversation)."),
+    filters: FiltersShape.describe("Which sources the answer may use. Leave out to use all sources. Only " + "works on the FIRST turn; later turns keep the first turn's sources."),
     modelKey: string2().optional().describe("Model id to use (from `pipeshub_sources` `llmModels[*].modelKey`). " + "Defaults to the org's default LLM."),
     modelName: string2().optional(),
     modelFriendlyName: string2().optional(),
@@ -53510,6 +53746,15 @@ cited document, take \`citations[*].recordId\` and call
       const fetchOptions = { signal: ctx.signal };
       const plainChatMode = args2.chatMode === "web_search" ? "web_search" : "internal_search";
       let response;
+      let filters = args2.filters;
+      let notes = [];
+      if (!args2.conversationId && filters) {
+        const resolved = await resolveSourceScope(client, filters.apps, filters.kb, { signal: ctx.signal });
+        notes = resolved.notes;
+        if (resolved.scope.apps.length > 0 || resolved.scope.kb.length > 0) {
+          filters = { apps: resolved.scope.apps, kb: resolved.scope.kb };
+        }
+      }
       if (args2.agentId) {
         const agentChatMode = "quick";
         if (args2.conversationId) {
@@ -53532,7 +53777,7 @@ cited document, take \`citations[*].recordId\` and call
             agentKey: args2.agentId,
             body: {
               query: args2.query,
-              filters: args2.filters,
+              filters,
               modelKey: args2.modelKey,
               modelName: args2.modelName,
               modelFriendlyName: args2.modelFriendlyName,
@@ -53560,7 +53805,7 @@ cited document, take \`citations[*].recordId\` and call
       } else {
         const [result] = await conversationsStreamConversation(client, {
           query: args2.query,
-          filters: args2.filters,
+          filters,
           modelKey: args2.modelKey,
           modelName: args2.modelName,
           modelFriendlyName: args2.modelFriendlyName,
@@ -53587,7 +53832,8 @@ cited document, take \`citations[*].recordId\` and call
       if (state.conversation) {
         return jsonResult({
           ...trimConversation(state.conversation),
-          recordsUsed: state.recordsUsed
+          recordsUsed: state.recordsUsed,
+          ...notes.length > 0 ? { notes } : {}
         });
       }
       const salvaged = salvagedText(state);
@@ -53602,7 +53848,8 @@ cited document, take \`citations[*].recordId\` and call
           followUpQuestions: [],
           messageCount: 0,
           recordsUsed: state.recordsUsed,
-          warning: "Stream ended without a terminal RUN_FINISHED; answer is the " + "accumulated TEXT_MESSAGE_CONTENT and citations are unavailable."
+          warning: "Stream ended without a terminal RUN_FINISHED; answer is the " + "accumulated TEXT_MESSAGE_CONTENT and citations are unavailable.",
+          ...notes.length > 0 ? { notes } : {}
         });
       }
       return errorResult("Stream ended without any usable frames.");
@@ -53670,9 +53917,9 @@ knowledge base, department, module, or record type. See
 
 // src/funcs/semanticSearchSearch.ts
 function semanticSearchSearch(client$, request, options) {
-  return new APIPromise($do6(client$, request, options));
+  return new APIPromise($do7(client$, request, options));
 }
-async function $do6(client$, request, options) {
+async function $do7(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => SemanticSearchRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -53742,15 +53989,16 @@ var init_semanticSearchSearch = __esm(() => {
 });
 
 // src/mcp-server/tools/pipeshubSearch.ts
-var args2, tool$pipeshubSearch;
+var DEFAULT_LIMIT = 10, args2, tool$pipeshubSearch;
 var init_pipeshubSearch = __esm(() => {
   init_zod();
   init_semanticSearchSearch();
   init__helpers();
   args2 = {
     query: string2().min(1).describe("Natural language query. Vector search across the org's indexed records."),
-    limit: number2().int().min(1).max(100).optional().describe("Max number of result chunks. Default 10. Use a small value (5–10) " + "when the goal is to resolve a filename / topic into a recordId."),
-    apps: array(string2()).optional().describe("Source-scoping ids — connector instance UUIDs and / or " + "`knowledgeBase_<orgId>`. Get them from `pipeshub_sources`.")
+    limit: number2().int().min(1).max(100).optional().describe("Number of results. Default 10. Use 5–10 when you only need a " + "`recordId`."),
+    apps: array(string2()).optional().describe("Connector ids to search (for example a Jira or Google Drive connection). " + 'Get them from `pipeshub_sources`, where `kind` is "connector". ' + "Collection ids go in `kb`, not here."),
+    kb: array(string2()).optional().describe("Collection (knowledge base) ids to search. Get them from " + '`pipeshub_sources`, where `kind` is "knowledgeBase".')
   };
   tool$pipeshubSearch = {
     name: "pipeshub_search",
@@ -53781,13 +54029,12 @@ not every record that matches. Never count them to answer "how many" /
 "all" / "every"; navigate the record group instead, which reports its
 real total.
 
-The response is trimmed to one row per hit:
-\`{ recordId, recordName, score, snippet, mimeType, webUrl, ... }\`.
-Highest \`score\` first; multiple hits may share the same \`recordId\`
-(different blocks of the same record).
+By default it searches everything. To search only some sources, pass
+connector ids in \`apps\` and collection ids in \`kb\`.
 
-When presenting results to the user, link each record using its
-\`webUrl\` (when present).`,
+Each hit is one matching passage, best match first:
+\`{ recordId, recordName, score, snippet, mimeType, webUrl, ... }\`.
+One record can appear in several hits. Link a record by its \`webUrl\`.`,
     scopes: ["read"],
     annotations: {
       title: "Semantic search",
@@ -53798,10 +54045,12 @@ When presenting results to the user, link each record using its
     },
     args: args2,
     tool: async (client, args3, ctx) => {
+      const limit = args3.limit ?? DEFAULT_LIMIT;
+      const { scope, notes } = await resolveSourceScope(client, args3.apps, args3.kb, { signal: ctx.signal });
       const [result] = await semanticSearchSearch(client, {
         query: args3.query,
-        limit: args3.limit,
-        filters: args3.apps ? { apps: args3.apps, kb: [] } : undefined
+        limit,
+        filters: searchFilters(scope)
       }, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok)
         return errorResult(result.error.message);
@@ -53818,7 +54067,8 @@ When presenting results to the user, link each record using its
           connector: r.connectorName,
           mimeType: r.mimeType,
           webUrl: r.webUrl
-        }))
+        })),
+        ...notes.length > 0 ? { notes } : {}
       });
     }
   };
@@ -53868,9 +54118,9 @@ on this record's knowledge base.
 
 // src/funcs/recordsStreamRecordBuffer.ts
 function recordsStreamRecordBuffer(client$, request, options) {
-  return new APIPromise($do7(client$, request, options));
+  return new APIPromise($do8(client$, request, options));
 }
-async function $do7(client$, request, options) {
+async function $do8(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => StreamRecordBufferRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -53957,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",
@@ -54005,9 +54255,9 @@ var init_getrecordcontentop = __esm(() => {
 
 // src/funcs/connectorGetRecordContent.ts
 function connectorGetRecordContent(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$) => GetRecordContentRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54093,9 +54343,9 @@ var init_lookuprecordbyidentifierop = __esm(() => {
 
 // src/funcs/connectorLookupRecordByIdentifier.ts
 function connectorLookupRecordByIdentifier(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$) => LookupRecordByIdentifierRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54187,9 +54437,9 @@ var init_navigateknowledgegraphop = __esm(() => {
 
 // src/funcs/connectorNavigateKnowledgeGraph.ts
 function connectorNavigateKnowledgeGraph(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$) => NavigateKnowledgeGraphRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54456,9 +54706,9 @@ var init_getallusersop = __esm(() => {
 
 // src/funcs/usersGetAllUsers.ts
 function usersGetAllUsers(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$) => GetAllUsersRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54543,9 +54793,9 @@ var init_getuserbyidop = __esm(() => {
 
 // src/funcs/usersGetUserById.ts
 function usersGetUserById(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$) => GetUserByIdRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54632,9 +54882,9 @@ var init_getallusergroupsop = __esm(() => {
 
 // src/funcs/userGroupsGetAllUserGroups.ts
 function userGroupsGetAllUserGroups(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$) => GetAllUserGroupsRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54724,9 +54974,9 @@ var init_getuserteamsop = __esm(() => {
 
 // src/funcs/teamsGetUserTeams.ts
 function teamsGetUserTeams(client$, request, options) {
-  return new APIPromise($do14(client$, request, options));
+  return new APIPromise($do15(client$, request, options));
 }
-async function $do14(client$, request, options) {
+async function $do15(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => GetUserTeamsRequest$zodSchema.optional().parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -54953,125 +55203,6 @@ Output shape varies by action; see each action's docs above.`,
   };
 });
 
-// src/models/getknowledgehubrootnodesop.ts
-var SortOrder$zodSchema, GetKnowledgeHubRootNodesRequest$zodSchema;
-var init_getknowledgehubrootnodesop = __esm(() => {
-  init_zod();
-  SortOrder$zodSchema = _enum([
-    "asc",
-    "desc"
-  ]).describe("Sort order.");
-  GetKnowledgeHubRootNodesRequest$zodSchema = object({
-    connectorIds: string2().describe("Comma-separated connector instance ids to scope to.").optional(),
-    createdAt: string2().describe("Created date range as `gte:<ms>,lte:<ms>`.").optional(),
-    flattened: boolean2().default(false).describe("Return flattened view with all nested children."),
-    include: string2().describe("Comma-separated includes — any of `breadcrumbs`, `counts`,\n`availableFilters`, `permissions`.\n").optional(),
-    indexingStatus: string2().describe("Comma-separated indexing statuses.").optional(),
-    limit: int().default(50).describe("Items per page."),
-    nodeTypes: string2().describe("Comma-separated node types (`app`, `recordGroup`, `folder`, `record`).").optional(),
-    only_containers: boolean2().default(false).describe("Only return nodes with children (for sidebar UIs)."),
-    origins: string2().describe("Comma-separated origins (`COLLECTION`, `CONNECTOR`).").optional(),
-    page: int().default(1).describe("Page number (1-indexed)."),
-    q: string2().describe("Full-text search query against node names.").optional(),
-    recordTypes: string2().describe("Comma-separated record types.").optional(),
-    size: string2().describe("Size range as `gte:<bytes>,lte:<bytes>`.").optional(),
-    sortBy: string2().default("updatedAt").describe("Sort field — one of `name`, `createdAt`, `updatedAt`, `size`, `type`."),
-    sortOrder: SortOrder$zodSchema.default("desc"),
-    updatedAt: string2().describe("Updated date range as `gte:<ms>,lte:<ms>`.").optional()
-  });
-});
-
-// src/funcs/knowledgeHubGetKnowledgeHubRootNodes.ts
-function knowledgeHubGetKnowledgeHubRootNodes(client$, request, options) {
-  return new APIPromise($do15(client$, request, options));
-}
-async function $do15(client$, request, options) {
-  const parsed$ = safeParse4(request, (value$) => GetKnowledgeHubRootNodesRequest$zodSchema.optional().parse(value$), "Input validation failed");
-  if (!parsed$.ok) {
-    return [parsed$, { status: "invalid" }];
-  }
-  const payload$ = parsed$.value;
-  const body$ = null;
-  const path$ = pathToFunc("/knowledgeBase/knowledge-hub/nodes")();
-  const query$ = encodeFormQuery({
-    connectorIds: payload$?.connectorIds,
-    createdAt: payload$?.createdAt,
-    flattened: payload$?.flattened,
-    include: payload$?.include,
-    indexingStatus: payload$?.indexingStatus,
-    limit: payload$?.limit,
-    nodeTypes: payload$?.nodeTypes,
-    only_containers: payload$?.only_containers,
-    origins: payload$?.origins,
-    page: payload$?.page,
-    q: payload$?.q,
-    recordTypes: payload$?.recordTypes,
-    size: payload$?.size,
-    sortBy: payload$?.sortBy,
-    sortOrder: payload$?.sortOrder,
-    updatedAt: payload$?.updatedAt
-  });
-  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: "getKnowledgeHubRootNodes",
-    oAuth2Scopes: ["kb: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$,
-    query: query$,
-    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_knowledgeHubGetKnowledgeHubRootNodes = __esm(() => {
-  init_encodings();
-  init_primitives();
-  init_schemas4();
-  init_security2();
-  init_url();
-  init_getknowledgehubrootnodesop();
-  init_async();
-});
-
 // src/models/modeltype.ts
 var ModelType$zodSchema;
 var init_modeltype = __esm(() => {
@@ -55181,7 +55312,6 @@ var init_aiModelsProvidersGetAvailableModelsByType = __esm(() => {
 var args6, tool$pipeshubSources;
 var init_pipeshubSources = __esm(() => {
   init_zod();
-  init_knowledgeHubGetKnowledgeHubRootNodes();
   init_aiModelsProvidersGetAvailableModelsByType();
   init__helpers();
   args6 = {
@@ -55193,20 +55323,19 @@ var init_pipeshubSources = __esm(() => {
 
 Returns up to three sections:
 
-- \`sources\` — every connector instance the org has wired up plus the
-  synthetic \`knowledgeBase_<orgId>\` entry for the org's KB. Each
-  item's \`id\` is exactly the value to put in \`pipeshub_chat\`'s or
-  \`pipeshub_search\`'s \`apps\` filter.
+- \`sources\` — connectors (\`kind: "connector"\`) and collections
+  (\`kind: "knowledgeBase"\`). For \`pipeshub_search\` and
+  \`pipeshub_chat\`, put a connector \`id\` in \`apps\` and a collection
+  \`id\` in \`kb\`. \`sourcesTruncated: true\` means the list stopped at
+  1,000 sources.
 - \`llmModels\` — chat / generation models. Each item's \`modelKey\`
-  is the value to pass on \`pipeshub_chat\` / \`pipeshub_search\` as
-  \`modelKey\`. Pick \`isDefault: true\` unless the user asks for a
-  specific model.
+  is the value to pass on \`pipeshub_chat\` as \`modelKey\`. Pick
+  \`isDefault: true\` unless the user asks for a specific model.
 - \`embeddingModels\` — vector embedding models (only fetched when
   explicitly requested via \`include\`).
 
 Call this once at the start of a session and cache the result —
-sources and models change infrequently. \`sources\` and \`llmModels\`
-are returned by default; pass \`include\` to override.`,
+sources and models change infrequently.`,
     scopes: ["read"],
     annotations: {
       title: "List PipesHub sources and AI models",
@@ -55222,22 +55351,12 @@ are returned by default; pass \`include\` to override.`,
       const want = (s) => include.includes(s);
       const result = {};
       if (want("sources")) {
-        const [r] = await knowledgeHubGetKnowledgeHubRootNodes(client, {
-          page: 1,
-          limit: 200
-        }, { fetchOptions }).$inspect();
-        if (!r.ok)
-          return errorResult(`sources: ${r.error.message}`);
-        const parsed = await readJson(r.value, "Knowledge base listing");
-        if (!parsed.ok)
-          return parsed.result;
-        result["sources"] = (parsed.value.items ?? []).map((n) => ({
-          id: n.id,
-          name: n.name,
-          kind: n.connector === "KB" ? "knowledgeBase" : "connector",
-          connector: n.connector,
-          hasChildren: n.hasChildren
-        }));
+        const listed = await listAllSources(client, { signal: ctx.signal });
+        if (!listed.ok)
+          return listed.result;
+        result["sources"] = listed.sources;
+        if (listed.truncated)
+          result["sourcesTruncated"] = true;
       }
       for (const [key, modelType] of [
         ["llmModels", "llm"],
@@ -55425,7 +55544,7 @@ var init_tool_names = __esm(() => {
   toolNames = [
     {
       name: "pipeshub_sources",
-      description: "Discover available chat sources and AI models in one call.\n\nReturns up to three sections:\n\n- `sources` — every connector instance the org has wired up plus the\n  synthetic `knowledgeBase_<orgId>` entry for the org's KB. Each\n  item's `id` is exactly the value to put in `pipeshub_chat`'s or\n  `pipeshub_search`'s `apps` filter.\n- `llmModels` — chat / generation models. Each item's `modelKey`\n  is the value to pass on `pipeshub_chat` / `pipeshub_search` as\n  `modelKey`. Pick `isDefault: true` unless the user asks for a\n  specific model.\n- `embeddingModels` — vector embedding models (only fetched when\n  explicitly requested via `include`).\n\nCall this once at the start of a session and cache the result —\nsources and models change infrequently. `sources` and `llmModels`\nare returned by default; pass `include` to override."
+      description: 'Discover available chat sources and AI models in one call.\n\nReturns up to three sections:\n\n- `sources` — connectors (`kind: "connector"`) and collections\n  (`kind: "knowledgeBase"`). For `pipeshub_search` and\n  `pipeshub_chat`, put a connector `id` in `apps` and a collection\n  `id` in `kb`. `sourcesTruncated: true` means the list stopped at\n  1,000 sources.\n- `llmModels` — chat / generation models. Each item\'s `modelKey`\n  is the value to pass on `pipeshub_chat` as `modelKey`. Pick\n  `isDefault: true` unless the user asks for a specific model.\n- `embeddingModels` — vector embedding models (only fetched when\n  explicitly requested via `include`).\n\nCall this once at the start of a session and cache the result —\nsources and models change infrequently.'
     },
     {
       name: "pipeshub_chat",
@@ -55510,17 +55629,16 @@ not every record that matches. Never count them to answer "how many" /
 "all" / "every"; navigate the record group instead, which reports its
 real total.
 
-The response is trimmed to one row per hit:
-\`{ recordId, recordName, score, snippet, mimeType, webUrl, ... }\`.
-Highest \`score\` first; multiple hits may share the same \`recordId\`
-(different blocks of the same record).
+By default it searches everything. To search only some sources, pass
+connector ids in \`apps\` and collection ids in \`kb\`.
 
-When presenting results to the user, link each record using its
-\`webUrl\` (when present).`
+Each hit is one matching passage, best match first:
+\`{ recordId, recordName, score, snippet, mimeType, webUrl, ... }\`.
+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",
@@ -59234,5 +59352,5 @@ export {
   app
 };
 
-//# debugId=AB395F463BB257DB64756E2164756E21
+//# debugId=DDE3715978A747DC64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map