thorbit-kb-mcp 0.1.2 → 0.2.1

package/README.md

@@ -29,13 +29,16 @@ MCP client example:
 Generate the same JSON from the CLI:
 
 ```bash
-npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --api-key thbt_mcp_...
+npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...
 ```
 
 Optional:
 
 - `THORBIT_BASE_URL`: hosted Thorbit app URL. Defaults to `https://thorbit.ai`.
 - `THORBIT_KB_MCP_KEY_PATH`: file containing the API key. Defaults to `~/.thorbit-kb-mcp-key`.
+- `thorbit-kb-mcp-install`: prints a terracotta Thorbit KB setup screen by default.
+- `thorbit-kb-mcp-install --json`: prints only MCP client JSON for scripts.
+- `thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key`: emits config that reads the key from a local file instead of embedding it inline.
 
 ## Internal Admin Key
 
@@ -50,6 +53,7 @@ The command writes the raw key to `~/.thorbit-kb-mcp-admin-key` with `0600` perm
 ## Tools
 
 - `thorbit_kb_list`
+- `thorbit_kb_create`
 - `thorbit_kb_source_status`
 - `thorbit_kb_ingest_url`
 - `thorbit_kb_ingest_site`

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

@@ -1,32 +1,193 @@
 #!/usr/bin/env node
 "use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // bin/thorbit-kb-mcp-install.ts
