@pipeshub-ai/mcp 2.0.0 → 2.1.0

package/src/funcs/agentsListAgents.ts

@@ -0,0 +1,141 @@
+// Mirrors `usersGetAllUsers.ts`
+// but hits `GET /agents` (operationId `listAgents`). Returns the raw JSON
+// `Response`; the caller parses the `{ success, agents, pagination }` envelope.
+
+import { PipeshubCore } from "../core.js";
+import { encodeFormQuery } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ListAgentsRequest,
+  ListAgentsRequest$zodSchema,
+} from "../models/agentops.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+export function agentsListAgents(
+  client$: PipeshubCore,
+  request?: ListAgentsRequest | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(client$, request, options));
+}
+
+async function $do(
+  client$: PipeshubCore,
+  request?: ListAgentsRequest | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => ListAgentsRequest$zodSchema.optional().parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const path$ = pathToFunc("/agents")();
+  const query$ = encodeFormQuery({
+    "page": payload$?.page,
+    "limit": payload$?.limit,
+    "search": payload$?.search,
+    "sort_by": payload$?.sortBy,
+    "sort_order": payload$?.sortOrder,
+  });
+
+  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: "listAgents",
+    oAuth2Scopes: ["agent: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,
+  }];
+}

package/src/funcs/agentsStreamConversation.ts

@@ -0,0 +1,144 @@
+// POST `/agents/{agentKey}/conversations/stream` (operationId
+// `streamAgentConversation`) to start a conversation with a specific agent.
+// Returns the raw streaming `Response`; the caller parses `text/event-stream`
+// line-by-line.
+
+import { PipeshubCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  AgentStreamCreateConversationRequest,
+  AgentStreamCreateConversationRequest$zodSchema,
+} from "../models/agentops.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+export function agentsStreamConversation(
+  client$: PipeshubCore,
+  request: AgentStreamCreateConversationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(client$, request, options));
+}
+
+async function $do(
+  client$: PipeshubCore,
+  request: AgentStreamCreateConversationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => AgentStreamCreateConversationRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.body, { explode: true });
+
+  const pathParams$ = {
+    agentKey: encodeSimple("agentKey", payload$.agentKey, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc(
+    "/agents/{agentKey}/conversations/stream",
+  )(pathParams$);
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "text/event-stream",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "streamAgentConversation",
+    oAuth2Scopes: ["agent:execute"],
+    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: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    // SSE streams are long-lived; let the caller's AbortSignal cap it.
+    timeoutMs: 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,
+  }];
+}

package/src/funcs/agentsStreamMessage.ts

@@ -0,0 +1,147 @@
+// POSTs to `/agents/{agentKey}/conversations/{conversationId}/messages/stream`
+// (operationId `streamAgentConversationMessage`) to append a follow-up turn
+// to an existing agent conversation. Returns the raw streaming `Response`.
+
+import { PipeshubCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  AgentAddMessageStreamRequest,
+  AgentAddMessageStreamRequest$zodSchema,
+} from "../models/agentops.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+export function agentsStreamMessage(
+  client$: PipeshubCore,
+  request: AgentAddMessageStreamRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(client$, request, options));
+}
+
+async function $do(
+  client$: PipeshubCore,
+  request: AgentAddMessageStreamRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => AgentAddMessageStreamRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.body, { explode: true });
+
+  const pathParams$ = {
+    agentKey: encodeSimple("agentKey", payload$.agentKey, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    conversationId: encodeSimple("conversationId", payload$.conversationId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc(
+    "/agents/{agentKey}/conversations/{conversationId}/messages/stream",
+  )(pathParams$);
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "text/event-stream",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "streamAgentConversationMessage",
+    oAuth2Scopes: ["agent:execute"],
+    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: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    // SSE streams are long-lived; let the caller's AbortSignal cap it.
+    timeoutMs: 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,
+  }];
+}

package/src/funcs/conversationsStreamConversation.ts

@@ -1,6 +1,4 @@
-// Hand-written supplement (NOT generated). Mirrors
-// `conversationsCreateConversation.ts` but POSTs to `/conversations/stream`
-// and asks for an SSE response. The body shape is identical to the
+// POSTs to `/conversations/stream` and asks for an SSE response. The body shape is identical to the
 // non-streaming sibling, so we reuse `CreateConversationRequest`'s zod
 // schema. Returns the raw streaming `Response`; the caller is expected to
 // parse `text/event-stream` line-by-line.

