@pipeshub-ai/mcp 2.0.1 → 2.2.0

package/esm/hooks/request-context.d.ts

@@ -0,0 +1,10 @@
+export interface RequestContextStore {
+    random: string;
+    finalId?: string;
+}
+/** Bind a fresh request-id context for the remainder of the current async chain. */
+export declare function bindNewRequestId(): void;
+export declare function getRequestContextStore(): RequestContextStore | undefined;
+/** One-off id for the rare case a backend call happens with no bound tool-call context. */
+export declare function newRequestId(): string;
+//# sourceMappingURL=request-context.d.ts.map

package/esm/hooks/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/hooks/request-context.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,oFAAoF;AACpF,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/esm/hooks/request-context.js

@@ -0,0 +1,38 @@
+/*
+ * Ambient per-tool-call request-id context (AsyncLocalStorage). Mirrors the
+ * pipeshub-ai backend's own request-context pattern (same header name,
+ * `x-request-id`) so a single id traces one MCP tool/resource/prompt
+ * invocation across every backend HTTP call it makes.
+ *
+ * `tools.ts` / `resources.ts` / `prompts.ts` are Speakeasy-generated and
+ * regenerated on every build, so there is no `next()`-style wrapper point to
+ * bind context around a call. Instead `bindNewRequestId` is called from the
+ * hand-written `getClient` closure in `server.ts`, which every generated
+ * dispatch site calls synchronously as the first thing before invoking a
+ * tool/resource/prompt handler — `enterWith` binds the store for the rest of
+ * that handler's execution (sync remainder + everything it awaits).
+ *
+ * The final id (`mcp-<userId>-<random>` or `mcp-<random>`) can't be composed
+ * at bind time — `getClient` only has a `PipeshubCore`, not yet a resolved
+ * `Authorization` header, and resolving security may be async (OAuth2)
+ * while `getClient` must stay sync (generated call sites pass its return
+ * value straight into a handler, never await it). So only the random suffix
+ * is fixed here; `requestid.ts`'s hook fills in `finalId` off the first
+ * outbound request's `Authorization` header and every later call in the
+ * same tool invocation reuses that cached value.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { nanoid } from "nanoid";
+const storage = new AsyncLocalStorage();
+/** Bind a fresh request-id context for the remainder of the current async chain. */
+export function bindNewRequestId() {
+    storage.enterWith({ random: nanoid() });
+}
+export function getRequestContextStore() {
+    return storage.getStore();
+}
+/** One-off id for the rare case a backend call happens with no bound tool-call context. */
+export function newRequestId() {
+    return `mcp-${nanoid()}`;
+}
+//# sourceMappingURL=request-context.js.map

package/esm/hooks/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/hooks/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOhC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAuB,CAAC;AAE7D,oFAAoF;AACpF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,MAAM,EAAE,EAAE,CAAC;AAC3B,CAAC"}

package/esm/hooks/requestid.d.ts

@@ -0,0 +1,5 @@
+import { BeforeRequestContext, BeforeRequestHook } from "./types.js";
+export declare class RequestIDHook implements BeforeRequestHook {
+    beforeRequest(_hookCtx: BeforeRequestContext, request: Request): Request;
+}
+//# sourceMappingURL=requestid.d.ts.map

package/esm/hooks/requestid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestid.d.ts","sourceRoot":"","sources":["../../src/hooks/requestid.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0BrE,qBAAa,aAAc,YAAW,iBAAiB;IACrD,aAAa,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;CAqBzE"}

package/esm/hooks/requestid.js