-function readArg(name) {
+var thorbit_kb_mcp_install_exports = {};
+__export(thorbit_kb_mcp_install_exports, {
+  buildMcpConfig: () => buildMcpConfig,
+  hasFlag: () => hasFlag,
+  main: () => main,
+  readArg: () => readArg,
+  renderBanner: () => renderBanner,
+  renderHelp: () => renderHelp,
+  renderInstallInstructions: () => renderInstallInstructions,
+  resolveInstallOptions: () => resolveInstallOptions
+});
+module.exports = __toCommonJS(thorbit_kb_mcp_install_exports);
+var import_node_fs = require("fs");
+var import_node_url = require("url");
+var import_meta = {};
+function readArg(name, argv = process.argv.slice(2)) {
   const prefix = `--${name}=`;
-  const inline = process.argv.find((arg) => arg.startsWith(prefix));
+  const inline = argv.find((arg) => arg.startsWith(prefix));
   if (inline) return inline.slice(prefix.length);
-  const index = process.argv.indexOf(`--${name}`);
-  return index >= 0 ? process.argv[index + 1] : void 0;
-}
-var apiKey = readArg("api-key") ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? "thbt_mcp_...";
-var baseUrl = readArg("base-url") ?? process.env.THORBIT_BASE_URL;
-var serverName = readArg("server-name") ?? "thorbit-kb";
-var env = {
-  THORBIT_API_KEY: apiKey
-};
-if (baseUrl) {
-  env.THORBIT_BASE_URL = baseUrl.replace(/\/$/, "");
-}
-var config = {
-  mcpServers: {
-    [serverName]: {
-      command: "npx",
-      args: ["-y", "thorbit-kb-mcp@latest"],
-      env
-    }
+  const index = argv.indexOf(`--${name}`);
+  return index >= 0 ? argv[index + 1] : void 0;
+}
+function hasFlag(name, argv = process.argv.slice(2)) {
+  return argv.includes(`--${name}`);
+}
+function resolveInstallOptions(argv = process.argv.slice(2)) {
+  return {
+    apiKey: readArg("api-key", argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? "thbt_mcp_...",
+    baseUrl: readArg("base-url", argv) ?? process.env.THORBIT_BASE_URL,
+    keyPath: readArg("key-path", argv) ?? process.env.THORBIT_KB_MCP_KEY_PATH,
+    serverName: readArg("server-name", argv) ?? "thorbit-kb",
+    json: hasFlag("json", argv),
+    color: !hasFlag("no-color", argv),
+    help: hasFlag("help", argv) || hasFlag("h", argv)
+  };
+}
+function buildMcpConfig(options) {
+  const env = options.keyPath ? { THORBIT_KB_MCP_KEY_PATH: options.keyPath } : { THORBIT_API_KEY: options.apiKey };
+  if (options.baseUrl) {
+    env.THORBIT_BASE_URL = options.baseUrl.replace(/\/$/, "");
   }
+  return {
+    mcpServers: {
+      [options.serverName]: {
+        command: "npx",
+        args: ["-y", "thorbit-kb-mcp@latest"],
+        env
+      }
+    }
+  };
+}
+var ansi = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  terracotta: "\x1B[38;2;198;90;54m",
+  cream: "\x1B[38;2;255;244;230m",
+  green: "\x1B[38;2;75;181;67m",
+  slate: "\x1B[38;2;148;163;184m"
 };
-process.stdout.write(`${JSON.stringify(config, null, 2)}
+function paint(value, code, enabled) {
+  return enabled ? `${code}${value}${ansi.reset}` : value;
+}
+function renderHelp(color) {
+  return [
+    renderBanner(color),
+    "",
+    "Usage:",
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install [options]",
+    "",
+    "Options:",
+    "  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.",
+    "  --key-path <path>      File containing the API key. Preferred for shared machines and servers.",
+    "  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.",
+    "  --server-name <name>   MCP client server name. Defaults to thorbit-kb.",
+    "  --json                 Print only MCP client JSON.",
+    "  --no-color             Disable ANSI color.",
+    "  --help                 Show this help.",
+    ""
+  ].join("\n");
+}
+function renderBanner(color) {
+  const banner = String.raw`
+  _______ _    _  ____  _____  ____ _____ _______   _  ______
+ |__   __| |  | |/ __ \|  __ \|  _ \_   _|__   __| | |/ /  _ \
+    | |  | |__| | |  | | |__) | |_) || |    | |    | ' /| |_) |
+    | |  |  __  | |  | |  _  /|  _ < | |    | |    |  < |  _ <
+    | |  | |  | | |__| | | \ \| |_) || |_   | |    | . \| |_) |
+    |_|  |_|  |_|\____/|_|  \_\____/_____|  |_|    |_|\_\____/
+
+                         MCP
+`;
+  return paint(banner, ansi.terracotta, color);
+}
+function renderInstallInstructions(options) {
+  const color = options.color;
+  const config = buildMcpConfig(options);
+  const json = JSON.stringify(config, null, 2);
+  const keySetup = options.keyPath ? [
+    paint("Key file mode", ansi.terracotta, color),
+    `  chmod 600 ${options.keyPath}`
+  ].join("\n") : [
+    paint("Safer key-file option", ansi.terracotta, color),
+    "  mkdir -p ~/.config/thorbit",
+    "  printf '%s\\n' 'thbt_mcp_...' > ~/.config/thorbit/kb-mcp-key",
+    "  chmod 600 ~/.config/thorbit/kb-mcp-key",
+    "",
+    "  Then run:",
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key"
+  ].join("\n");
+  return [
+    renderBanner(color),
+    paint("THORBIT KB MCP", ansi.bold + ansi.cream, color),
+    paint("Vector-backed knowledge bases for MCP agents.", ansi.slate, color),
+    "",
+    `${paint("1.", ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs.`,
+    `${paint("2.", ansi.terracotta, color)} Add this server config to your MCP client:`,
+    "",
+    json,
+    "",
+    `${paint("3.", ansi.terracotta, color)} Restart your MCP client, then call ${paint("thorbit_kb_list", ansi.green, color)} or ${paint("thorbit_kb_create", ansi.green, color)}.`,
+    "",
+    keySetup,
+    "",
+    paint("Tools", ansi.terracotta, color),
+    "  thorbit_kb_create        Create a vector-backed Thorbit KB.",
+    "  thorbit_kb_ingest_url    Extract a URL through MCP Scraper and ingest it.",
+    "  thorbit_kb_ingest_site   Map/extract a site through MCP Scraper and ingest pages.",
+    "  thorbit_kb_ingest_youtube Transcribe YouTube through MCP Scraper and ingest chunks.",
+    "  thorbit_kb_search        Smart RAG search with citations.",
+    "  thorbit_kb_ask           Grounded answers with citations and strategy metadata.",
+    "",
+    paint("Raw JSON:", ansi.slate, color),
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...",
+    ""
+  ].join("\n");
+}
+function main() {
+  const options = resolveInstallOptions();
+  if (options.help) {
+    process.stdout.write(renderHelp(options.color));
+    return;
+  }
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}
 `);
+    return;
+  }
+  process.stdout.write(renderInstallInstructions(options));
+}
+function isMainModule() {
+  const entry = process.argv[1];
+  if (!entry) return false;
+  try {
+    return (0, import_node_fs.realpathSync)(entry) === (0, import_node_fs.realpathSync)((0, import_node_url.fileURLToPath)(import_meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isMainModule()) main();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildMcpConfig,
+  hasFlag,
+  main,
+  readArg,
+  renderBanner,
+  renderHelp,
+  renderInstallInstructions,
+  resolveInstallOptions
+});
 //# sourceMappingURL=thorbit-kb-mcp-install.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-kb-mcp-install.ts"],"sourcesContent":["function readArg(name: string): string | undefined {\n  const prefix = `--${name}=`\n  const inline = process.argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = process.argv.indexOf(`--${name}`)\n  return index >= 0 ? process.argv[index + 1] : undefined\n}\n\nconst apiKey = readArg('api-key') ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...'\nconst baseUrl = readArg('base-url') ?? process.env.THORBIT_BASE_URL\nconst serverName = readArg('server-name') ?? 'thorbit-kb'\n\nconst env: Record<string, string> = {\n  THORBIT_API_KEY: apiKey,\n}\n\nif (baseUrl) {\n  env.THORBIT_BASE_URL = baseUrl.replace(/\\/$/, '')\n}\n\nconst config = {\n  mcpServers: {\n    [serverName]: {\n      command: 'npx',\n      args: ['-y', 'thorbit-kb-mcp@latest'],\n      env,\n    },\n  },\n}\n\nprocess.stdout.write(`${JSON.stringify(config, null, 2)}\\n`)\n"],"mappings":";;;;AAAA,SAAS,QAAQ,MAAkC;AACjD,QAAM,SAAS,KAAK,IAAI;AACxB,QAAM,SAAS,QAAQ,KAAK,KAAK,SAAO,IAAI,WAAW,MAAM,CAAC;AAC9D,MAAI,OAAQ,QAAO,OAAO,MAAM,OAAO,MAAM;AAC7C,QAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK,IAAI,EAAE;AAC9C,SAAO,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI;AAChD;AAEA,IAAM,SAAS,QAAQ,SAAS,KAAK,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,uBAAuB;AACvG,IAAM,UAAU,QAAQ,UAAU,KAAK,QAAQ,IAAI;AACnD,IAAM,aAAa,QAAQ,aAAa,KAAK;AAE7C,IAAM,MAA8B;AAAA,EAClC,iBAAiB;AACnB;AAEA,IAAI,SAAS;AACX,MAAI,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AAClD;AAEA,IAAM,SAAS;AAAA,EACb,YAAY;AAAA,IACV,CAAC,UAAU,GAAG;AAAA,MACZ,SAAS;AAAA,MACT,MAAM,CAAC,MAAM,uBAAuB;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;AAEA,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,CAAI;","names":[]}
+{"version":3,"sources":["../../bin/thorbit-kb-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_KB_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-kb',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_KB_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-kb-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  slate: '\\u001b[38;2;148;163;184m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-kb.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  const banner = String.raw`\n  _______ _    _  ____  _____  ____ _____ _______   _  ______\n |__   __| |  | |/ __ \\|  __ \\|  _ \\_   _|__   __| | |/ /  _ \\\n    | |  | |__| | |  | | |__) | |_) || |    | |    | ' /| |_) |\n    | |  |  __  | |  | |  _  /|  _ < | |    | |    |  < |  _ <\n    | |  | |  | | |__| | | \\ \\| |_) || |_   | |    | . \\| |_) |\n    |_|  |_|  |_|\\____/|_|  \\_\\____/_____|  |_|    |_|\\_\\____/\n\n                         MCP\n`\n  return paint(banner, ansi.terracotta, color)\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const config = buildMcpConfig(options)\n  const json = JSON.stringify(config, null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        \"  mkdir -p ~/.config/thorbit\",\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/kb-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/kb-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('THORBIT KB MCP', ansi.bold + ansi.cream, color),\n    paint('Vector-backed knowledge bases for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_kb_list', ansi.green, color)} or ${paint('thorbit_kb_create', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_kb_create        Create a vector-backed Thorbit KB.',\n    '  thorbit_kb_ingest_url    Extract a URL through MCP Scraper and ingest it.',\n    '  thorbit_kb_ingest_site   Map/extract a site through MCP Scraper and ingest pages.',\n    '  thorbit_kb_ingest_youtube Transcribe YouTube through MCP Scraper and ingest chunks.',\n    '  thorbit_kb_search        Smart RAG search with citations.',\n    '  thorbit_kb_ask           Grounded answers with citations and strategy metadata.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":"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","names":[]}

package/dist/bin/thorbit-kb-mcp-install.d.cts

@@ -1,2 +1,27 @@
+type InstallOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    keyPath?: string;
+    serverName: string;
+    json: boolean;
+    color: boolean;
+    help: boolean;
+};
+declare function readArg(name: string, argv?: string[]): string | undefined;
+declare function hasFlag(name: string, argv?: string[]): boolean;
+declare function resolveInstallOptions(argv?: string[]): InstallOptions;
+declare function buildMcpConfig(options: InstallOptions): {
+    mcpServers: {
+        [options.serverName]: {
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        };
+    };
+};
+declare function renderHelp(color: boolean): string;
+declare function renderBanner(color: boolean): string;
+declare function renderInstallInstructions(options: InstallOptions): string;
+declare function main(): void;
 
-export {  }
+export { type InstallOptions, buildMcpConfig, hasFlag, main, readArg, renderBanner, renderHelp, renderInstallInstructions, resolveInstallOptions };

package/dist/bin/thorbit-kb-mcp-install.d.ts

@@ -1,2 +1,27 @@
+type InstallOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    keyPath?: string;
+    serverName: string;
+    json: boolean;
+    color: boolean;
+    help: boolean;
+};
+declare function readArg(name: string, argv?: string[]): string | undefined;
+declare function hasFlag(name: string, argv?: string[]): boolean;
+declare function resolveInstallOptions(argv?: string[]): InstallOptions;
+declare function buildMcpConfig(options: InstallOptions): {
+    mcpServers: {
+        [options.serverName]: {
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        };
+    };
+};
+declare function renderHelp(color: boolean): string;
+declare function renderBanner(color: boolean): string;
+declare function renderInstallInstructions(options: InstallOptions): string;
+declare function main(): void;
 