package/src/funcs/conversationsStreamMessage.ts

@@ -1,11 +1,3 @@
-// Hand-written supplement (NOT generated). Mirrors
-// `conversationsAddMessage.ts` but POSTs to
-// `/conversations/{conversationId}/messages/stream` and asks for an SSE
-// response. The body shape is identical to the non-streaming sibling, so
-// we reuse `AddMessageRequestRequest`'s zod schema. Returns the raw
-// streaming `Response`; the caller is expected to parse `text/event-stream`
-// line-by-line.
-
 import { PipeshubCore } from "../core.js";
 import { encodeJSON, encodeSimple } from "../lib/encodings.js";
 import { compactMap } from "../lib/primitives.js";

package/src/mcp-server/instructions.ts

@@ -0,0 +1,83 @@
+// Shared routing guidance for the host LLM. Surfaced two ways:
+//   1. As the server `instructions` (always present at `initialize`).
+//   2. As the body of the user-invokable `pipeshub-assistant` prompt.
+// Keeping it in one place avoids the two copies drifting apart.
+
+export const PIPESHUB_INSTRUCTIONS = `# PipesHub MCP — instructions for the LLM
+
+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.
+
+## Default tool: \`pipeshub_chat\`
+
+**Use \`pipeshub_chat\` for any question that could plausibly be answered
+by the user's PipesHub-indexed data.** That includes:
+
+- 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?").
+- Anything about company / org policies, processes, decisions, or
+  history (e.g. "what's our vacation policy?", "who owns the auth
+  service?").
+- Anything explicitly mentioning PipesHub itself, or its sources
+  (Drive / Box / Confluence / Slack / Gmail / Jira / etc.) when the
+  user has those connected.
+- Open-ended "what do we know about X" questions where the answer
+  likely lives in the org's documents.
+
+Do NOT answer those from your own knowledge — \`pipeshub_chat\` grounds
+the answer in the user's actual indexed content and returns citations
+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_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_directory\` — people, groups, teams, and \`whoami\` lookups.
+  Not for documents.
+- \`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
+  assistants with their own prompt, tools, and knowledge scope).
+
+## Agents
+
+Some orgs configure **agents** for specific jobs (e.g. a Slack messenger, a
+Jira ticket creator, a Salesforce CRM updater). To run a turn against an
+agent, call \`pipeshub_chat\` with its \`agentId\` (from \`pipeshub_agents\`)
+— optionally with an agent \`chatMode\` (\`auto\` by default, or \`quick\` /
+\`verification\` / \`deep\`). Keep passing the same \`agentId\` plus the
+returned \`conversationId\` on follow-up turns.
+
+**When to route to an agent vs plain chat:**
+- The user names a system/action that maps to an agent (e.g. "post to
+  Slack", "create a Jira ticket", "update the Salesforce deal") → call
+  \`pipeshub_agents\`, pick the matching agent, and use it.
+- Plain question about the org's knowledge or the public web → just use
+  \`pipeshub_chat\` (no \`agentId\`) with \`internal_search\` or \`web_search\`.
+
+**If you are unsure which agent or route fits the request**, call
+\`pipeshub_agents\` FIRST and read the returned names/descriptions, then
+either pick the best match or present the list to the user and let them
+choose. Do NOT guess an agent blindly, and do NOT refuse — list the agents
+and decide from real data. The list may be empty (no agents configured),
+in which case fall back to plain \`pipeshub_chat\`.
+
+## Conversation lifecycle
+
+\`pipeshub_chat\` is a single tool that handles both starting and
+continuing conversations (plain or with an \`agentId\`). On the first turn
+omit \`conversationId\`; on every subsequent turn pass back the
+\`conversationId\` returned by the previous call (along with the same
+\`agentId\` if you used one). Server-side context is preserved — do NOT
+replay prior messages. Only start a fresh conversation when the user
+explicitly asks to clear context.
+`;

package/src/mcp-server/prompts/pipeshubAssistant.ts