@@ -0,0 +1,58 @@
+/*
+ * Stamp an x-request-id trace header onto every outbound SDK request, reusing
+ * the id bound for the current MCP tool/resource/prompt call (see
+ * request-context.ts) so all backend calls from one invocation share it.
+ *
+ * Format mirrors the TypeScript SDK's own RequestIDHook: `mcp-<userId>-<random>`
+ * when the bearer JWT carries a userId claim, else `mcp-<random>`. The userId
+ * is only knowable once a request actually carries a resolved Authorization
+ * header, so it's decoded off the first outbound request of the tool call and
+ * cached on the bound context for every subsequent call to reuse verbatim.
+ */
+import { getRequestContextStore, newRequestId } from "./request-context.js";
+const REQUEST_ID_HEADER = "x-request-id";
+/** Decodes the JWT payload without verifying the signature. */
+function decodeJwtPayload(token) {
+    try {
+        const base64Url = token.split(".")[1];
+        if (!base64Url)
+            return null;
+        const base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+        const padded = base64 + "=".repeat((4 - (base64.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;
+}
+export class RequestIDHook {
+    beforeRequest(_hookCtx, request) {
+        if (request.headers.get(REQUEST_ID_HEADER)) {
+            return request;
+        }
+        const store = getRequestContextStore();
+        if (!store) {
+            // No bound tool-call context (shouldn't happen in practice).
+            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;
+    }
+}
+//# sourceMappingURL=requestid.js.map

package/esm/hooks/requestid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestid.js","sourceRoot":"","sources":["../../src/hooks/requestid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,+DAA+D;AAC/D,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAQ,MAAM,EAAE,CAAC,QAAQ,CAAY,IAAI,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,OAAO,aAAa;IACxB,aAAa,CAAC,QAA8B,EAAE,OAAgB;QAC5D,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,6DAA6D;YAC7D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC1C,KAAK,CAAC,OAAO,GAAG,MAAM;gBACpB,CAAC,CAAC,OAAO,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE;gBACjC,CAAC,CAAC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/esm/mcp-server/instructions.d.ts

@@ -0,0 +1,2 @@
+export declare const PIPESHUB_INSTRUCTIONS = "# PipesHub MCP \u2014 instructions for the LLM\n\nPipesHub is the user's workplace AI platform. It indexes their documents,\nknowledge base content, and connector sources (Drive, Box, Confluence,\nSlack, Jira, Gmail, ...). When in doubt, the answer is in PipesHub.\n\n## Full-document tasks: `pipeshub_search` \u2192 `pipeshub_get_record_content`\n\n`pipeshub_chat` answers from a handful of retrieved passages \u2014 it never\nreads a whole document. Whenever the task depends on a document's\nCOMPLETE content, fetch the document itself:\n\n1. `pipeshub_search` with the document's name / topic.\n2. Take the top hit's `recordId`.\n3. `pipeshub_get_record_content`, and answer from the returned content.\n\nTasks that need this path \u2014 anything where missing part of the document\ncould make the answer wrong:\n\n- Summarize / TL;DR / key points / takeaways / action items of a doc.\n- Extract or list ALL of something (dates, owners, requirements, ...).\n- Check whether / where a doc mentions something.\n- Translate, rewrite, outline, review, or reformat a doc.\n- Compare named docs (fetch each `recordId`).\n- Any question explicitly scoped to ONE named document \u2014 chat retrieval\n  cannot be restricted to a single record.\n\n## Default tool: `pipeshub_chat`\n\n**Use `pipeshub_chat` for any question that could plausibly be answered\nby the user's PipesHub-indexed data** and is not a full-document task:\n\n- A question that may span several documents, or where you don't yet\n  know which record holds the answer (e.g. \"what did Aashil say about\n  onboarding?\").\n- Anything about company / org policies, processes, decisions, or\n  history (e.g. \"what's our vacation policy?\", \"who owns the auth\n  service?\").\n- Anything explicitly mentioning PipesHub itself, or its sources\n  (Drive / Box / Confluence / Slack / Gmail / Jira / etc.) when the\n  user has those connected.\n- Open-ended \"what do we know about X\" questions where the answer\n  likely lives in the org's documents.\n\nDo NOT answer those from your own knowledge \u2014 `pipeshub_chat` grounds\nthe answer in the user's actual indexed content and returns citations\nthe user can verify.\n\n## When to use the other tools\n\n- `pipeshub_search` \u2014 locate a document by name or topic and resolve it\n  to a `recordId`. To read or summarize one specific document, search,\n  then pass the top hit's `recordId` to `pipeshub_get_record_content`.\n- `pipeshub_download_record` \u2014 when the user wants the actual file\n  bytes (download, attach, open). Get the `recordId` either from\n  citations on a prior `pipeshub_chat` response or from\n  `pipeshub_search`.\n- `pipeshub_get_record_content` \u2014 when you need a record's full parsed\n  content (returned as a single `content` string: metadata header plus\n  the document's text) without downloading the original file. Prefer this\n  over download when the question is about what the record says.\n- `pipeshub_directory` \u2014 people, groups, teams, and `whoami` lookups.\n  Not for documents.\n- `pipeshub_sources` \u2014 call once at the start of a session to discover\n  which connectors / KB / models are available, then cache the result.\n- `pipeshub_agents` \u2014 list the org's configured **agents** (specialized\n  assistants with their own prompt, tools, and knowledge scope).\n\n## Agents\n\nSome orgs configure **agents** for specific jobs (e.g. a Slack messenger, a\nJira ticket creator, a Salesforce CRM updater). To run a turn against an\nagent, call `pipeshub_chat` with its `agentId` (from `pipeshub_agents`)\n\u2014 optionally with an agent `chatMode` (`auto` by default, or `quick` /\n`verification` / `deep`). Keep passing the same `agentId` plus the\nreturned `conversationId` on follow-up turns.\n\n**When to route to an agent vs plain chat:**\n- The user names a system/action that maps to an agent (e.g. \"post to\n  Slack\", \"create a Jira ticket\", \"update the Salesforce deal\") \u2192 call\n  `pipeshub_agents`, pick the matching agent, and use it.\n- Plain question about the org's knowledge or the public web \u2192 just use\n  `pipeshub_chat` (no `agentId`) with `internal_search` or `web_search`.\n\n**If you are unsure which agent or route fits the request**, call\n`pipeshub_agents` FIRST and read the returned names/descriptions, then\neither pick the best match or present the list to the user and let them\nchoose. Do NOT guess an agent blindly, and do NOT refuse \u2014 list the agents\nand decide from real data. The list may be empty (no agents configured),\nin which case fall back to plain `pipeshub_chat`.\n\n## Conversation lifecycle\n\n`pipeshub_chat` is a single tool that handles both starting and\ncontinuing conversations (plain or with an `agentId`). On the first turn\nomit `conversationId`; on every subsequent turn pass back the\n`conversationId` returned by the previous call (along with the same\n`agentId` if you used one). Server-side context is preserved \u2014 do NOT\nreplay prior messages. Only start a fresh conversation when the user\nexplicitly asks to clear context.\n";
+//# sourceMappingURL=instructions.d.ts.map

package/esm/mcp-server/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/mcp-server/instructions.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,q+JAoGjC,CAAC"}

package/esm/mcp-server/instructions.js

@@ -0,0 +1,106 @@
+// 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.
+
+## 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** and is not a full-document task:
+
+- 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?").
+- 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\` — 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
+  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.
+`;
+//# sourceMappingURL=instructions.js.map

package/esm/mcp-server/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/mcp-server/instructions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sEAAsE;AACtE,sEAAsE;AACtE,gEAAgE;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGpC,CAAC"}

package/esm/mcp-server/prompts/pipeshubAssistant.d.ts

@@ -0,0 +1,8 @@
+import * as z from "zod";
+import { PromptDefinition } from "../prompts.js";
+declare const args: {
+    query: z.ZodOptional<z.ZodString>;
+};
+export declare const prompt$pipeshubAssistant: PromptDefinition<typeof args>;
+export {};
+//# sourceMappingURL=pipeshubAssistant.d.ts.map

package/esm/mcp-server/prompts/pipeshubAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeshubAssistant.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/prompts/pipeshubAssistant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,QAAA,MAAM,IAAI;;CAMT,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,CAAC,OAAO,IAAI,CAwBlE,CAAC"}

package/esm/mcp-server/prompts/pipeshubAssistant.js

@@ -0,0 +1,31 @@
+import * as z from "zod";
+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 = {
+    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 },
+                },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=pipeshubAssistant.js.map

package/esm/mcp-server/prompts/pipeshubAssistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeshubAssistant.js","sourceRoot":"","sources":["../../../src/mcp-server/prompts/pipeshubAssistant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,yEAAyE;UACrE,kEAAkE;UAClE,6DAA6D,CAClE;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAkC;IACrE,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,yEAAyE;UACvE,sEAAsE;UACtE,8DAA8D;IAClE,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,IAAI;IACJ,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK;YACrB,CAAC,CAAC,GAAG,qBAAqB,+CAA+C;kBACrE,sEAAsE;kBACtE,uDAAuD,IAAI,CAAC,KAAK,EAAE;YACvE,CAAC,CAAC,qBAAqB,CAAC;QAE1B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;iBAChC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/esm/mcp-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2DpE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAChD,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;CACvD;;;;;;EAkEA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAWvC,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAChD,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;CACvD;;;;;;EA2EA"}

package/esm/mcp-server/server.js

@@ -1,71 +1,18 @@
-// 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 { bindNewRequestId } from "../hooks/request-context.js";
 import { createRegisterPrompt } from "./prompts.js";
 import { createRegisterResource, createRegisterResourceTemplate, } from "./resources.js";
 import { createRegisterTool, registerDynamicTools } from "./tools.js";
 import { tool$pipeshubChat } from "./tools/pipeshubChat.js";
 import { tool$pipeshubSearch } from "./tools/pipeshubSearch.js";
 import { tool$pipeshubDownloadRecord } from "./tools/pipeshubDownloadRecord.js";
+import { tool$pipeshubGetRecordContent } from "./tools/pipeshubGetRecordContent.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) {
     const server = new McpServer({
         name: "pipeshub-mcp",
@@ -73,7 +20,7 @@ export 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,
@@ -86,6 +33,10 @@ export function createMCPServer(deps) {
             }
             : 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);
@@ -94,13 +45,16 @@ export function createMCPServer(deps) {
     const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
     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$pipeshubGetRecordContent); // 5. fetch a record's parsed content
+    tool(tool$pipeshubDirectory); // 6. people / groups / teams / whoami
+    tool(tool$pipeshubAgents); // 7. discover org agents
+    // Curated prompt: user-invokable tool-routing guidance.
+    prompt(prompt$pipeshubAssistant);
     if (deps.dynamic) {
         registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);
     }

package/esm/mcp-server/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,UAAU,eAAe,CAAC,IAU/B;IACC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,qBAAqB;KACpC,CACF,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CACzC,IAAI,YAAY,CAAC;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO;YACxC,CAAC,CAAC;gBACA,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACtC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBAC1C,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;aACjD;YACD,CAAC,CAAC,SAAS;KACd,CAAC,CAAC,CAAC;IAEN,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,gBAAgB,EAAE,CAAC;QACnB,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAC/C,IAAI,CAAC,MAAM,EACX,MAAM,EACN,SAAS,EACT,MAAM,EACN,YAAY,EACZ,IAAI,CAAC,OAAO,CACb,CAAC;IACF,MAAM,QAAQ,GAAG,sBAAsB,CACrC,IAAI,CAAC,MAAM,EACX,MAAM,EACN,SAAS,EACT,MAAM,CACP,CAAC;IACF,MAAM,gBAAgB,GAAG,8BAA8B,CACrD,IAAI,CAAC,MAAM,EACX,MAAM,EACN,SAAS,EACT,MAAM,CACP,CAAC;IACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC9D,KAAK,QAAQ,CAAC,CAAC,2BAA2B;IAE1C,wEAAwE;IACxE,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAU,+BAA+B;IACpE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAa,sCAAsC;IAC3E,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAW,iCAAiC;IACtE,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAG,4BAA4B;IACjE,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC,qCAAqC;IAC1E,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAQ,sCAAsC;IAC3E,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAW,yBAAyB;IAE9D,wDAAwD;IACxD,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEjC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/esm/mcp-server/tools/_helpers.d.ts

@@ -1,6 +1,8 @@
+import * as z from "zod";
 import { Security } from "../../models/security.js";
 import { PipeshubCore } from "../../core.js";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { AgentSummary } from "../../models/agentops.js";
 /**
  * Parse a fetch Response as JSON, returning a CallToolResult error when the
  * body is missing / malformed.
@@ -16,6 +18,30 @@ export declare function readJson<T = unknown>(response: Response): Promise<{
 export declare function jsonResult(value: unknown): CallToolResult;
 /** Standard error → CallToolResult conversion. */
 export declare function errorResult(message: string): CallToolResult;
+/**
+ * Guard a (possibly streaming) `Response` on its HTTP status. The streaming
+ * SDK funcs configure `errorCodes: []`, so the request layer treats ANY HTTP
+ * response — including 401 / 403 / 404 / 5xx — as a success and hands back the
+ * raw `Response`. Without this check those failures slip into the SSE drain
+ * and surface as the useless "stream ended without usable frames".
+ *
+ * Returns a `CallToolResult` error (status + best-effort message from the body)
+ * when the response is not ok, or `null` when it is ok (body left untouched so
+ * the caller can still stream it).
+ */
+export declare function httpErrorResult(response: Response, context: string): Promise<CallToolResult | null>;
+/**
+ * Read a `Response` body as JSON and validate it against a zod `schema`,
+ * returning the typed value or a `CallToolResult` error (empty body, invalid
+ * JSON, or a shape that doesn't match the schema).
+ */
+export declare function readValidated<T>(response: Response, schema: z.ZodType<T>): Promise<{
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    result: CallToolResult;
+}>;
 /** Resolve `client._options.security` (which may be a function) to a value. */
 export declare function resolveSecurity(client: PipeshubCore): Promise<Security | undefined>;
 /**
@@ -85,6 +111,57 @@ export type SSEFrame = {
  * generator does not need to recheck it.
  */
 export declare function iterateSSE(response: Response): AsyncGenerator<SSEFrame, void, unknown>;
+interface AgentToolsetView {
+    /** Integration / connector key, e.g. `jira`, `gmail`. */
+    name: string | null | undefined;
+    /** Fully-qualified tool ids the agent can run, e.g. `jira.create_issue`. */
+    tools: string[];
+}
+interface AgentKnowledgeView {
+    name: string | null | undefined;
+    type: string | null | undefined;
+}
+export interface EnrichedAgent {
+    agentId: string;
+    name: string;
+    description: string | null;
+    systemPrompt: string | null;
+    startMessage: string | null;
+    tags: string[];
+    webSearch: boolean;
+    isActive: boolean | null | undefined;
+    toolsets: AgentToolsetView[];
+    knowledge: AgentKnowledgeView[];
+}
+/**
+ * Trim an enriched `AgentSummary` (from `GET /agents`) to just what the LLM
+ * needs to pick and converse with an agent. Strips ids/revs/timestamps/perms
+ * and the heavy nested tool/knowledge metadata, keeping the routing-critical
+ * signal: each toolset's connector `name` + its tool ids (e.g.
+ * `jira.create_issue`), and each knowledge source's `name`/`type`.
+ */
+export declare function trimAgent(a: AgentSummary): EnrichedAgent;
+/**
+ * Fetch the COMPLETE agent list, auto-paginating `GET /agents` so callers
+ * (discovery + routing) never have to manage page numbers. Pages are fetched
+ * at the max page size until the backend reports no more (`hasNext` /
+ * `hasNextPage`, with a short-page fallback), capped by `maxPages` as a
+ * runaway guard. Returns the raw `AgentListItem`s plus a normalized `total`
+ * and a `truncated` flag (true if the cap was hit before exhausting pages).
+ */
+export declare function listAllAgents(client: PipeshubCore, opts?: {
+    search?: string | undefined;
+    signal?: AbortSignal | undefined;
+    maxPages?: number | undefined;
+}): Promise<{
+    ok: true;
+    agents: AgentSummary[];
+    total: number;
+    truncated: boolean;
+} | {
+    ok: false;
+    result: CallToolResult;
+}>;
 /** Trim a single search hit to what the LLM actually needs. */
 export declare function trimSearchHit(hit: any): {
     recordId: any;
@@ -97,4 +174,5 @@ export declare function trimSearchHit(hit: any): {
     webUrl: any;
     pageNum: any;
 };
+export {};
 //# sourceMappingURL=_helpers.d.ts.map

package/esm/mcp-server/tools/_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/_helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CA2BzE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAIzD;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAK3D;AAED,+EAA+E;AAC/E,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAM/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAoBzC;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;;;;;EAkBzC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO;;;;;;;;IAgB/C;AAID;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CA+EzC;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;EAerC"}
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/_helpers.ts"],"names":[],"mappings":"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"}