-export {  }
+export { type InstallOptions, buildMcpConfig, hasFlag, main, readArg, renderBanner, renderHelp, renderInstallInstructions, resolveInstallOptions };

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

@@ -1,31 +1,161 @@
 #!/usr/bin/env node
 
 // bin/thorbit-kb-mcp-install.ts
-function readArg(name) {
+import { realpathSync } from "fs";
+import { fileURLToPath } from "url";
+function readArg(name, argv = process.argv.slice(2)) {
   const prefix = `--${name}=`;
-  const inline = process.argv.find((arg) => arg.startsWith(prefix));
+  const inline = argv.find((arg) => arg.startsWith(prefix));
   if (inline) return inline.slice(prefix.length);
-  const index = process.argv.indexOf(`--${name}`);
-  return index >= 0 ? process.argv[index + 1] : void 0;
-}
-var apiKey = readArg("api-key") ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? "thbt_mcp_...";
-var baseUrl = readArg("base-url") ?? process.env.THORBIT_BASE_URL;
-var serverName = readArg("server-name") ?? "thorbit-kb";
-var env = {
-  THORBIT_API_KEY: apiKey
-};
-if (baseUrl) {
-  env.THORBIT_BASE_URL = baseUrl.replace(/\/$/, "");
-}
-var config = {
-  mcpServers: {
-    [serverName]: {
-      command: "npx",
-      args: ["-y", "thorbit-kb-mcp@latest"],
-      env
-    }
+  const index = argv.indexOf(`--${name}`);
+  return index >= 0 ? argv[index + 1] : void 0;
+}
+function hasFlag(name, argv = process.argv.slice(2)) {
+  return argv.includes(`--${name}`);
+}
+function resolveInstallOptions(argv = process.argv.slice(2)) {
+  return {
+    apiKey: readArg("api-key", argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? "thbt_mcp_...",
+    baseUrl: readArg("base-url", argv) ?? process.env.THORBIT_BASE_URL,
+    keyPath: readArg("key-path", argv) ?? process.env.THORBIT_KB_MCP_KEY_PATH,
+    serverName: readArg("server-name", argv) ?? "thorbit-kb",
+    json: hasFlag("json", argv),
+    color: !hasFlag("no-color", argv),
+    help: hasFlag("help", argv) || hasFlag("h", argv)
+  };
+}
+function buildMcpConfig(options) {
+  const env = options.keyPath ? { THORBIT_KB_MCP_KEY_PATH: options.keyPath } : { THORBIT_API_KEY: options.apiKey };
+  if (options.baseUrl) {
+    env.THORBIT_BASE_URL = options.baseUrl.replace(/\/$/, "");
   }
+  return {
+    mcpServers: {
+      [options.serverName]: {
+        command: "npx",
+        args: ["-y", "thorbit-kb-mcp@latest"],
+        env
+      }
+    }
+  };
+}
+var ansi = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  terracotta: "\x1B[38;2;198;90;54m",
+  cream: "\x1B[38;2;255;244;230m",
+  green: "\x1B[38;2;75;181;67m",
+  slate: "\x1B[38;2;148;163;184m"
 };
-process.stdout.write(`${JSON.stringify(config, null, 2)}
+function paint(value, code, enabled) {
+  return enabled ? `${code}${value}${ansi.reset}` : value;
+}
+function renderHelp(color) {
+  return [
+    renderBanner(color),
+    "",
+    "Usage:",
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install [options]",
+    "",
+    "Options:",
+    "  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.",
+    "  --key-path <path>      File containing the API key. Preferred for shared machines and servers.",
+    "  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.",
+    "  --server-name <name>   MCP client server name. Defaults to thorbit-kb.",
+    "  --json                 Print only MCP client JSON.",
+    "  --no-color             Disable ANSI color.",
+    "  --help                 Show this help.",
+    ""
+  ].join("\n");
+}
+function renderBanner(color) {
+  const banner = String.raw`
+  _______ _    _  ____  _____  ____ _____ _______   _  ______
+ |__   __| |  | |/ __ \|  __ \|  _ \_   _|__   __| | |/ /  _ \
+    | |  | |__| | |  | | |__) | |_) || |    | |    | ' /| |_) |
+    | |  |  __  | |  | |  _  /|  _ < | |    | |    |  < |  _ <
+    | |  | |  | | |__| | | \ \| |_) || |_   | |    | . \| |_) |
+    |_|  |_|  |_|\____/|_|  \_\____/_____|  |_|    |_|\_\____/
+
+                         MCP
+`;
+  return paint(banner, ansi.terracotta, color);
+}
+function renderInstallInstructions(options) {
+  const color = options.color;
+  const config = buildMcpConfig(options);
+  const json = JSON.stringify(config, null, 2);
+  const keySetup = options.keyPath ? [
+    paint("Key file mode", ansi.terracotta, color),
+    `  chmod 600 ${options.keyPath}`
+  ].join("\n") : [
+    paint("Safer key-file option", ansi.terracotta, color),
+    "  mkdir -p ~/.config/thorbit",
+    "  printf '%s\\n' 'thbt_mcp_...' > ~/.config/thorbit/kb-mcp-key",
+    "  chmod 600 ~/.config/thorbit/kb-mcp-key",
+    "",
+    "  Then run:",
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key"
+  ].join("\n");
+  return [
+    renderBanner(color),
+    paint("THORBIT KB MCP", ansi.bold + ansi.cream, color),
+    paint("Vector-backed knowledge bases for MCP agents.", ansi.slate, color),
+    "",
+    `${paint("1.", ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs.`,
+    `${paint("2.", ansi.terracotta, color)} Add this server config to your MCP client:`,
+    "",
+    json,
+    "",
+    `${paint("3.", ansi.terracotta, color)} Restart your MCP client, then call ${paint("thorbit_kb_list", ansi.green, color)} or ${paint("thorbit_kb_create", ansi.green, color)}.`,
+    "",
+    keySetup,
+    "",
+    paint("Tools", ansi.terracotta, color),
+    "  thorbit_kb_create        Create a vector-backed Thorbit KB.",
+    "  thorbit_kb_ingest_url    Extract a URL through MCP Scraper and ingest it.",
+    "  thorbit_kb_ingest_site   Map/extract a site through MCP Scraper and ingest pages.",
+    "  thorbit_kb_ingest_youtube Transcribe YouTube through MCP Scraper and ingest chunks.",
+    "  thorbit_kb_search        Smart RAG search with citations.",
+    "  thorbit_kb_ask           Grounded answers with citations and strategy metadata.",
+    "",
+    paint("Raw JSON:", ansi.slate, color),
+    "  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...",
+    ""
+  ].join("\n");
+}
+function main() {
+  const options = resolveInstallOptions();
+  if (options.help) {
+    process.stdout.write(renderHelp(options.color));
+    return;
+  }
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}
 `);
+    return;
+  }
+  process.stdout.write(renderInstallInstructions(options));
+}
+function isMainModule() {
+  const entry = process.argv[1];
+  if (!entry) return false;
+  try {
+    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isMainModule()) main();
+export {
+  buildMcpConfig,
+  hasFlag,
+  main,
+  readArg,
+  renderBanner,
+  renderHelp,
+  renderInstallInstructions,
+  resolveInstallOptions
+};
 //# sourceMappingURL=thorbit-kb-mcp-install.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/thorbit-kb-mcp-install.ts"],"sourcesContent":["function readArg(name: string): string | undefined {\n  const prefix = `--${name}=`\n  const inline = process.argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = process.argv.indexOf(`--${name}`)\n  return index >= 0 ? process.argv[index + 1] : undefined\n}\n\nconst apiKey = readArg('api-key') ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...'\nconst baseUrl = readArg('base-url') ?? process.env.THORBIT_BASE_URL\nconst serverName = readArg('server-name') ?? 'thorbit-kb'\n\nconst env: Record<string, string> = {\n  THORBIT_API_KEY: apiKey,\n}\n\nif (baseUrl) {\n  env.THORBIT_BASE_URL = baseUrl.replace(/\\/$/, '')\n}\n\nconst config = {\n  mcpServers: {\n    [serverName]: {\n      command: 'npx',\n      args: ['-y', 'thorbit-kb-mcp@latest'],\n      env,\n    },\n  },\n}\n\nprocess.stdout.write(`${JSON.stringify(config, null, 2)}\\n`)\n"],"mappings":";;;AAAA,SAAS,QAAQ,MAAkC;AACjD,QAAM,SAAS,KAAK,IAAI;AACxB,QAAM,SAAS,QAAQ,KAAK,KAAK,SAAO,IAAI,WAAW,MAAM,CAAC;AAC9D,MAAI,OAAQ,QAAO,OAAO,MAAM,OAAO,MAAM;AAC7C,QAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK,IAAI,EAAE;AAC9C,SAAO,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI;AAChD;AAEA,IAAM,SAAS,QAAQ,SAAS,KAAK,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,uBAAuB;AACvG,IAAM,UAAU,QAAQ,UAAU,KAAK,QAAQ,IAAI;AACnD,IAAM,aAAa,QAAQ,aAAa,KAAK;AAE7C,IAAM,MAA8B;AAAA,EAClC,iBAAiB;AACnB;AAEA,IAAI,SAAS;AACX,MAAI,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AAClD;AAEA,IAAM,SAAS;AAAA,EACb,YAAY;AAAA,IACV,CAAC,UAAU,GAAG;AAAA,MACZ,SAAS;AAAA,MACT,MAAM,CAAC,MAAM,uBAAuB;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;AAEA,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,CAAI;","names":[]}
+{"version":3,"sources":["../../bin/thorbit-kb-mcp-install.ts"],"sourcesContent":["import { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\n\nexport type InstallOptions = {\n  apiKey: string\n  baseUrl?: string\n  keyPath?: string\n  serverName: string\n  json: boolean\n  color: boolean\n  help: boolean\n}\n\nexport function readArg(name: string, argv = process.argv.slice(2)): string | undefined {\n  const prefix = `--${name}=`\n  const inline = argv.find(arg => arg.startsWith(prefix))\n  if (inline) return inline.slice(prefix.length)\n  const index = argv.indexOf(`--${name}`)\n  return index >= 0 ? argv[index + 1] : undefined\n}\n\nexport function hasFlag(name: string, argv = process.argv.slice(2)): boolean {\n  return argv.includes(`--${name}`)\n}\n\nexport function resolveInstallOptions(argv = process.argv.slice(2)): InstallOptions {\n  return {\n    apiKey: readArg('api-key', argv) ?? process.env.THORBIT_API_KEY ?? process.env.THORBIT_MCP_API_KEY ?? 'thbt_mcp_...',\n    baseUrl: readArg('base-url', argv) ?? process.env.THORBIT_BASE_URL,\n    keyPath: readArg('key-path', argv) ?? process.env.THORBIT_KB_MCP_KEY_PATH,\n    serverName: readArg('server-name', argv) ?? 'thorbit-kb',\n    json: hasFlag('json', argv),\n    color: !hasFlag('no-color', argv),\n    help: hasFlag('help', argv) || hasFlag('h', argv),\n  }\n}\n\nexport function buildMcpConfig(options: InstallOptions) {\n  const env: Record<string, string> = options.keyPath\n    ? { THORBIT_KB_MCP_KEY_PATH: options.keyPath }\n    : { THORBIT_API_KEY: options.apiKey }\n\n  if (options.baseUrl) {\n    env.THORBIT_BASE_URL = options.baseUrl.replace(/\\/$/, '')\n  }\n\n  return {\n    mcpServers: {\n      [options.serverName]: {\n        command: 'npx',\n        args: ['-y', 'thorbit-kb-mcp@latest'],\n        env,\n      },\n    },\n  }\n}\n\nconst ansi = {\n  reset: '\\u001b[0m',\n  bold: '\\u001b[1m',\n  dim: '\\u001b[2m',\n  terracotta: '\\u001b[38;2;198;90;54m',\n  cream: '\\u001b[38;2;255;244;230m',\n  green: '\\u001b[38;2;75;181;67m',\n  slate: '\\u001b[38;2;148;163;184m',\n}\n\nfunction paint(value: string, code: string, enabled: boolean): string {\n  return enabled ? `${code}${value}${ansi.reset}` : value\n}\n\nexport function renderHelp(color: boolean): string {\n  return [\n    renderBanner(color),\n    '',\n    'Usage:',\n    '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install [options]',\n    '',\n    'Options:',\n    '  --api-key <key>        Thorbit MCP API key from Settings -> MCPs.',\n    '  --key-path <path>      File containing the API key. Preferred for shared machines and servers.',\n    '  --base-url <url>       Thorbit app URL. Defaults to https://thorbit.ai.',\n    '  --server-name <name>   MCP client server name. Defaults to thorbit-kb.',\n    '  --json                 Print only MCP client JSON.',\n    '  --no-color             Disable ANSI color.',\n    '  --help                 Show this help.',\n    '',\n  ].join('\\n')\n}\n\nexport function renderBanner(color: boolean): string {\n  const banner = String.raw`\n  _______ _    _  ____  _____  ____ _____ _______   _  ______\n |__   __| |  | |/ __ \\|  __ \\|  _ \\_   _|__   __| | |/ /  _ \\\n    | |  | |__| | |  | | |__) | |_) || |    | |    | ' /| |_) |\n    | |  |  __  | |  | |  _  /|  _ < | |    | |    |  < |  _ <\n    | |  | |  | | |__| | | \\ \\| |_) || |_   | |    | . \\| |_) |\n    |_|  |_|  |_|\\____/|_|  \\_\\____/_____|  |_|    |_|\\_\\____/\n\n                         MCP\n`\n  return paint(banner, ansi.terracotta, color)\n}\n\nexport function renderInstallInstructions(options: InstallOptions): string {\n  const color = options.color\n  const config = buildMcpConfig(options)\n  const json = JSON.stringify(config, null, 2)\n  const keySetup = options.keyPath\n    ? [\n        paint('Key file mode', ansi.terracotta, color),\n        `  chmod 600 ${options.keyPath}`,\n      ].join('\\n')\n    : [\n        paint('Safer key-file option', ansi.terracotta, color),\n        \"  mkdir -p ~/.config/thorbit\",\n        \"  printf '%s\\\\n' 'thbt_mcp_...' > ~/.config/thorbit/kb-mcp-key\",\n        '  chmod 600 ~/.config/thorbit/kb-mcp-key',\n        '',\n        '  Then run:',\n        '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --key-path ~/.config/thorbit/kb-mcp-key',\n      ].join('\\n')\n\n  return [\n    renderBanner(color),\n    paint('THORBIT KB MCP', ansi.bold + ansi.cream, color),\n    paint('Vector-backed knowledge bases for MCP agents.', ansi.slate, color),\n    '',\n    `${paint('1.', ansi.terracotta, color)} Generate an API key in Thorbit Settings -> MCPs.`,\n    `${paint('2.', ansi.terracotta, color)} Add this server config to your MCP client:`,\n    '',\n    json,\n    '',\n    `${paint('3.', ansi.terracotta, color)} Restart your MCP client, then call ${paint('thorbit_kb_list', ansi.green, color)} or ${paint('thorbit_kb_create', ansi.green, color)}.`,\n    '',\n    keySetup,\n    '',\n    paint('Tools', ansi.terracotta, color),\n    '  thorbit_kb_create        Create a vector-backed Thorbit KB.',\n    '  thorbit_kb_ingest_url    Extract a URL through MCP Scraper and ingest it.',\n    '  thorbit_kb_ingest_site   Map/extract a site through MCP Scraper and ingest pages.',\n    '  thorbit_kb_ingest_youtube Transcribe YouTube through MCP Scraper and ingest chunks.',\n    '  thorbit_kb_search        Smart RAG search with citations.',\n    '  thorbit_kb_ask           Grounded answers with citations and strategy metadata.',\n    '',\n    paint('Raw JSON:', ansi.slate, color),\n    '  npx -y -p thorbit-kb-mcp@latest thorbit-kb-mcp-install --json --api-key thbt_mcp_...',\n    '',\n  ].join('\\n')\n}\n\nexport function main(): void {\n  const options = resolveInstallOptions()\n  if (options.help) {\n    process.stdout.write(renderHelp(options.color))\n    return\n  }\n\n  if (options.json) {\n    process.stdout.write(`${JSON.stringify(buildMcpConfig(options), null, 2)}\\n`)\n    return\n  }\n\n  process.stdout.write(renderInstallInstructions(options))\n}\n\nfunction isMainModule(): boolean {\n  const entry = process.argv[1]\n  if (!entry) return false\n  try {\n    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))\n  } catch {\n    return false\n  }\n}\n\nif (isMainModule()) main()\n"],"mappings":"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","names":[]}

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

@@ -67,6 +67,10 @@ var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 
 // src/thorbit-kb-mcp-response-formatters.ts
 function summarizeResult(toolName, result) {
+  if (toolName === "thorbit_kb_create" && result && typeof result === "object" && "knowledgeBase" in result) {
+    const kb = result.knowledgeBase;
+    return `Created Thorbit knowledge base ${String(kb.name ?? kb.publicId ?? "")}.`;
+  }
   if (toolName === "thorbit_kb_list" && result && typeof result === "object" && "knowledgeBases" in result) {
     const count = Array.isArray(result.knowledgeBases) ? result.knowledgeBases.length : 0;
     return `Found ${count} Thorbit knowledge base${count === 1 ? "" : "s"}.`;
@@ -100,6 +104,12 @@ function formatThorbitKbMcpToolResult(toolName, envelope) {
 // src/thorbit-kb-mcp-tool-schemas.ts
 var import_zod = require("zod");
 var MetadataSchema = import_zod.z.record(import_zod.z.string(), import_zod.z.unknown());
+var ThorbitKbCreateInputSchema = {
+  name: import_zod.z.string().min(1).max(255).describe("Name for the new Thorbit knowledge base."),
+  description: import_zod.z.string().max(2e3).optional().describe("Optional description for the new knowledge base."),
+  projectPublicId: import_zod.z.string().min(1).optional().describe("Optional Thorbit project public ID. Omit to create an org-level knowledge base."),
+  folder: import_zod.z.string().min(1).max(128).optional().describe("Optional organizational folder, such as research or domains.")
+};
 var ThorbitKbListInputSchema = {
   projectPublicId: import_zod.z.string().min(1).optional().describe("Optional Thorbit project public ID used to narrow knowledge-base listing."),
   includeGlobal: import_zod.z.boolean().default(true).describe("Include org-level/global knowledge bases. Default true."),
@@ -159,7 +169,7 @@ var ThorbitKbAskInputSchema = {
 };
 
 // src/thorbit-kb-mcp-server.ts
-var VERSION = "0.1.2";
+var VERSION = "0.2.1";
 function readOnlyAnnotations(title, idempotent = true) {
   return {
     title,
@@ -213,6 +223,12 @@ function buildThorbitKnowledgeBaseMcpServer(client) {
       return formatThorbitKbMcpToolResult(toolName, envelope);
     });
   }
+  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.",
+    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.",