thorbit-kb-mcp 0.2.7 → 0.2.8

package/dist/bin/thorbit-kb-mcp.cjs

@@ -169,7 +169,7 @@ var ThorbitKbAskInputSchema = {
 };
 
 // src/thorbit-kb-mcp-server.ts
-var VERSION = "0.2.7";
+var VERSION = "0.2.8";
 function readOnlyAnnotations(title, idempotent = true) {
   return {
     title,
@@ -188,9 +188,28 @@ function ingestAnnotations(title, openWorldHint) {
     openWorldHint
   };
 }
+var SERVER_INSTRUCTIONS = [
+  "Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.",
+  "",
+  "## Set up a knowledge base",
+  "- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.",
+  "- Find an existing one's public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don't already have it).",
+  "",
+  "## Ingest content",
+  "- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).",
+  "- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).",
+  "- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.",
+  "- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).",
+  "- All ingestion is append-only in this version \u2014 there's no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.",
+  "- Check on an ingest's progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.",
+  "",
+  "## Query a knowledge base",
+  "- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.",
+  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:"extractive" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.'
+].join("\n");
 function buildThorbitKnowledgeBaseMcpServer(options) {
   const callTool = (toolName, input) => options.callTool(toolName, input);
-  const server = new import_mcp.McpServer({ name: "thorbit-kb-mcp", version: VERSION });
+  const server = new import_mcp.McpServer({ name: "thorbit-kb-mcp", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
   server.registerResource(
     "knowledge-bases",
     "thorbit-kb://knowledge-bases",
@@ -226,55 +245,55 @@ function buildThorbitKnowledgeBaseMcpServer(options) {
   }
   registerTool("thorbit_kb_create", {
     title: "Create Thorbit Knowledge Base",
-    description: "Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.",
+    description: "Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you're not sure whether a suitable knowledge base already exists.",
     inputSchema: ThorbitKbCreateInputSchema,
     annotations: ingestAnnotations("Create Thorbit Knowledge Base", false)
   });
   registerTool("thorbit_kb_list", {
     title: "List Thorbit Knowledge Bases",
-    description: "List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.",
+    description: "List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don't already have the target knowledgeBasePublicId \u2014 every ingest tool needs one (search/ask can omit it to query all visible KBs instead).",
     inputSchema: ThorbitKbListInputSchema,
     annotations: readOnlyAnnotations("List Thorbit Knowledge Bases")
   });
   registerTool("thorbit_kb_source_status", {
     title: "Read Thorbit KB Source Status",
-    description: "Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.",
+    description: "Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool \u2014 the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.",
     inputSchema: ThorbitKbSourceStatusInputSchema,
     annotations: readOnlyAnnotations("Read Thorbit KB Source Status")
   });
   registerTool("thorbit_kb_ingest_url", {
     title: "Ingest URL Into Thorbit KB",
-    description: "Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.",
+    description: "Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one \u2014 there is no refresh mode in this version.",
     inputSchema: ThorbitKbIngestUrlInputSchema,
     annotations: ingestAnnotations("Ingest URL Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_site", {
     title: "Ingest Website Into Thorbit KB",
-    description: "Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.",
+    description: "Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url \u2014 cheaper and faster. Append-only, same as thorbit_kb_ingest_url.",
     inputSchema: ThorbitKbIngestSiteInputSchema,
     annotations: ingestAnnotations("Ingest Website Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_youtube", {
     title: "Ingest YouTube Into Thorbit KB",
-    description: "Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.",
+    description: "Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.",
     inputSchema: ThorbitKbIngestYoutubeInputSchema,
     annotations: ingestAnnotations("Ingest YouTube Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_text", {
     title: "Ingest Text Into Thorbit KB",
-    description: "Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.",
+    description: "Submit text or Markdown you already have directly into a knowledge base \u2014 no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.",
     inputSchema: ThorbitKbIngestTextInputSchema,
     annotations: ingestAnnotations("Ingest Text Into Thorbit KB", false)
   });
   registerTool("thorbit_kb_search", {
     title: "Search Thorbit Knowledge Base",
-    description: "Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.",
+    description: "Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.",
     inputSchema: ThorbitKbSearchInputSchema,
     annotations: readOnlyAnnotations("Search Thorbit Knowledge Base")
   });
   registerTool("thorbit_kb_ask", {
     title: "Ask Thorbit Knowledge Base",
-    description: "Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.",
+    description: 'Answer a question using ONLY retrieved knowledge-base context \u2014 returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:"extractive" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',
     inputSchema: ThorbitKbAskInputSchema,
     annotations: readOnlyAnnotations("Ask Thorbit Knowledge Base", false)
   });

package/dist/bin/thorbit-kb-mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-kb-mcp.ts","../../src/thorbit-kb-api-client.ts","../../src/thorbit-kb-mcp-env.ts","../../src/thorbit-kb-mcp-server.ts","../../src/thorbit-kb-mcp-response-formatters.ts","../../src/thorbit-kb-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitKnowledgeBaseApiClient } from '../src/thorbit-kb-api-client.js'\nimport { resolveThorbitKbMcpEnv } from '../src/thorbit-kb-mcp-env.js'\nimport { buildThorbitKnowledgeBaseMcpServer } from '../src/thorbit-kb-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitKbMcpEnv()\n  const client = new ThorbitKnowledgeBaseApiClient(env)\n  const server = buildThorbitKnowledgeBaseMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.7'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../bin/thorbit-kb-mcp.ts","../../src/thorbit-kb-api-client.ts","../../src/thorbit-kb-mcp-env.ts","../../src/thorbit-kb-mcp-server.ts","../../src/thorbit-kb-mcp-response-formatters.ts","../../src/thorbit-kb-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitKnowledgeBaseApiClient } from '../src/thorbit-kb-api-client.js'\nimport { resolveThorbitKbMcpEnv } from '../src/thorbit-kb-mcp-env.js'\nimport { buildThorbitKnowledgeBaseMcpServer } from '../src/thorbit-kb-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitKbMcpEnv()\n  const client = new ThorbitKnowledgeBaseApiClient(env)\n  const server = buildThorbitKnowledgeBaseMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.8'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport const SERVER_INSTRUCTIONS = [\n  'Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.',\n  '',\n  '## Set up a knowledge base',\n  '- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.',\n  '- Find an existing one\\'s public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don\\'t already have it).',\n  '',\n  '## Ingest content',\n  '- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).',\n  '- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).',\n  '- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.',\n  '- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).',\n  '- All ingestion is append-only in this version — there\\'s no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.',\n  '- Check on an ingest\\'s progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.',\n  '',\n  '## Query a knowledge base',\n  '- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.',\n  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:\"extractive\" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.',\n].join('\\n')\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION }, { instructions: SERVER_INSTRUCTIONS })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you\\'re not sure whether a suitable knowledge base already exists.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don\\'t already have the target knowledgeBasePublicId — every ingest tool needs one (search/ask can omit it to query all visible KBs instead).',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool — the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one — there is no refresh mode in this version.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url — cheaper and faster. Append-only, same as thorbit_kb_ingest_url.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit text or Markdown you already have directly into a knowledge base — no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using ONLY retrieved knowledge-base context — returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:\"extractive\" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n"],"mappings":"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","names":[]}

package/dist/bin/thorbit-kb-mcp.js

@@ -168,7 +168,7 @@ var ThorbitKbAskInputSchema = {
 };
 
 // src/thorbit-kb-mcp-server.ts
-var VERSION = "0.2.7";
+var VERSION = "0.2.8";
 function readOnlyAnnotations(title, idempotent = true) {
   return {
     title,
@@ -187,9 +187,28 @@ function ingestAnnotations(title, openWorldHint) {
     openWorldHint
   };
 }
+var SERVER_INSTRUCTIONS = [
+  "Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.",
+  "",
+  "## Set up a knowledge base",
+  "- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.",
+  "- Find an existing one's public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don't already have it).",
+  "",
+  "## Ingest content",
+  "- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).",
+  "- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).",
+  "- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.",
+  "- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).",
+  "- All ingestion is append-only in this version \u2014 there's no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.",
+  "- Check on an ingest's progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.",
+  "",
+  "## Query a knowledge base",
+  "- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.",
+  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:"extractive" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.'
+].join("\n");
 function buildThorbitKnowledgeBaseMcpServer(options) {
   const callTool = (toolName, input) => options.callTool(toolName, input);
-  const server = new McpServer({ name: "thorbit-kb-mcp", version: VERSION });
+  const server = new McpServer({ name: "thorbit-kb-mcp", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
   server.registerResource(
     "knowledge-bases",
     "thorbit-kb://knowledge-bases",
@@ -225,55 +244,55 @@ function buildThorbitKnowledgeBaseMcpServer(options) {
   }
   registerTool("thorbit_kb_create", {
     title: "Create Thorbit Knowledge Base",
-    description: "Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.",
+    description: "Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you're not sure whether a suitable knowledge base already exists.",
     inputSchema: ThorbitKbCreateInputSchema,
     annotations: ingestAnnotations("Create Thorbit Knowledge Base", false)
   });
   registerTool("thorbit_kb_list", {
     title: "List Thorbit Knowledge Bases",
-    description: "List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.",
+    description: "List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don't already have the target knowledgeBasePublicId \u2014 every ingest tool needs one (search/ask can omit it to query all visible KBs instead).",
     inputSchema: ThorbitKbListInputSchema,
     annotations: readOnlyAnnotations("List Thorbit Knowledge Bases")
   });
   registerTool("thorbit_kb_source_status", {
     title: "Read Thorbit KB Source Status",
-    description: "Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.",
+    description: "Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool \u2014 the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.",
     inputSchema: ThorbitKbSourceStatusInputSchema,
     annotations: readOnlyAnnotations("Read Thorbit KB Source Status")
   });
   registerTool("thorbit_kb_ingest_url", {
     title: "Ingest URL Into Thorbit KB",
-    description: "Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.",
+    description: "Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one \u2014 there is no refresh mode in this version.",
     inputSchema: ThorbitKbIngestUrlInputSchema,
     annotations: ingestAnnotations("Ingest URL Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_site", {
     title: "Ingest Website Into Thorbit KB",
-    description: "Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.",
+    description: "Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url \u2014 cheaper and faster. Append-only, same as thorbit_kb_ingest_url.",
     inputSchema: ThorbitKbIngestSiteInputSchema,
     annotations: ingestAnnotations("Ingest Website Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_youtube", {
     title: "Ingest YouTube Into Thorbit KB",
-    description: "Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.",
+    description: "Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.",
     inputSchema: ThorbitKbIngestYoutubeInputSchema,
     annotations: ingestAnnotations("Ingest YouTube Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_text", {
     title: "Ingest Text Into Thorbit KB",
-    description: "Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.",
+    description: "Submit text or Markdown you already have directly into a knowledge base \u2014 no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.",
     inputSchema: ThorbitKbIngestTextInputSchema,
     annotations: ingestAnnotations("Ingest Text Into Thorbit KB", false)
   });
   registerTool("thorbit_kb_search", {
     title: "Search Thorbit Knowledge Base",
-    description: "Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.",
+    description: "Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.",
     inputSchema: ThorbitKbSearchInputSchema,
     annotations: readOnlyAnnotations("Search Thorbit Knowledge Base")
   });
   registerTool("thorbit_kb_ask", {
     title: "Ask Thorbit Knowledge Base",
-    description: "Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.",
+    description: 'Answer a question using ONLY retrieved knowledge-base context \u2014 returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:"extractive" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',
     inputSchema: ThorbitKbAskInputSchema,
     annotations: readOnlyAnnotations("Ask Thorbit Knowledge Base", false)
   });

package/dist/bin/thorbit-kb-mcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-kb-mcp.ts","../../src/thorbit-kb-api-client.ts","../../src/thorbit-kb-mcp-env.ts","../../src/thorbit-kb-mcp-server.ts","../../src/thorbit-kb-mcp-response-formatters.ts","../../src/thorbit-kb-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitKnowledgeBaseApiClient } from '../src/thorbit-kb-api-client.js'\nimport { resolveThorbitKbMcpEnv } from '../src/thorbit-kb-mcp-env.js'\nimport { buildThorbitKnowledgeBaseMcpServer } from '../src/thorbit-kb-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitKbMcpEnv()\n  const client = new ThorbitKnowledgeBaseApiClient(env)\n  const server = buildThorbitKnowledgeBaseMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.7'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../bin/thorbit-kb-mcp.ts","../../src/thorbit-kb-api-client.ts","../../src/thorbit-kb-mcp-env.ts","../../src/thorbit-kb-mcp-server.ts","../../src/thorbit-kb-mcp-response-formatters.ts","../../src/thorbit-kb-mcp-tool-schemas.ts"],"sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ThorbitKnowledgeBaseApiClient } from '../src/thorbit-kb-api-client.js'\nimport { resolveThorbitKbMcpEnv } from '../src/thorbit-kb-mcp-env.js'\nimport { buildThorbitKnowledgeBaseMcpServer } from '../src/thorbit-kb-mcp-server.js'\n\nasync function main() {\n  const env = resolveThorbitKbMcpEnv()\n  const client = new ThorbitKnowledgeBaseApiClient(env)\n  const server = buildThorbitKnowledgeBaseMcpServer(client)\n  await server.connect(new StdioServerTransport())\n}\n\nmain().catch(error => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exit(1)\n})\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.8'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport const SERVER_INSTRUCTIONS = [\n  'Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.',\n  '',\n  '## Set up a knowledge base',\n  '- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.',\n  '- Find an existing one\\'s public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don\\'t already have it).',\n  '',\n  '## Ingest content',\n  '- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).',\n  '- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).',\n  '- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.',\n  '- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).',\n  '- All ingestion is append-only in this version — there\\'s no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.',\n  '- Check on an ingest\\'s progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.',\n  '',\n  '## Query a knowledge base',\n  '- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.',\n  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:\"extractive\" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.',\n].join('\\n')\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION }, { instructions: SERVER_INSTRUCTIONS })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you\\'re not sure whether a suitable knowledge base already exists.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don\\'t already have the target knowledgeBasePublicId — every ingest tool needs one (search/ask can omit it to query all visible KBs instead).',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool — the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one — there is no refresh mode in this version.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url — cheaper and faster. Append-only, same as thorbit_kb_ingest_url.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit text or Markdown you already have directly into a knowledge base — no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using ONLY retrieved knowledge-base context — returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:\"extractive\" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -186,7 +186,7 @@ var ThorbitKnowledgeBaseMcpToolInputSchemas = {
 };
 
 // src/thorbit-kb-mcp-server.ts
-var VERSION = "0.2.7";
+var VERSION = "0.2.8";
 function readOnlyAnnotations(title, idempotent = true) {
   return {
     title,
@@ -205,9 +205,28 @@ function ingestAnnotations(title, openWorldHint) {
     openWorldHint
   };
 }
+var SERVER_INSTRUCTIONS = [
+  "Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.",
+  "",
+  "## Set up a knowledge base",
+  "- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.",
+  "- Find an existing one's public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don't already have it).",
+  "",
+  "## Ingest content",
+  "- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).",
+  "- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).",
+  "- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.",
+  "- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).",
+  "- All ingestion is append-only in this version \u2014 there's no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.",
+  "- Check on an ingest's progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.",
+  "",
+  "## Query a knowledge base",
+  "- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.",
+  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:"extractive" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.'
+].join("\n");
 function buildThorbitKnowledgeBaseMcpServer(options) {
   const callTool = (toolName, input) => options.callTool(toolName, input);
-  const server = new import_mcp.McpServer({ name: "thorbit-kb-mcp", version: VERSION });
+  const server = new import_mcp.McpServer({ name: "thorbit-kb-mcp", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
   server.registerResource(
     "knowledge-bases",
     "thorbit-kb://knowledge-bases",
@@ -243,55 +262,55 @@ function buildThorbitKnowledgeBaseMcpServer(options) {
   }
   registerTool("thorbit_kb_create", {
     title: "Create Thorbit Knowledge Base",
-    description: "Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.",
+    description: "Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you're not sure whether a suitable knowledge base already exists.",
     inputSchema: ThorbitKbCreateInputSchema,
     annotations: ingestAnnotations("Create Thorbit Knowledge Base", false)
   });
   registerTool("thorbit_kb_list", {
     title: "List Thorbit Knowledge Bases",
-    description: "List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.",
+    description: "List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don't already have the target knowledgeBasePublicId \u2014 every ingest tool needs one (search/ask can omit it to query all visible KBs instead).",
     inputSchema: ThorbitKbListInputSchema,
     annotations: readOnlyAnnotations("List Thorbit Knowledge Bases")
   });
   registerTool("thorbit_kb_source_status", {
     title: "Read Thorbit KB Source Status",
-    description: "Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.",
+    description: "Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool \u2014 the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.",
     inputSchema: ThorbitKbSourceStatusInputSchema,
     annotations: readOnlyAnnotations("Read Thorbit KB Source Status")
   });
   registerTool("thorbit_kb_ingest_url", {
     title: "Ingest URL Into Thorbit KB",
-    description: "Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.",
+    description: "Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one \u2014 there is no refresh mode in this version.",
     inputSchema: ThorbitKbIngestUrlInputSchema,
     annotations: ingestAnnotations("Ingest URL Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_site", {
     title: "Ingest Website Into Thorbit KB",
-    description: "Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.",
+    description: "Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url \u2014 cheaper and faster. Append-only, same as thorbit_kb_ingest_url.",
     inputSchema: ThorbitKbIngestSiteInputSchema,
     annotations: ingestAnnotations("Ingest Website Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_youtube", {
     title: "Ingest YouTube Into Thorbit KB",
-    description: "Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.",
+    description: "Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.",
     inputSchema: ThorbitKbIngestYoutubeInputSchema,
     annotations: ingestAnnotations("Ingest YouTube Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_text", {
     title: "Ingest Text Into Thorbit KB",
-    description: "Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.",
+    description: "Submit text or Markdown you already have directly into a knowledge base \u2014 no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.",
     inputSchema: ThorbitKbIngestTextInputSchema,
     annotations: ingestAnnotations("Ingest Text Into Thorbit KB", false)
   });
   registerTool("thorbit_kb_search", {
     title: "Search Thorbit Knowledge Base",
-    description: "Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.",
+    description: "Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.",
     inputSchema: ThorbitKbSearchInputSchema,
     annotations: readOnlyAnnotations("Search Thorbit Knowledge Base")
   });
   registerTool("thorbit_kb_ask", {
     title: "Ask Thorbit Knowledge Base",
-    description: "Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.",
+    description: 'Answer a question using ONLY retrieved knowledge-base context \u2014 returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:"extractive" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',
     inputSchema: ThorbitKbAskInputSchema,
     annotations: readOnlyAnnotations("Ask Thorbit Knowledge Base", false)
   });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/thorbit-kb-api-client.ts","../src/thorbit-kb-mcp-server.ts","../src/thorbit-kb-mcp-response-formatters.ts","../src/thorbit-kb-mcp-tool-schemas.ts","../src/thorbit-kb-mcp-env.ts","../src/thorbit-kb-mcp-tool-names.ts"],"sourcesContent":["export { ThorbitKnowledgeBaseApiClient } from './thorbit-kb-api-client.js'\nexport { buildThorbitKnowledgeBaseMcpServer } from './thorbit-kb-mcp-server.js'\nexport { resolveThorbitKbMcpEnv } from './thorbit-kb-mcp-env.js'\nexport * from './thorbit-kb-mcp-tool-names.js'\nexport * from './thorbit-kb-mcp-tool-schemas.js'\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.7'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitKnowledgeBaseMcpToolNames = [\n  'thorbit_kb_create',\n  'thorbit_kb_list',\n  'thorbit_kb_source_status',\n  'thorbit_kb_ingest_url',\n  'thorbit_kb_ingest_site',\n  'thorbit_kb_ingest_youtube',\n  'thorbit_kb_ingest_text',\n  'thorbit_kb_search',\n  'thorbit_kb_ask',\n] as const\n\nexport type ThorbitKnowledgeBaseMcpToolName = typeof ThorbitKnowledgeBaseMcpToolNames[number]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoBO,IAAM,gCAAN,MAAoC;AAAA,EACxB;AAAA,EACA;AAAA,EAEjB,YAAY,SAA8C;AACxD,SAAK,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AAChD,SAAK,SAAS,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,SAAS,UAA2C,OAA0D;AAClH,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,8BAA8B,QAAQ,IAAI;AAAA,MACpF,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,qBAAqB,KAAK;AAAA,QAC1B,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC;AAAA,IAClC,CAAC;AAED,UAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,IAAI;AACnD,QAAI,QAAQ,OAAO,SAAS,YAAY,QAAQ,KAAM,QAAO;AAE7D,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,OAAO;AAAA,QACL,MAAM,SAAS,KAAK,qBAAqB,QAAQ,SAAS,MAAM;AAAA,QAChE,SAAS,SAAS,KAAK,6CAA6C,wCAAwC,SAAS,MAAM;AAAA,MAC7H;AAAA,IACF;AAAA,EACF;AACF;;;ACnDA,iBAA4C;;;ACI5C,SAAS,gBAAgB,UAA2C,QAAyB;AAC3F,MAAI,aAAa,uBAAuB,UAAU,OAAO,WAAW,YAAY,mBAAmB,QAAQ;AACzG,UAAM,KAAK,OAAO;AAClB,WAAO,kCAAkC,OAAO,GAAG,QAAQ,GAAG,YAAY,EAAE,CAAC;AAAA,EAC/E;AACA,MAAI,aAAa,qBAAqB,UAAU,OAAO,WAAW,YAAY,oBAAoB,QAAQ;AACxG,UAAM,QAAQ,MAAM,QAAQ,OAAO,cAAc,IAAI,OAAO,eAAe,SAAS;AACpF,WAAO,SAAS,KAAK,0BAA0B,UAAU,IAAI,KAAK,GAAG;AAAA,EACvE;AACA,MAAI,SAAS,WAAW,mBAAmB,EAAG,QAAO;AACrD,MAAI,aAAa,2BAA4B,QAAO;AACpD,MAAI,aAAa,oBAAqB,QAAO;AAC7C,MAAI,aAAa,iBAAkB,QAAO;AAC1C,SAAO;AACT;AAEO,SAAS,6BACd,UACA,UACgB;AAChB,MAAI,CAAC,SAAS,IAAI;AAChB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,SAAS,CAAC;AAAA,QACR,MAAM;AAAA,QACN,MAAM,GAAG,SAAS,MAAM,IAAI,KAAK,SAAS,MAAM,OAAO;AAAA,MACzD,CAAC;AAAA,MACD,mBAAmB;AAAA,IACrB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,MACR,MAAM;AAAA,MACN,MAAM,gBAAgB,UAAU,SAAS,MAAM;AAAA,IACjD,CAAC;AAAA,IACD,mBAAmB,SAAS;AAAA,EAC9B;AACF;;;AC1CA,iBAAkB;AAElB,IAAM,iBAAiB,aAAE,OAAO,aAAE,OAAO,GAAG,aAAE,QAAQ,CAAC;AAEhD,IAAM,6BAA6B;AAAA,EACxC,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,0CAA0C;AAAA,EACpF,aAAa,aAAE,OAAO,EAAE,IAAI,GAAI,EAAE,SAAS,EAAE,SAAS,kDAAkD;AAAA,EACxG,iBAAiB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EACxI,QAAQ,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,8DAA8D;AACvH;AAEO,IAAM,2BAA2B;AAAA,EACtC,iBAAiB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,2EAA2E;AAAA,EAClI,eAAe,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,yDAAyD;AAAA,EAC3G,OAAO,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,oCAAoC;AACnG;AAEO,IAAM,mCAAmC;AAAA,EAC9C,iBAAiB,aAAE,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,2DAA2D;AAClI;AAEO,IAAM,gCAAgC;AAAA,EAC3C,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0CAA0C;AAAA,EAC5F,KAAK,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,oEAAoE;AAAA,EACnG,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,+DAA+D;AAAA,EACrH,MAAM,aAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,QAAQ,EAAE,SAAS,+EAA+E;AAAA,EACnI,eAAe,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAM,EAAE,SAAS,EAAE,SAAS,6CAA6C;AAAA,EACtH,UAAU,eAAe,SAAS,EAAE,SAAS,4CAA4C;AAC3F;AAEO,IAAM,iCAAiC;AAAA,EAC5C,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0CAA0C;AAAA,EAC5F,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,wFAAwF;AAAA,EAC5H,iBAAiB,aAAE,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,oEAAoE;AAAA,EAC5I,iBAAiB,aAAE,MAAM,aAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,+DAA+D;AAAA,EACvI,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,oDAAoD;AAAA,EACpH,MAAM,aAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,QAAQ,EAAE,SAAS,0EAA0E;AAAA,EAC9H,UAAU,eAAe,SAAS,EAAE,SAAS,6CAA6C;AAC5F;AAEO,IAAM,oCAAoC;AAAA,EAC/C,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0CAA0C;AAAA,EAC5F,UAAU,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,8FAA8F;AAAA,EAClI,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EAChF,MAAM,aAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,QAAQ,EAAE,SAAS,8BAA8B;AAAA,EAClF,oBAAoB,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,sEAAsE;AAAA,EAC7H,UAAU,eAAe,SAAS,EAAE,SAAS,4CAA4C;AAC3F;AAEO,IAAM,iCAAiC;AAAA,EAC5C,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0CAA0C;AAAA,EAC5F,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,qCAAqC;AAAA,EAChF,SAAS,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAM,EAAE,SAAS,+CAA+C;AAAA,EAC/F,WAAW,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,8CAA8C;AAAA,EAC9F,YAAY,aAAE,KAAK,CAAC,UAAU,QAAQ,UAAU,CAAC,EAAE,QAAQ,QAAQ,EAAE,SAAS,kFAAkF;AAAA,EAChK,UAAU,eAAe,SAAS,EAAE,SAAS,4CAA4C;AAC3F;AAEO,IAAM,6BAA6B;AAAA,EACxC,OAAO,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,mEAAmE;AAAA,EAC/G,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EAC9G,iBAAiB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACxG,OAAO,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtF,iBAAiB,aAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,SAAS,qCAAqC;AAAA,EAC1F,YAAY,aAAE,KAAK,CAAC,SAAS,QAAQ,CAAC,EAAE,QAAQ,OAAO,EAAE,SAAS,uEAAuE;AAC3I;AAEO,IAAM,0BAA0B;AAAA,EACrC,UAAU,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAI,EAAE,SAAS,mDAAmD;AAAA,EAClG,uBAAuB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,sDAAsD;AAAA,EACnH,iBAAiB,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,iDAAiD;AAAA,EACxG,aAAa,aAAE,KAAK,CAAC,WAAW,YAAY,YAAY,CAAC,EAAE,QAAQ,SAAS,EAAE,SAAS,iEAAiE;AAAA,EACxJ,OAAO,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,SAAS,+CAA+C;AAAA,EAC1G,kBAAkB,aAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,sDAAsD;AAC7G;AAEO,IAAM,0CAA0C;AAAA,EACrD,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,wBAAwB;AAAA,EACxB,mBAAmB;AAAA,EACnB,gBAAgB;AAClB;;;AFpEA,IAAM,UAAU;AAShB,SAAS,oBAAoB,OAAe,aAAa,MAAM;AAC7D,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB,eAAe;AAAA,EACjB;AACF;AAEA,SAAS,kBAAkB,OAAe,eAAwB;AAChE,SAAO;AAAA,IACL;AAAA,IACA,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,IAChB;AAAA,EACF;AACF;AAWO,SAAS,mCAAmC,SAA+D;AAChH,QAAM,WAA8B,CAAC,UAAU,UAAU,QAAQ,SAAS,UAAU,KAAK;AACzF,QAAM,SAAS,IAAI,qBAAU,EAAE,MAAM,kBAAkB,SAAS,QAAQ,CAAC;AAEzE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,QAAQ;AACb,YAAM,WAAW,MAAM,SAAS,mBAAmB,CAAC,CAAC;AACrD,aAAO,EAAE,UAAU,CAAC,EAAE,KAAK,IAAI,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,IAChH;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,IAAI,4BAAiB,yCAAyC,EAAE,MAAM,OAAU,CAAC;AAAA,IACjF;AAAA,MACE,OAAO;AAAA,MACP,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,KAAK,cAAc;AACxB,YAAM,iBAAiB,MAAM,QAAQ,UAAU,cAAc,IAAI,UAAU,eAAe,CAAC,IAAI,UAAU;AACzG,YAAM,WAAW,MAAM,SAAS,4BAA4B,EAAE,iBAAiB,CAAC,OAAO,cAAc,CAAC,EAAE,CAAC;AACzG,aAAO,EAAE,UAAU,CAAC,EAAE,KAAK,IAAI,MAAM,UAAU,oBAAoB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC,EAAE;AAAA,IAChH;AAAA,EACF;AAEA,WAAS,aACP,UACA,QACM;AACN,WAAO,aAAa,UAAU,QAAQ,OAAO,UAAU;AACrD,YAAM,WAAW,MAAM,SAAS,UAAU,KAAK;AAC/C,aAAO,6BAA6B,UAAU,QAAQ;AAAA,IACxD,CAAC;AAAA,EACH;AAEA,eAAa,qBAAqB;AAAA,IAChC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,kBAAkB,iCAAiC,KAAK;AAAA,EACvE,CAAC;AAED,eAAa,mBAAmB;AAAA,IAC9B,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,8BAA8B;AAAA,EACjE,CAAC;AAED,eAAa,4BAA4B;AAAA,IACvC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,+BAA+B;AAAA,EAClE,CAAC;AAED,eAAa,yBAAyB;AAAA,IACpC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,kBAAkB,8BAA8B,IAAI;AAAA,EACnE,CAAC;AAED,eAAa,0BAA0B;AAAA,IACrC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,kBAAkB,kCAAkC,IAAI;AAAA,EACvE,CAAC;AAED,eAAa,6BAA6B;AAAA,IACxC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,kBAAkB,kCAAkC,IAAI;AAAA,EACvE,CAAC;AAED,eAAa,0BAA0B;AAAA,IACrC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,kBAAkB,+BAA+B,KAAK;AAAA,EACrE,CAAC;AAED,eAAa,qBAAqB;AAAA,IAChC,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,+BAA+B;AAAA,EAClE,CAAC;AAED,eAAa,kBAAkB;AAAA,IAC7B,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,IACb,aAAa,oBAAoB,8BAA8B,KAAK;AAAA,EACtE,CAAC;AAED,SAAO;AACT;;;AGnKA,qBAA6B;AAC7B,qBAAwB;AACxB,uBAAqB;AAOrB,SAAS,iBAAqC;AAC5C,QAAM,eAAe,QAAQ,IAAI,yBAAyB,KAAK;AAC/D,QAAM,QAAQ,CAAC,kBAAc,2BAAK,wBAAQ,GAAG,qBAAqB,CAAC,EAAE,OAAO,OAAO;AACnF,aAAW,QAAQ,OAAO;AACxB,QAAI;AACF,YAAM,YAAQ,6BAAa,MAAM,MAAM,EAAE,KAAK;AAC9C,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,yBAA0C;AACxD,QAAM,UACJ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,uBACZ,QAAQ,IAAI,0BACZ,eAAe,IACd,KAAK;AAER,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,2BAA2B,sBAAsB,KAAK;AAAA,EAC9G;AACF;;;ACvCO,IAAM,mCAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/thorbit-kb-api-client.ts","../src/thorbit-kb-mcp-server.ts","../src/thorbit-kb-mcp-response-formatters.ts","../src/thorbit-kb-mcp-tool-schemas.ts","../src/thorbit-kb-mcp-env.ts","../src/thorbit-kb-mcp-tool-names.ts"],"sourcesContent":["export { ThorbitKnowledgeBaseApiClient } from './thorbit-kb-api-client.js'\nexport { buildThorbitKnowledgeBaseMcpServer } from './thorbit-kb-mcp-server.js'\nexport { resolveThorbitKbMcpEnv } from './thorbit-kb-mcp-env.js'\nexport * from './thorbit-kb-mcp-tool-names.js'\nexport * from './thorbit-kb-mcp-tool-schemas.js'\n","import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.8'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport const SERVER_INSTRUCTIONS = [\n  'Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.',\n  '',\n  '## Set up a knowledge base',\n  '- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.',\n  '- Find an existing one\\'s public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don\\'t already have it).',\n  '',\n  '## Ingest content',\n  '- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).',\n  '- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).',\n  '- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.',\n  '- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).',\n  '- All ingestion is append-only in this version — there\\'s no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.',\n  '- Check on an ingest\\'s progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.',\n  '',\n  '## Query a knowledge base',\n  '- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.',\n  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:\"extractive\" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.',\n].join('\\n')\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION }, { instructions: SERVER_INSTRUCTIONS })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you\\'re not sure whether a suitable knowledge base already exists.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don\\'t already have the target knowledgeBasePublicId — every ingest tool needs one (search/ask can omit it to query all visible KBs instead).',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool — the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one — there is no refresh mode in this version.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url — cheaper and faster. Append-only, same as thorbit_kb_ingest_url.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit text or Markdown you already have directly into a knowledge base — no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using ONLY retrieved knowledge-base context — returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:\"extractive\" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitKnowledgeBaseMcpToolNames = [\n  'thorbit_kb_create',\n  'thorbit_kb_list',\n  'thorbit_kb_source_status',\n  'thorbit_kb_ingest_url',\n  'thorbit_kb_ingest_site',\n  'thorbit_kb_ingest_youtube',\n  'thorbit_kb_ingest_text',\n  'thorbit_kb_search',\n  'thorbit_kb_ask',\n] as const\n\nexport type ThorbitKnowledgeBaseMcpToolName = typeof ThorbitKnowledgeBaseMcpToolNames[number]\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -148,7 +148,7 @@ var ThorbitKnowledgeBaseMcpToolInputSchemas = {
 };
 
 // src/thorbit-kb-mcp-server.ts
-var VERSION = "0.2.7";
+var VERSION = "0.2.8";
 function readOnlyAnnotations(title, idempotent = true) {
   return {
     title,
@@ -167,9 +167,28 @@ function ingestAnnotations(title, openWorldHint) {
     openWorldHint
   };
 }
+var SERVER_INSTRUCTIONS = [
+  "Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.",
+  "",
+  "## Set up a knowledge base",
+  "- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.",
+  "- Find an existing one's public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don't already have it).",
+  "",
+  "## Ingest content",
+  "- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).",
+  "- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).",
+  "- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.",
+  "- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).",
+  "- All ingestion is append-only in this version \u2014 there's no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.",
+  "- Check on an ingest's progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.",
+  "",
+  "## Query a knowledge base",
+  "- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.",
+  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:"extractive" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.'
+].join("\n");
 function buildThorbitKnowledgeBaseMcpServer(options) {
   const callTool = (toolName, input) => options.callTool(toolName, input);
-  const server = new McpServer({ name: "thorbit-kb-mcp", version: VERSION });
+  const server = new McpServer({ name: "thorbit-kb-mcp", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
   server.registerResource(
     "knowledge-bases",
     "thorbit-kb://knowledge-bases",
@@ -205,55 +224,55 @@ function buildThorbitKnowledgeBaseMcpServer(options) {
   }
   registerTool("thorbit_kb_create", {
     title: "Create Thorbit Knowledge Base",
-    description: "Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.",
+    description: "Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you're not sure whether a suitable knowledge base already exists.",
     inputSchema: ThorbitKbCreateInputSchema,
     annotations: ingestAnnotations("Create Thorbit Knowledge Base", false)
   });
   registerTool("thorbit_kb_list", {
     title: "List Thorbit Knowledge Bases",
-    description: "List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.",
+    description: "List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don't already have the target knowledgeBasePublicId \u2014 every ingest tool needs one (search/ask can omit it to query all visible KBs instead).",
     inputSchema: ThorbitKbListInputSchema,
     annotations: readOnlyAnnotations("List Thorbit Knowledge Bases")
   });
   registerTool("thorbit_kb_source_status", {
     title: "Read Thorbit KB Source Status",
-    description: "Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.",
+    description: "Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool \u2014 the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.",
     inputSchema: ThorbitKbSourceStatusInputSchema,
     annotations: readOnlyAnnotations("Read Thorbit KB Source Status")
   });
   registerTool("thorbit_kb_ingest_url", {
     title: "Ingest URL Into Thorbit KB",
-    description: "Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.",
+    description: "Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one \u2014 there is no refresh mode in this version.",
     inputSchema: ThorbitKbIngestUrlInputSchema,
     annotations: ingestAnnotations("Ingest URL Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_site", {
     title: "Ingest Website Into Thorbit KB",
-    description: "Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.",
+    description: "Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url \u2014 cheaper and faster. Append-only, same as thorbit_kb_ingest_url.",
     inputSchema: ThorbitKbIngestSiteInputSchema,
     annotations: ingestAnnotations("Ingest Website Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_youtube", {
     title: "Ingest YouTube Into Thorbit KB",
-    description: "Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.",
+    description: "Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.",
     inputSchema: ThorbitKbIngestYoutubeInputSchema,
     annotations: ingestAnnotations("Ingest YouTube Into Thorbit KB", true)
   });
   registerTool("thorbit_kb_ingest_text", {
     title: "Ingest Text Into Thorbit KB",
-    description: "Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.",
+    description: "Submit text or Markdown you already have directly into a knowledge base \u2014 no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.",
     inputSchema: ThorbitKbIngestTextInputSchema,
     annotations: ingestAnnotations("Ingest Text Into Thorbit KB", false)
   });
   registerTool("thorbit_kb_search", {
     title: "Search Thorbit Knowledge Base",
-    description: "Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.",
+    description: "Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.",
     inputSchema: ThorbitKbSearchInputSchema,
     annotations: readOnlyAnnotations("Search Thorbit Knowledge Base")
   });
   registerTool("thorbit_kb_ask", {
     title: "Ask Thorbit Knowledge Base",
-    description: "Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.",
+    description: 'Answer a question using ONLY retrieved knowledge-base context \u2014 returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:"extractive" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',
     inputSchema: ThorbitKbAskInputSchema,
     annotations: readOnlyAnnotations("Ask Thorbit Knowledge Base", false)
   });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/thorbit-kb-api-client.ts","../src/thorbit-kb-mcp-server.ts","../src/thorbit-kb-mcp-response-formatters.ts","../src/thorbit-kb-mcp-tool-schemas.ts","../src/thorbit-kb-mcp-env.ts","../src/thorbit-kb-mcp-tool-names.ts"],"sourcesContent":["import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.7'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new Thorbit vector-backed knowledge base for MCP ingestion, smart RAG search, citations, and entity extraction.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List Thorbit knowledge bases visible to this API key. Use before ingestion/search when the target KB public ID is unknown.',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by Thorbit KB ingestion tools.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract one public URL through MCP Scraper, clean the content, submit it to Thorbit, and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages, submit each page to Thorbit, and vectorize them into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper, preserve timestamp chunks when available, and vectorize the transcript into Thorbit KB.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit provided text or Markdown directly to Thorbit and vectorize it into the selected knowledge base.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search Thorbit KB content with citation-ready chunks. Use when the user needs source-backed snippets or evidence.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using only retrieved Thorbit KB context. Returns answer, citations, sufficiency, and retrieval strategy metadata.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitKnowledgeBaseMcpToolNames = [\n  'thorbit_kb_create',\n  'thorbit_kb_list',\n  'thorbit_kb_source_status',\n  'thorbit_kb_ingest_url',\n  'thorbit_kb_ingest_site',\n  'thorbit_kb_ingest_youtube',\n  'thorbit_kb_ingest_text',\n  'thorbit_kb_search',\n  'thorbit_kb_ask',\n] as const\n\nexport type ThorbitKnowledgeBaseMcpToolName = typeof ThorbitKnowledgeBaseMcpToolNames[number]\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/thorbit-kb-api-client.ts","../src/thorbit-kb-mcp-server.ts","../src/thorbit-kb-mcp-response-formatters.ts","../src/thorbit-kb-mcp-tool-schemas.ts","../src/thorbit-kb-mcp-env.ts","../src/thorbit-kb-mcp-tool-names.ts"],"sourcesContent":["import type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nexport type ThorbitKnowledgeBaseMcpEnvelope =\n  | {\n      ok: true\n      result: unknown\n      warnings?: string[]\n      requestId: string\n      usage?: Record<string, unknown>\n    }\n  | {\n      ok: false\n      error: {\n        code: string\n        message: string\n        details?: unknown\n      }\n      requestId: string\n    }\n\nexport class ThorbitKnowledgeBaseApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n\n  constructor(options: { baseUrl: string; apiKey: string }) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '')\n    this.apiKey = options.apiKey\n  }\n\n  async callTool(toolName: ThorbitKnowledgeBaseMcpToolName, input: unknown): Promise<ThorbitKnowledgeBaseMcpEnvelope> {\n    const response = await fetch(`${this.baseUrl}/api/v1/mcp/knowledge-base/${toolName}`, {\n      method: 'POST',\n      headers: {\n        'x-thorbit-api-key': this.apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(input ?? {}),\n    })\n\n    const body = await response.json().catch(() => null) as ThorbitKnowledgeBaseMcpEnvelope | null\n    if (body && typeof body === 'object' && 'ok' in body) return body\n\n    return {\n      ok: false,\n      requestId: 'unavailable',\n      error: {\n        code: response.ok ? 'invalid_response' : `http_${response.status}`,\n        message: response.ok ? 'Thorbit returned an invalid MCP response' : `Thorbit API request failed with HTTP ${response.status}`,\n      },\n    }\n  }\n}\n","import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js'\nimport type { ZodRawShape } from 'zod'\nimport type { ThorbitKnowledgeBaseApiClient, ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport { formatThorbitKbMcpToolResult } from './thorbit-kb-mcp-response-formatters.js'\nimport {\n  ThorbitKbAskInputSchema,\n  ThorbitKbCreateInputSchema,\n  ThorbitKbIngestSiteInputSchema,\n  ThorbitKbIngestTextInputSchema,\n  ThorbitKbIngestUrlInputSchema,\n  ThorbitKbIngestYoutubeInputSchema,\n  ThorbitKbListInputSchema,\n  ThorbitKbSearchInputSchema,\n  ThorbitKbSourceStatusInputSchema,\n} from './thorbit-kb-mcp-tool-schemas.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nconst VERSION = '0.2.8'\n\ntype ThorbitKbToolConfig<InputArgs extends ZodRawShape> = {\n  title: string\n  description: string\n  inputSchema: InputArgs\n  annotations: ToolAnnotations\n}\n\nfunction readOnlyAnnotations(title: string, idempotent = true) {\n  return {\n    title,\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: idempotent,\n    openWorldHint: false,\n  }\n}\n\nfunction ingestAnnotations(title: string, openWorldHint: boolean) {\n  return {\n    title,\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    openWorldHint,\n  }\n}\n\nexport const SERVER_INSTRUCTIONS = [\n  'Thorbit Knowledge Base MCP. Vector-backed knowledge bases for ingestion, smart RAG search, and grounded Q&A with citations. This server is a thin client, authenticated and metered against your Thorbit MCP API key.',\n  '',\n  '## Set up a knowledge base',\n  '- New knowledge base -> **thorbit_kb_create**. Org-level by default; pass projectPublicId to scope it to one project.',\n  '- Find an existing one\\'s public ID -> **thorbit_kb_list** (needed before ingesting/searching if you don\\'t already have it).',\n  '',\n  '## Ingest content',\n  '- One web page -> **thorbit_kb_ingest_url** (MCP Scraper extract, up to 500,000 chars before chunking).',\n  '- A whole site (mapped + filtered by include/excludePatterns) -> **thorbit_kb_ingest_site** (up to 100 pages, default 25).',\n  '- A YouTube video (transcribed, timestamps preserved by default) -> **thorbit_kb_ingest_youtube**.',\n  '- Raw text/Markdown you already have -> **thorbit_kb_ingest_text** (no scraping needed).',\n  '- All ingestion is append-only in this version — there\\'s no refresh/re-ingest mode; re-ingesting a URL adds a new source version rather than replacing the old one.',\n  '- Check on an ingest\\'s progress -> **thorbit_kb_source_status** with the sourcePublicIds it returned.',\n  '',\n  '## Query a knowledge base',\n  '- Need citation-ready chunks yourself, not a synthesized answer -> **thorbit_kb_search**.',\n  '- Need a direct answer grounded in retrieved context -> **thorbit_kb_ask** (set answerStyle:\"extractive\" for source excerpts without an LLM-written answer). Use thorbit_kb_search instead when you want the raw chunks to reason over yourself.',\n].join('\\n')\n\nexport type ThorbitKbCallTool = (\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  input: unknown,\n) => Promise<ThorbitKnowledgeBaseMcpEnvelope>\n\nexport type BuildThorbitKnowledgeBaseMcpServerOptions =\n  | ThorbitKnowledgeBaseApiClient\n  | { callTool: ThorbitKbCallTool }\n\nexport function buildThorbitKnowledgeBaseMcpServer(options: BuildThorbitKnowledgeBaseMcpServerOptions): McpServer {\n  const callTool: ThorbitKbCallTool = (toolName, input) => options.callTool(toolName, input)\n  const server = new McpServer({ name: 'thorbit-kb-mcp', version: VERSION }, { instructions: SERVER_INSTRUCTIONS })\n\n  server.registerResource(\n    'knowledge-bases',\n    'thorbit-kb://knowledge-bases',\n    {\n      title: 'Thorbit Knowledge Bases',\n      description: 'Knowledge bases visible to this Thorbit MCP API key.',\n      mimeType: 'application/json',\n    },\n    async (uri) => {\n      const envelope = await callTool('thorbit_kb_list', {})\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  server.registerResource(\n    'source-status',\n    new ResourceTemplate('thorbit-kb://sources/{sourcePublicId}', { list: undefined }),\n    {\n      title: 'Thorbit KB Source Status',\n      description: 'Status and metadata for one Thorbit knowledge-base source.',\n      mimeType: 'application/json',\n    },\n    async (uri, variables) => {\n      const sourcePublicId = Array.isArray(variables.sourcePublicId) ? variables.sourcePublicId[0] : variables.sourcePublicId\n      const envelope = await callTool('thorbit_kb_source_status', { sourcePublicIds: [String(sourcePublicId)] })\n      return { contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(envelope, null, 2) }] }\n    },\n  )\n\n  function registerTool<T extends ThorbitKnowledgeBaseMcpToolName>(\n    toolName: T,\n    config: ThorbitKbToolConfig<ZodRawShape>,\n  ): void {\n    server.registerTool(toolName, config, async (input) => {\n      const envelope = await callTool(toolName, input)\n      return formatThorbitKbMcpToolResult(toolName, envelope)\n    })\n  }\n\n  registerTool('thorbit_kb_create', {\n    title: 'Create Thorbit Knowledge Base',\n    description: 'Create a new vector-backed knowledge base for ingestion, RAG search, and grounded Q&A. Org-level by default; pass projectPublicId to scope it to one project. Use thorbit_kb_list first if you\\'re not sure whether a suitable knowledge base already exists.',\n    inputSchema: ThorbitKbCreateInputSchema,\n    annotations: ingestAnnotations('Create Thorbit Knowledge Base', false),\n  })\n\n  registerTool('thorbit_kb_list', {\n    title: 'List Thorbit Knowledge Bases',\n    description: 'List knowledge bases visible to this API key, org-level and project-scoped. Use before ingestion/search when you don\\'t already have the target knowledgeBasePublicId — every ingest tool needs one (search/ask can omit it to query all visible KBs instead).',\n    inputSchema: ThorbitKbListInputSchema,\n    annotations: readOnlyAnnotations('List Thorbit Knowledge Bases'),\n  })\n\n  registerTool('thorbit_kb_source_status', {\n    title: 'Read Thorbit KB Source Status',\n    description: 'Poll ingestion status for source public IDs returned by any thorbit_kb_ingest_* tool — the only way to check whether an ingest finished, since the ingest tools may return before vectorization completes.',\n    inputSchema: ThorbitKbSourceStatusInputSchema,\n    annotations: readOnlyAnnotations('Read Thorbit KB Source Status'),\n  })\n\n  registerTool('thorbit_kb_ingest_url', {\n    title: 'Ingest URL Into Thorbit KB',\n    description: 'Extract ONE public URL through MCP Scraper, clean it, and vectorize it into a knowledge base (up to 500,000 chars before chunking). For a whole site instead of one page, use thorbit_kb_ingest_site. Append-only: re-ingesting the same URL adds a new source version rather than replacing the prior one — there is no refresh mode in this version.',\n    inputSchema: ThorbitKbIngestUrlInputSchema,\n    annotations: ingestAnnotations('Ingest URL Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_site', {\n    title: 'Ingest Website Into Thorbit KB',\n    description: 'Map a website through MCP Scraper, extract selected pages (up to 100, default 25, filterable via includePatterns/excludePatterns), and vectorize each into a knowledge base. For a single known page instead of crawling a site, use thorbit_kb_ingest_url — cheaper and faster. Append-only, same as thorbit_kb_ingest_url.',\n    inputSchema: ThorbitKbIngestSiteInputSchema,\n    annotations: ingestAnnotations('Ingest Website Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_youtube', {\n    title: 'Ingest YouTube Into Thorbit KB',\n    description: 'Transcribe a YouTube video through MCP Scraper and vectorize the transcript (timestamp chunks preserved by default) into a knowledge base. For web pages or raw text instead of video, use thorbit_kb_ingest_url or thorbit_kb_ingest_text.',\n    inputSchema: ThorbitKbIngestYoutubeInputSchema,\n    annotations: ingestAnnotations('Ingest YouTube Into Thorbit KB', true),\n  })\n\n  registerTool('thorbit_kb_ingest_text', {\n    title: 'Ingest Text Into Thorbit KB',\n    description: 'Submit text or Markdown you already have directly into a knowledge base — no scraping involved. Use this instead of thorbit_kb_ingest_url when you already have the content in hand rather than a URL to fetch.',\n    inputSchema: ThorbitKbIngestTextInputSchema,\n    annotations: ingestAnnotations('Ingest Text Into Thorbit KB', false),\n  })\n\n  registerTool('thorbit_kb_search', {\n    title: 'Search Thorbit Knowledge Base',\n    description: 'Search knowledge-base content and get citation-ready chunks back directly, without a synthesized answer. Use this instead of thorbit_kb_ask when you want to reason over the raw retrieved passages yourself. Omit knowledgeBasePublicId to search all KBs visible to this key.',\n    inputSchema: ThorbitKbSearchInputSchema,\n    annotations: readOnlyAnnotations('Search Thorbit Knowledge Base'),\n  })\n\n  registerTool('thorbit_kb_ask', {\n    title: 'Ask Thorbit Knowledge Base',\n    description: 'Answer a question using ONLY retrieved knowledge-base context — returns the answer, citations, sufficiency, and retrieval metadata. Set answerStyle:\"extractive\" for source excerpts without an LLM-written answer. Use thorbit_kb_search instead when you want the raw chunks rather than a synthesized answer.',\n    inputSchema: ThorbitKbAskInputSchema,\n    annotations: readOnlyAnnotations('Ask Thorbit Knowledge Base', false),\n  })\n\n  return server\n}\n","import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'\nimport type { ThorbitKnowledgeBaseMcpEnvelope } from './thorbit-kb-api-client.js'\nimport type { ThorbitKnowledgeBaseMcpToolName } from './thorbit-kb-mcp-tool-names.js'\n\nfunction summarizeResult(toolName: ThorbitKnowledgeBaseMcpToolName, result: unknown): string {\n  if (toolName === 'thorbit_kb_create' && result && typeof result === 'object' && 'knowledgeBase' in result) {\n    const kb = result.knowledgeBase as { name?: unknown; publicId?: unknown }\n    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? '')}.`\n  }\n  if (toolName === 'thorbit_kb_list' && result && typeof result === 'object' && 'knowledgeBases' in result) {\n    const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0\n    return `Found ${count} Thorbit knowledge base${count === 1 ? '' : 's'}.`\n  }\n  if (toolName.startsWith('thorbit_kb_ingest')) return 'Knowledge-base ingestion completed. Check structuredContent for source receipts.'\n  if (toolName === 'thorbit_kb_source_status') return 'Source status returned. Check structuredContent for details.'\n  if (toolName === 'thorbit_kb_search') return 'Knowledge-base search completed. Check structuredContent for results and citations.'\n  if (toolName === 'thorbit_kb_ask') return 'Knowledge-base answer generated. Check structuredContent for citations and strategy.'\n  return 'Thorbit knowledge-base tool completed.'\n}\n\nexport function formatThorbitKbMcpToolResult(\n  toolName: ThorbitKnowledgeBaseMcpToolName,\n  envelope: ThorbitKnowledgeBaseMcpEnvelope,\n): CallToolResult {\n  if (!envelope.ok) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: `${envelope.error.code}: ${envelope.error.message}`,\n      }],\n      structuredContent: envelope,\n    }\n  }\n\n  return {\n    content: [{\n      type: 'text',\n      text: summarizeResult(toolName, envelope.result),\n    }],\n    structuredContent: envelope.result as Record<string, unknown>,\n  }\n}\n","import { z } from 'zod'\n\nconst MetadataSchema = z.record(z.string(), z.unknown())\n\nexport const ThorbitKbCreateInputSchema = {\n  name: z.string().min(1).max(255).describe('Name for the new Thorbit knowledge base.'),\n  description: z.string().max(2000).optional().describe('Optional description for the new knowledge base.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID. Omit to create an org-level knowledge base.'),\n  folder: z.string().min(1).max(128).optional().describe('Optional organizational folder, such as research or domains.'),\n}\n\nexport const ThorbitKbListInputSchema = {\n  projectPublicId: z.string().min(1).optional().describe('Optional Thorbit project public ID used to narrow knowledge-base listing.'),\n  includeGlobal: z.boolean().default(true).describe('Include org-level/global knowledge bases. Default true.'),\n  limit: z.number().int().min(1).max(100).default(50).describe('Maximum knowledge bases to return.'),\n}\n\nexport const ThorbitKbSourceStatusInputSchema = {\n  sourcePublicIds: z.array(z.string().min(1)).min(1).max(100).describe('Source public IDs returned by Thorbit KB ingestion tools.'),\n}\n\nexport const ThorbitKbIngestUrlInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  url: z.string().url().describe('Public URL to extract through MCP Scraper and ingest into Thorbit.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override. Provider title is used when omitted.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version. Refresh mode is intentionally not enabled in V1.'),\n  maxCharacters: z.number().int().min(500).max(500000).optional().describe('Optional cap before chunking/vectorization.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestSiteInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  startUrl: z.string().url().describe('Website start URL. Thorbit maps URLs through MCP Scraper, then ingests selected pages.'),\n  includePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that a mapped URL must match.'),\n  excludePatterns: z.array(z.string().min(1)).max(20).optional().describe('Optional regex or substring patterns that remove mapped URLs.'),\n  maxPages: z.number().int().min(1).max(100).default(25).describe('Maximum pages to ingest. Default 25, hard cap 100.'),\n  mode: z.enum(['append']).default('append').describe('Append source versions. Refresh mode is intentionally not enabled in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on each KB source.'),\n}\n\nexport const ThorbitKbIngestYoutubeInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  videoUrl: z.string().url().describe('YouTube video URL. Thorbit transcribes through MCP Scraper and vectorizes transcript chunks.'),\n  title: z.string().min(1).max(512).optional().describe('Optional title override.'),\n  mode: z.enum(['append']).default('append').describe('Append a new source version.'),\n  preserveTimestamps: z.boolean().default(true).describe('Store transcript timestamps on chunks when MCP Scraper returns them.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbIngestTextInputSchema = {\n  knowledgeBasePublicId: z.string().min(1).describe('Target Thorbit knowledge-base public ID.'),\n  title: z.string().min(1).max(512).describe('Source title shown in KB citations.'),\n  content: z.string().min(1).max(500000).describe('Text or Markdown to chunk, embed, and ingest.'),\n  sourceUrl: z.string().url().optional().describe('Optional canonical source URL for citations.'),\n  sourceType: z.enum(['manual', 'note', 'markdown']).default('manual').describe('Caller-facing source type. Thorbit stores note/markdown as manual sources in V1.'),\n  metadata: MetadataSchema.optional().describe('Optional metadata stored on the KB source.'),\n}\n\nexport const ThorbitKbSearchInputSchema = {\n  query: z.string().min(1).max(4000).describe('Search query. Use the user question or a focused retrieval query.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to search visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  limit: z.number().int().min(1).max(20).default(5).describe('Maximum chunks to return.'),\n  includeEntities: z.boolean().default(false).describe('Reserved for entity-rich responses.'),\n  searchMode: z.enum(['smart', 'hybrid']).default('smart').describe('smart uses Thorbit intent/rerank retrieval; hybrid uses ANN plus FTS.'),\n}\n\nexport const ThorbitKbAskInputSchema = {\n  question: z.string().min(1).max(8000).describe('Question to answer using Thorbit KB context only.'),\n  knowledgeBasePublicId: z.string().min(1).optional().describe('Optional target KB. Omit to answer over visible KBs.'),\n  projectPublicId: z.string().min(1).optional().describe('Optional project scope when no KB is specified.'),\n  answerStyle: z.enum(['concise', 'detailed', 'extractive']).default('concise').describe('Use extractive to return source excerpts without an LLM answer.'),\n  limit: z.number().int().min(1).max(20).default(8).describe('Maximum retrieved chunks used for the answer.'),\n  requireCitations: z.boolean().default(true).describe('Keep true for grounded answers with citation arrays.'),\n}\n\nexport const ThorbitKnowledgeBaseMcpToolInputSchemas = {\n  thorbit_kb_create: ThorbitKbCreateInputSchema,\n  thorbit_kb_list: ThorbitKbListInputSchema,\n  thorbit_kb_source_status: ThorbitKbSourceStatusInputSchema,\n  thorbit_kb_ingest_url: ThorbitKbIngestUrlInputSchema,\n  thorbit_kb_ingest_site: ThorbitKbIngestSiteInputSchema,\n  thorbit_kb_ingest_youtube: ThorbitKbIngestYoutubeInputSchema,\n  thorbit_kb_ingest_text: ThorbitKbIngestTextInputSchema,\n  thorbit_kb_search: ThorbitKbSearchInputSchema,\n  thorbit_kb_ask: ThorbitKbAskInputSchema,\n}\n","import { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type ThorbitKbMcpEnv = {\n  apiKey: string\n  baseUrl: string\n}\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.THORBIT_KB_MCP_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.thorbit-kb-mcp-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      continue\n    }\n  }\n  return undefined\n}\n\nexport function resolveThorbitKbMcpEnv(): ThorbitKbMcpEnv {\n  const apiKey = (\n    process.env.THORBIT_API_KEY ||\n    process.env.THORBIT_MCP_API_KEY ||\n    process.env.THORBIT_KB_MCP_API_KEY ||\n    readApiKeyFile()\n  )?.trim()\n\n  if (!apiKey) {\n    throw new Error('THORBIT_API_KEY, THORBIT_MCP_API_KEY, or ~/.thorbit-kb-mcp-key is required')\n  }\n\n  return {\n    apiKey,\n    baseUrl: (process.env.THORBIT_BASE_URL || process.env.THORBIT_KB_MCP_BASE_URL || 'https://thorbit.ai').trim(),\n  }\n}\n","export const ThorbitKnowledgeBaseMcpToolNames = [\n  'thorbit_kb_create',\n  'thorbit_kb_list',\n  'thorbit_kb_source_status',\n  'thorbit_kb_ingest_url',\n  'thorbit_kb_ingest_site',\n  'thorbit_kb_ingest_youtube',\n  'thorbit_kb_ingest_text',\n  'thorbit_kb_search',\n  'thorbit_kb_ask',\n] as const\n\nexport type ThorbitKnowledgeBaseMcpToolName = typeof ThorbitKnowledgeBaseMcpToolNames[number]\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thorbit-kb-mcp",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MCP server for Thorbit Knowledge Base ingestion, search, and grounded answers",
   "type": "module",
   "main": "./dist/index.cjs",