@@ -0,0 +1,37 @@
+import * as z from "zod";
+import { PromptDefinition } from "../prompts.js";
+import { PIPESHUB_INSTRUCTIONS } from "../instructions.js";
+
+const args = {
+  query: z.string().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.",
+  ),
+};
+
+export const prompt$pipeshubAssistant: PromptDefinition<typeof args> = {
+  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,
+  prompt: (_client, args, _extra) => {
+    const text = args.query
+      ? `${PIPESHUB_INSTRUCTIONS}\n\n---\n\nFollow the routing rules above to `
+        + `handle this request, picking the right tool (and listing agents via `
+        + `\`pipeshub_agents\` if unsure which route fits):\n\n${args.query}`
+      : PIPESHUB_INSTRUCTIONS;
+
+    return {
+      messages: [
+        {
+          role: "user",
+          content: { type: "text", text },
+        },
+      ],
+    };
+  },
+};

package/src/mcp-server/server.ts

@@ -1,65 +1,6 @@
-// Hand-written; replaces the Speakeasy-generated server.ts. Registers the
-// five curated PipesHub tools instead of one tool per OpenAPI operation.
-
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
-// Top-level instructions surfaced to the host LLM at server initialize.
-// These set defaults so the model picks `pipeshub_chat` as the natural
-// entry point for anything that touches the user's PipesHub data —
-// documents, files, knowledge base content, citations, etc.
-const PIPESHUB_INSTRUCTIONS = `# PipesHub MCP — instructions for the LLM
-
-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.
-
-## Default tool: \`pipeshub_chat\`
-
-**Use \`pipeshub_chat\` for any question that could plausibly be answered
-by the user's PipesHub-indexed data.** That includes:
-
-- 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?").
-- Anything about company / org policies, processes, decisions, or
-  history (e.g. "what's our vacation policy?", "who owns the auth
-  service?").
-- Anything explicitly mentioning PipesHub itself, or its sources
-  (Drive / Box / Confluence / Slack / Gmail / Jira / etc.) when the
-  user has those connected.
-- Open-ended "what do we know about X" questions where the answer
-  likely lives in the org's documents.
-
-Do NOT answer those from your own knowledge — \`pipeshub_chat\` grounds
-the answer in the user's actual indexed content and returns citations
-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_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_directory\` — people, groups, teams, and \`whoami\` lookups.
-  Not for documents.
-- \`pipeshub_sources\` — call once at the start of a session to discover
-  which connectors / KB / models are available, then cache the result.
-
-## Conversation lifecycle
-
-\`pipeshub_chat\` is a single tool that handles both starting and
-continuing conversations. On the first turn omit \`conversationId\`; on
-every subsequent turn pass back the \`conversationId\` returned by the
-previous call. Server-side context is preserved — do NOT replay prior
-messages. Only start a fresh conversation when the user explicitly
-asks to clear context.
-`;
-
+import { PIPESHUB_INSTRUCTIONS } from "./instructions.js";
 import { PipeshubCore } from "../core.js";
 import { SDKOptions } from "../lib/config.js";
 import type { ConsoleLogger } from "./console-logger.js";
@@ -75,6 +16,8 @@ import { tool$pipeshubSearch } from "./tools/pipeshubSearch.js";
 import { tool$pipeshubDownloadRecord } from "./tools/pipeshubDownloadRecord.js";
 import { tool$pipeshubDirectory } from "./tools/pipeshubDirectory.js";
 import { tool$pipeshubSources } from "./tools/pipeshubSources.js";
+import { tool$pipeshubAgents } from "./tools/pipeshubAgents.js";
+import { prompt$pipeshubAssistant } from "./prompts/pipeshubAssistant.js";
 
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
@@ -139,13 +82,16 @@ export function createMCPServer(deps: {
   const register = { tool, resource, resourceTemplate, prompt };
   void register; // suppress unused warnings
 
-  // Curated tool set. Five tools instead of ten one-per-op generated tools.
-  // Order = preferred discovery order shown to the LLM.
+  // Curated tool set. Order = preferred discovery order shown to the LLM.
   tool(tool$pipeshubSources);          // 1. discover sources + models
   tool(tool$pipeshubChat);             // 2. ask questions (start + continue)
   tool(tool$pipeshubSearch);           // 3. resolve filename → recordId
   tool(tool$pipeshubDownloadRecord);   // 4. fetch a document by id
   tool(tool$pipeshubDirectory);        // 5. people / groups / teams / whoami
+  tool(tool$pipeshubAgents);           // 6. discover org agents
+
+  // Curated prompt: user-invokable tool-routing guidance.
+  prompt(prompt$pipeshubAssistant);
 
   if (deps.dynamic) {
     registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);