mcp-scraper 0.5.0 → 0.6.0

package/dist/bin/mcp-scraper-cli.js

@@ -11,7 +11,7 @@ import "../chunk-K443GQY5.js";
 import "../chunk-XGIPATLV.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-3RTPEQJC.js";
+} from "../chunk-F2BXETDX.js";
 
 // src/cli/human-cli.ts
 import { Command } from "commander";

package/dist/bin/mcp-scraper-install.cjs

@@ -102,7 +102,7 @@ function renderInstallTerminal(options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.5.0";
+var PACKAGE_VERSION = "0.6.0";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-scraper-install.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    `MCP_SCRAPER_API_KEY=${apiKeyValue} npx -y -p mcp-scraper@latest \\\\`,\n    '  mcp-scraper-cli agent install claude --apply',\n  ].join('\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    colorize('Newest: saved browser profiles that hold MANY site logins. Share the watch_url, user signs in, then verify with browser_profile_list. Browser sessions are direct/no-proxy by default.', 'lime', color),\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(128 MCP tools)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'audit_site', 'directory_workflow'], color),\n    toolRow('build', ['rank_tracker_workflow', 'cron plan', 'database prompt'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel', 'facebook_ad_transcribe', 'facebook_video_transcribe', 'instagram_profile_content', 'instagram_media_download', 'reddit_thread'], color),\n    toolRow('browser', ['browser_open', 'browser_profile_connect', 'browser_profile_list', 'browser_close', 'browser_screenshot', 'browser_read', 'browser_locate', 'browser_replay_mark', 'browser_replay_annotate'], color),\n    toolRow('account', ['credits_info', 'reports', 'MCP resources'], color),\n    toolRow('memory', ['memory-put', 'memory-get', 'memory-search', 'list-vaults', 'record-fact', 'list-scheduled-actions'], color),\n    `${colorize('Workflows', 'cyan', color)}  ${colorize('(MCP + CLI + API)', 'muted', color)}`,\n    toolRow('route', ['workflow_list', 'workflow_suggest', 'workflow_run', 'workflow_step', 'workflow_status', 'workflow_artifact_read'], color),\n    toolRow('seo', ['directory', 'agent-packet', 'competitive audit', 'map/serp comparison', 'PAA/AIO briefs', 'scheduled runs'], color),\n    '',\n    colorize('Usage tips:', 'amber', color),\n    'Run mcp-scraper-install for this visible card. Run mcp-scraper-cli for setup utilities and subcommands.',\n    'Run mcp-scraper in a human terminal to print this card; MCP clients get the same command as a silent stdio server.',\n    'Explicit card command: npx -y -p mcp-scraper@latest mcp-scraper-install',\n    'Customer auth setup: run browser_profile_connect, send the watch_url, let the user sign in, then call browser_profile_list until AUTHENTICATED.',\n    'Stack logins / reconnect: run browser_profile_connect again with the same profile name and another domain to add accounts or refresh a login.',\n    'Start with workflow_suggest for broad jobs like market analysis, ICP research, CRO audits, brand briefs, content gaps, and AI visibility.',\n    'For MCP clients, use mcp-scraper so one install can mix SERP, Maps, browser, reports, and saved MCP resources.',\n    'If you hit the concurrency limit, add an extra slot for $5/month with mcp-scraper-cli billing concurrency checkout.',\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one command:`,\n    '',\n    colorize('Setup doctor', 'amber', color),\n    'npx -y -p mcp-scraper@latest mcp-scraper-cli doctor',\n    '',\n    colorize('Hosted profile setup', 'amber', color),\n    'In your MCP client, call browser_profile_connect with email=\"seo@example.com\" and domain=\"chatgpt.com\".',\n    'Give the returned watch_url to the user. After they sign in, call browser_profile_list, then browser_open with the returned profile. Add more logins by calling browser_profile_connect again with the same profile and a new domain.',\n    '',\n    colorize('Claude Code one-command setup', 'amber', color),\n    claudeCommand,\n    'Then fully exit Claude Code and open a new Claude terminal. Check with: claude mcp list',\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'mcp-scraper prints this card only when stdin/stdout are an interactive TTY. In MCP clients it writes only JSON-RPC to stdout.',\n    'Use --stdio or MCP_SCRAPER_FORCE_STDIO=1 to force server mode from a terminal.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.5.0'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'mcp-scraper prints the same card in a human terminal and runs as the MCP stdio server in clients.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/install-terminal.ts","../../src/version.ts","../../bin/mcp-scraper-install.ts"],"sourcesContent":["export interface InstallTerminalOptions {\n  color?: boolean\n  version: string\n  apiKeyConfigured?: boolean\n}\n\ntype Tone = 'cyan' | 'lime' | 'amber' | 'red' | 'muted' | 'bold'\n\nconst CODES: Record<Tone | 'reset', string> = {\n  reset: '\\x1b[0m',\n  cyan: '\\x1b[36m',\n  lime: '\\x1b[32m',\n  amber: '\\x1b[33m',\n  red: '\\x1b[31m',\n  muted: '\\x1b[90m',\n  bold: '\\x1b[1m',\n}\n\nfunction colorize(value: string, tone: Tone, enabled: boolean): string {\n  if (!enabled) return value\n  return `${CODES[tone]}${value}${CODES.reset}`\n}\n\nfunction toolRow(label: string, tools: string[], enabled: boolean): string {\n  const padded = label.padEnd(9, ' ')\n  return `  ${colorize(padded, 'muted', enabled)} ${tools.join(colorize('  .  ', 'muted', enabled))}`\n}\n\nexport function renderInstallTerminal(options: InstallTerminalOptions): string {\n  const color = options.color ?? true\n  const apiKeyValue = options.apiKeyConfigured ? '$MCP_SCRAPER_API_KEY' : 'sk_live_your_key'\n  const ascii = String.raw`\n __  __  ____ ____ \n|  \\/  |/ ___|  _ \\\n| |\\/| | |   | |_) |\n| |  | | |___|  __/\n|_|  |_|\\____|_|\n\n ____   ____ ____      _    ____  _____ ____\n/ ___| / ___|  _ \\    / \\  |  _ \\| ____|  _ \\\n\\___ \\| |   | |_) |  / _ \\ | |_) |  _| | |_) |\n ___) | |___|  _ <  / ___ \\|  __/| |___|  _ <\n|____/ \\____|_| \\_\\/_/   \\_\\_|   |_____|_| \\_\\\n`\n\n  const claudeCommand = [\n    `MCP_SCRAPER_API_KEY=${apiKeyValue} npx -y -p mcp-scraper@latest \\\\`,\n    '  mcp-scraper-cli agent install claude --apply',\n  ].join('\\n')\n\n  const codexConfig = [\n    '[mcp_servers.mcp-scraper]',\n    'command = \"npx\"',\n    'args = [\"-y\", \"-p\", \"mcp-scraper@latest\", \"mcp-scraper\"]',\n    `env = { MCP_SCRAPER_API_KEY = \"${apiKeyValue}\" }`,\n  ].join('\\n')\n\n  return [\n    colorize(`mcp-scraper v${options.version}`, 'bold', color),\n    colorize('> mcp-scraper-install', 'muted', color),\n    colorize(ascii, 'amber', color),\n    `${colorize('MCP Scraper Agent', 'cyan', color)}  .  v${options.version}  .  mcpscraper.dev`,\n    '1/1 install surfaces ready',\n    colorize('Newest: saved browser profiles that hold MANY site logins. Share the watch_url, user signs in, then verify with browser_profile_list. Browser sessions are direct/no-proxy by default.', 'lime', color),\n    '',\n    `${colorize('Tools', 'cyan', color)}  ${colorize('(128 MCP tools)', 'muted', color)}`,\n    toolRow('search', ['harvest_paa', 'search_serp', 'maps_search', 'maps_place_intel'], color),\n    toolRow('extract', ['extract_url', 'map_site_urls', 'extract_site', 'audit_site', 'directory_workflow'], color),\n    toolRow('build', ['rank_tracker_workflow', 'cron plan', 'database prompt'], color),\n    toolRow('media', ['youtube_harvest', 'youtube_transcribe', 'facebook_ad_search', 'facebook_page_intel', 'facebook_ad_transcribe', 'facebook_video_transcribe', 'instagram_profile_content', 'instagram_media_download', 'reddit_thread'], color),\n    toolRow('browser', ['browser_open', 'browser_profile_connect', 'browser_profile_list', 'browser_close', 'browser_screenshot', 'browser_read', 'browser_locate', 'browser_replay_mark', 'browser_replay_annotate'], color),\n    toolRow('account', ['credits_info', 'reports', 'MCP resources'], color),\n    toolRow('memory', ['memory-put', 'memory-get', 'memory-search', 'list-vaults', 'record-fact', 'list-scheduled-actions'], color),\n    `${colorize('Workflows', 'cyan', color)}  ${colorize('(MCP + CLI + API)', 'muted', color)}`,\n    toolRow('route', ['workflow_list', 'workflow_suggest', 'workflow_run', 'workflow_step', 'workflow_status', 'workflow_artifact_read'], color),\n    toolRow('seo', ['directory', 'agent-packet', 'competitive audit', 'map/serp comparison', 'PAA/AIO briefs', 'scheduled runs'], color),\n    '',\n    colorize('Usage tips:', 'amber', color),\n    'Run mcp-scraper-install for this visible card. Run mcp-scraper-cli for setup utilities and subcommands.',\n    'Run mcp-scraper in a human terminal to print this card; MCP clients get the same command as a silent stdio server.',\n    'Explicit card command: npx -y -p mcp-scraper@latest mcp-scraper-install',\n    'Customer auth setup: run browser_profile_connect, send the watch_url, let the user sign in, then call browser_profile_list until AUTHENTICATED.',\n    'Stack logins / reconnect: run browser_profile_connect again with the same profile name and another domain to add accounts or refresh a login.',\n    'Start with workflow_suggest for broad jobs like market analysis, ICP research, CRO audits, brand briefs, content gaps, and AI visibility.',\n    'For MCP clients, use mcp-scraper so one install can mix SERP, Maps, browser, reports, and saved MCP resources.',\n    'If you hit the concurrency limit, add an extra slot for $5/month with mcp-scraper-cli billing concurrency checkout.',\n    '',\n    `${colorize('Ready.', 'lime', color)} Install the combined MCP server with one command:`,\n    '',\n    colorize('Setup doctor', 'amber', color),\n    'npx -y -p mcp-scraper@latest mcp-scraper-cli doctor',\n    '',\n    colorize('Hosted profile setup', 'amber', color),\n    'In your MCP client, call browser_profile_connect with email=\"seo@example.com\" and domain=\"chatgpt.com\".',\n    'Give the returned watch_url to the user. After they sign in, call browser_profile_list, then browser_open with the returned profile. Add more logins by calling browser_profile_connect again with the same profile and a new domain.',\n    '',\n    colorize('Claude Code one-command setup', 'amber', color),\n    claudeCommand,\n    'Then fully exit Claude Code and open a new Claude terminal. Check with: claude mcp list',\n    '',\n    colorize('Codex config', 'amber', color),\n    codexConfig,\n    '',\n    colorize('Claude Desktop Extension', 'amber', color),\n    'Download: https://mcpscraper.dev/downloads/mcp-scraper.mcpb',\n    '',\n    colorize('Safety note:', 'muted', color),\n    'mcp-scraper prints this card only when stdin/stdout are an interactive TTY. In MCP clients it writes only JSON-RPC to stdout.',\n    'Use --stdio or MCP_SCRAPER_FORCE_STDIO=1 to force server mode from a terminal.',\n    '',\n  ].join('\\n')\n}\n","export const PACKAGE_VERSION = '0.6.0'\n","#!/usr/bin/env node\nimport { renderInstallTerminal } from '../src/install-terminal.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst noColor =\n  process.argv.includes('--no-color') ||\n  process.env.NO_COLOR !== undefined ||\n  process.env.FORCE_COLOR === '0' ||\n  !process.stdout.isTTY\n\nconst help = process.argv.includes('--help') || process.argv.includes('-h')\nif (help) {\n  process.stdout.write([\n    'Usage: mcp-scraper-install [--no-color]',\n    '',\n    'Prints the branded MCP Scraper terminal install card and copyable install commands.',\n    'mcp-scraper prints the same card in a human terminal and runs as the MCP stdio server in clients.',\n    '',\n  ].join('\\n'))\n  process.exit(0)\n}\n\nprocess.stdout.write(renderInstallTerminal({\n  version: PACKAGE_VERSION,\n  color: !noColor,\n  apiKeyConfigured: Boolean(process.env.MCP_SCRAPER_API_KEY?.trim()),\n}))\n"],"mappings":";;;;AAQA,IAAM,QAAwC;AAAA,EAC5C,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,OAAO;AAAA,EACP,MAAM;AACR;AAEA,SAAS,SAAS,OAAe,MAAY,SAA0B;AACrE,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,GAAG,MAAM,IAAI,CAAC,GAAG,KAAK,GAAG,MAAM,KAAK;AAC7C;AAEA,SAAS,QAAQ,OAAe,OAAiB,SAA0B;AACzE,QAAM,SAAS,MAAM,OAAO,GAAG,GAAG;AAClC,SAAO,KAAK,SAAS,QAAQ,SAAS,OAAO,CAAC,IAAI,MAAM,KAAK,SAAS,SAAS,SAAS,OAAO,CAAC,CAAC;AACnG;AAEO,SAAS,sBAAsB,SAAyC;AAC7E,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,cAAc,QAAQ,mBAAmB,yBAAyB;AACxE,QAAM,QAAQ,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcrB,QAAM,gBAAgB;AAAA,IACpB,uBAAuB,WAAW;AAAA,IAClC;AAAA,EACF,EAAE,KAAK,IAAI;AAEX,QAAM,cAAc;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA,kCAAkC,WAAW;AAAA,EAC/C,EAAE,KAAK,IAAI;AAEX,SAAO;AAAA,IACL,SAAS,gBAAgB,QAAQ,OAAO,IAAI,QAAQ,KAAK;AAAA,IACzD,SAAS,yBAAyB,SAAS,KAAK;AAAA,IAChD,SAAS,OAAO,SAAS,KAAK;AAAA,IAC9B,GAAG,SAAS,qBAAqB,QAAQ,KAAK,CAAC,SAAS,QAAQ,OAAO;AAAA,IACvE;AAAA,IACA,SAAS,0LAA0L,QAAQ,KAAK;AAAA,IAChN;AAAA,IACA,GAAG,SAAS,SAAS,QAAQ,KAAK,CAAC,KAAK,SAAS,mBAAmB,SAAS,KAAK,CAAC;AAAA,IACnF,QAAQ,UAAU,CAAC,eAAe,eAAe,eAAe,kBAAkB,GAAG,KAAK;AAAA,IAC1F,QAAQ,WAAW,CAAC,eAAe,iBAAiB,gBAAgB,cAAc,oBAAoB,GAAG,KAAK;AAAA,IAC9G,QAAQ,SAAS,CAAC,yBAAyB,aAAa,iBAAiB,GAAG,KAAK;AAAA,IACjF,QAAQ,SAAS,CAAC,mBAAmB,sBAAsB,sBAAsB,uBAAuB,0BAA0B,6BAA6B,6BAA6B,4BAA4B,eAAe,GAAG,KAAK;AAAA,IAC/O,QAAQ,WAAW,CAAC,gBAAgB,2BAA2B,wBAAwB,iBAAiB,sBAAsB,gBAAgB,kBAAkB,uBAAuB,yBAAyB,GAAG,KAAK;AAAA,IACxN,QAAQ,WAAW,CAAC,gBAAgB,WAAW,eAAe,GAAG,KAAK;AAAA,IACtE,QAAQ,UAAU,CAAC,cAAc,cAAc,iBAAiB,eAAe,eAAe,wBAAwB,GAAG,KAAK;AAAA,IAC9H,GAAG,SAAS,aAAa,QAAQ,KAAK,CAAC,KAAK,SAAS,qBAAqB,SAAS,KAAK,CAAC;AAAA,IACzF,QAAQ,SAAS,CAAC,iBAAiB,oBAAoB,gBAAgB,iBAAiB,mBAAmB,wBAAwB,GAAG,KAAK;AAAA,IAC3I,QAAQ,OAAO,CAAC,aAAa,gBAAgB,qBAAqB,uBAAuB,kBAAkB,gBAAgB,GAAG,KAAK;AAAA,IACnI;AAAA,IACA,SAAS,eAAe,SAAS,KAAK;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG,SAAS,UAAU,QAAQ,KAAK,CAAC;AAAA,IACpC;AAAA,IACA,SAAS,gBAAgB,SAAS,KAAK;AAAA,IACvC;AAAA,IACA;AAAA,IACA,SAAS,wBAAwB,SAAS,KAAK;AAAA,IAC/C;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,iCAAiC,SAAS,KAAK;AAAA,IACxD;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,gBAAgB,SAAS,KAAK;AAAA,IACvC;AAAA,IACA;AAAA,IACA,SAAS,4BAA4B,SAAS,KAAK;AAAA,IACnD;AAAA,IACA;AAAA,IACA,SAAS,gBAAgB,SAAS,KAAK;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;;;AC/GO,IAAM,kBAAkB;;;ACI/B,IAAM,UACJ,QAAQ,KAAK,SAAS,YAAY,KAClC,QAAQ,IAAI,aAAa,UACzB,QAAQ,IAAI,gBAAgB,OAC5B,CAAC,QAAQ,OAAO;AAElB,IAAM,OAAO,QAAQ,KAAK,SAAS,QAAQ,KAAK,QAAQ,KAAK,SAAS,IAAI;AAC1E,IAAI,MAAM;AACR,UAAQ,OAAO,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI,CAAC;AACZ,UAAQ,KAAK,CAAC;AAChB;AAEA,QAAQ,OAAO,MAAM,sBAAsB;AAAA,EACzC,SAAS;AAAA,EACT,OAAO,CAAC;AAAA,EACR,kBAAkB,QAAQ,QAAQ,IAAI,qBAAqB,KAAK,CAAC;AACnE,CAAC,CAAC;","names":[]}

package/dist/bin/mcp-scraper-install.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-5HNHYUJ5.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-3RTPEQJC.js";
+} from "../chunk-F2BXETDX.js";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-stdio-server.cjs

@@ -483,7 +483,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.5.0";
+var PACKAGE_VERSION = "0.6.0";
 
 // src/mcp/browser-agent-tool-schemas.ts
 var import_zod = require("zod");
@@ -5344,7 +5344,7 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
   read it back for full detail rather than expecting the whole payload inline.
 
 ## Memory
-mcp-scraper also exposes 74 persistent per-user memory tools (notes, facts, vaults,
+mcp-scraper also exposes persistent per-user memory tools (notes, facts, vaults,
 scheduled actions, tables, channels) backed by memory.mcpscraper.dev. Every account starts with 13
 vaults \u2014 call **list-vaults** to see what exists before creating anything new. Pick the vault whose job
 matches the content: **Ideas** (unvalidated concepts), **Knowledge** (distilled lessons/how-tos),
@@ -5354,11 +5354,45 @@ matches the content: **Ideas** (unvalidated concepts), **Knowledge** (distilled
 **Improvement Log** (receipts of changes made and whether they worked), **Experiments** (hypothesis +
 measured result), **Sprint** (current cycle's scope), **Inspiration** (other people's work worth
 studying).
-Before writing, call **memory-suggest** to check whether something's already captured and to find the
-right vault's hub note to link. Use **memory-put** for narrative notes (prose, a title, a body); use
+For a normal new narrative note, call **prepare-memory-write** first. It queries the live vault contract,
+tag vocabulary, and natural neighbor vaults, and returns interlink candidates that must be read before
+acceptance. Compose every returned template section, then call **memory-capture**, which validates the
+note, registers canonical tags, writes it, and verifies readback. Reserve low-level **memory-put** for
+deliberate edits and migrations. Use
 **table-create**/**table-insert-rows**/**table-query** instead when the caller wants row-shaped data
 they'll filter/sort by exact value. **memory-search** is meaning-based over full content (embeds, slower);
 **memory-list** filters one vault by kind/tags (fast, exact).
+
+Treat every memory create or update as a graph operation. **prepare-memory-write** supplies the initial
+shortlist; use **memory-search** when it is weak or the topic is broad, and **memory-get** to read the best
+candidates in full. Add only links supported by the notes: same-
+vault targets go in props.related and natural [[path]] body links; cross-vault targets go in
+props.related_vault_notes as Vault Name::relative/path.md. Prefer existing People/Projects/system
+hubs and fewer strong links. Do not trust a background linker to repair a weak write.
+
+Use the target vault's template, not generic prose. Always set summary, specific reusable tags,
+source_type, source_ref, related, related_vault_notes, embed, embed_priority, and a valid
+status; include vault-specific props when relevant. Body patterns: Knowledge = Thesis / Explanation /
+Examples / Implications; Library = Source Identity / Preserved Material / Extraction Notes; People =
+Identity / Relationship / Known Context / Interaction History / Open Loops; Projects = Purpose / Current
+State / Architecture / Open Work / Decisions; Issues = Observation / Impact / Confirmation / Evidence /
+Resolution; Improvement Log = Improvement / Issue Link / Change Made / Verification / Result. Keep Tasks,
+Calendar, Communications, Ideas, Inspiration, Experiments, and Sprint aligned to their named purpose.
+Tags are live vocabulary, not improvised labels: **list-memory-tags** shows what exists and
+**resolve-memory-tags** returns reuse/create/omit. A new tag is justified only when the concept is central,
+reusable, and has no exact, alias, or near-equivalent. Use **memory-backlinks**,
+**memory-graph-universe**, and **memory-graph-path** to trace the linked universe across vaults.
+
+Scrape deposits are raw evidence and therefore go to **Library** through **library-ingest**, with the full
+Library template and source metadata. If the source contains durable applicable guidance, create a separate
+Knowledge companion through prepare-memory-write + memory-capture and link it to the Library source with
+derived_from; do not replace the raw source with the guide.
+
+For an update, call **memory-get** first and pass its revision as baseRevision. Preserve the existing
+title, source, capture time, content context, and props unless the request deliberately changes them.
+If a legacy backend does not return props, do not overwrite an existing linked note through that surface;
+report that link preservation cannot be proved. After the write, read it back and search a distinctive
+phrase to verify persistence and indexing.
 `.trim();
 }
 var SERVER_INSTRUCTIONS = serverInstructions(true);
@@ -7657,6 +7691,52 @@ var UnlinkShareSchema = {
     openWorldHint: false
   }
 };
+var memoryCaptureTool_notePropsSchema = import_zod4.z.object({
+  status: import_zod4.z.string().describe("Status enum value from the target vault contract."),
+  summary: import_zod4.z.string().describe("Short retrieval-ready description."),
+  tags: import_zod4.z.array(import_zod4.z.string()).describe("AI-generated keyword tags, not vault names."),
+  pinned: import_zod4.z.boolean().describe("Recall boost for important notes."),
+  source_type: import_zod4.z.string().describe("Attribution kind: user, person, url, file, channel, thread, or note."),
+  source_ref: import_zod4.z.string().describe("Attribution reference (URL, path, channel, thread, or source note)."),
+  related: import_zod4.z.array(import_zod4.z.string()).describe("Same-vault links (wiki [[ ]] targets)."),
+  related_vault_notes: import_zod4.z.array(import_zod4.z.string()).describe('Cross-vault references in "Vault Name::relative/path.md" form.'),
+  embed: import_zod4.z.boolean().describe("Whether Smart RAG should index the note."),
+  embed_priority: import_zod4.z.enum(["low", "normal", "high"]).describe("Embedding priority."),
+  embedding_summary: import_zod4.z.string().describe("Optional retrieval-specific summary."),
+  type: import_zod4.z.string().describe("Note type from the target vault contract (also used to route the note)."),
+  domain: import_zod4.z.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
+  folder: import_zod4.z.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  parentMessageId: import_zod4.z.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
+}).partial().passthrough();
+var MemoryCaptureSchema = {
+  id: "memory-capture",
+  upstreamName: "memoryCaptureTool",
+  description: "Strict normal-create path for durable memory. Refuses incomplete notes, writes through memory-put, registers canonical tags, and reads the note back to verify persisted content and props. Call prepare-memory-write first. Reserve memory-put for low-level migrations or deliberate edits.",
+  input: {
+    vault: import_zod4.z.string(),
+    folder: import_zod4.z.string().optional(),
+    path: import_zod4.z.string().min(1),
+    title: import_zod4.z.string().min(1),
+    content: import_zod4.z.string().min(1),
+    props: memoryCaptureTool_notePropsSchema,
+    baseRevision: import_zod4.z.number().optional(),
+    tagDecisions: import_zod4.z.array(import_zod4.z.object({ tag: import_zod4.z.string().min(1), central: import_zod4.z.boolean(), reusable: import_zod4.z.boolean(), description: import_zod4.z.string().optional() })).max(8).optional().describe("Required justification for any tag that does not already exist. Existing exact/alias/near tags are canonicalized automatically; a new tag is accepted only when its matching decision has central=true and reusable=true.")
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    valid: import_zod4.z.boolean().optional(),
+    errors: import_zod4.z.array(import_zod4.z.string()).optional(),
+    warnings: import_zod4.z.array(import_zod4.z.string()).optional(),
+    tagResolutions: import_zod4.z.array(import_zod4.z.object({ candidate: import_zod4.z.string(), action: import_zod4.z.enum(["reuse", "create", "omit"]), tag: import_zod4.z.string().optional(), reason: import_zod4.z.string() })).optional(),
+    note: import_zod4.z.object({ path: import_zod4.z.string(), title: import_zod4.z.string(), updatedAt: import_zod4.z.string(), revision: import_zod4.z.number() }).optional(),
+    indexed: import_zod4.z.number().optional(),
+    verified: import_zod4.z.object({ contentBytes: import_zod4.z.number(), propsPersisted: import_zod4.z.boolean(), revision: import_zod4.z.number() }).optional(),
+    conflict: import_zod4.z.boolean().optional(),
+    code: import_zod4.z.string().optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Capture Governed Memory", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+};
 var MemoryQuestionsSchema = {
   id: "memory-questions",
   upstreamName: "memoryQuestionsTool",
@@ -7686,6 +7766,67 @@ var MemoryQuestionsSchema = {
     openWorldHint: true
   }
 };
+var PrepareMemoryWriteSchema = {
+  id: "prepare-memory-write",
+  upstreamName: "prepareMemoryWriteTool",
+  description: "Mandatory planning pass for a normal new memory. Routes the note, returns the live template and natural vault relationships, resolves proposed tags against the registry, and shortlists interlink opportunities that must be read/reviewed before capture.",
+  input: {
+    title: import_zod4.z.string().min(1),
+    content: import_zod4.z.string().min(1),
+    source: import_zod4.z.string().optional(),
+    type: import_zod4.z.string().optional(),
+    vault: import_zod4.z.string().optional(),
+    tagCandidates: import_zod4.z.array(import_zod4.z.object({ tag: import_zod4.z.string().min(1), central: import_zod4.z.boolean().optional(), reusable: import_zod4.z.boolean().optional(), description: import_zod4.z.string().optional() })).max(20).optional(),
+    maxLinks: import_zod4.z.number().int().min(1).max(20).optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    route: import_zod4.z.record(import_zod4.z.unknown()).optional(),
+    contract: import_zod4.z.record(import_zod4.z.unknown()).optional(),
+    tagResolutions: import_zod4.z.array(import_zod4.z.record(import_zod4.z.unknown())).optional(),
+    linkOpportunities: import_zod4.z.array(import_zod4.z.record(import_zod4.z.unknown())).optional(),
+    instructions: import_zod4.z.array(import_zod4.z.string()).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Prepare Memory Write", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
+var validateMemoryWriteTool_notePropsSchema = import_zod4.z.object({
+  status: import_zod4.z.string().describe("Status enum value from the target vault contract."),
+  summary: import_zod4.z.string().describe("Short retrieval-ready description."),
+  tags: import_zod4.z.array(import_zod4.z.string()).describe("AI-generated keyword tags, not vault names."),
+  pinned: import_zod4.z.boolean().describe("Recall boost for important notes."),
+  source_type: import_zod4.z.string().describe("Attribution kind: user, person, url, file, channel, thread, or note."),
+  source_ref: import_zod4.z.string().describe("Attribution reference (URL, path, channel, thread, or source note)."),
+  related: import_zod4.z.array(import_zod4.z.string()).describe("Same-vault links (wiki [[ ]] targets)."),
+  related_vault_notes: import_zod4.z.array(import_zod4.z.string()).describe('Cross-vault references in "Vault Name::relative/path.md" form.'),
+  embed: import_zod4.z.boolean().describe("Whether Smart RAG should index the note."),
+  embed_priority: import_zod4.z.enum(["low", "normal", "high"]).describe("Embedding priority."),
+  embedding_summary: import_zod4.z.string().describe("Optional retrieval-specific summary."),
+  type: import_zod4.z.string().describe("Note type from the target vault contract (also used to route the note)."),
+  domain: import_zod4.z.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
+  folder: import_zod4.z.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  parentMessageId: import_zod4.z.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
+}).partial().passthrough();
+var ValidateMemoryWriteSchema = {
+  id: "validate-memory-write",
+  upstreamName: "validateMemoryWriteTool",
+  description: "Validate a proposed governed note without writing it. Checks template completeness, vault status/type, canonical tag count, attribution, Obsidian link primitives, and retrieval metadata.",
+  input: {
+    vault: import_zod4.z.string(),
+    title: import_zod4.z.string(),
+    content: import_zod4.z.string(),
+    props: validateMemoryWriteTool_notePropsSchema
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    valid: import_zod4.z.boolean().optional(),
+    errors: import_zod4.z.array(import_zod4.z.string()).optional(),
+    warnings: import_zod4.z.array(import_zod4.z.string()).optional(),
+    normalizedTags: import_zod4.z.array(import_zod4.z.string()).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Validate Memory Write", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
 var CreateChannelSchema = {
   id: "create-channel",
   upstreamName: "createChannelTool",
@@ -8026,18 +8167,78 @@ var RecordFactSchema = {
     openWorldHint: false
   }
 };
+var NoteBacklinksSchema = {
+  id: "memory-backlinks",
+  upstreamName: "noteBacklinksTool",
+  description: "Return every resolved incoming link to a note across all accessible vaults, including typed metadata links and Obsidian wiki links.",
+  input: {
+    note: import_zod4.z.string().min(1),
+    vault: import_zod4.z.string().optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    nodes: import_zod4.z.array(import_zod4.z.object({ id: import_zod4.z.string(), vault: import_zod4.z.string(), path: import_zod4.z.string(), title: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    edges: import_zod4.z.array(import_zod4.z.object({ source: import_zod4.z.string(), target: import_zod4.z.string(), type: import_zod4.z.string(), evidence: import_zod4.z.string(), sourceField: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Memory Backlinks", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
+var GraphPathSchema = {
+  id: "memory-graph-path",
+  upstreamName: "graphPathTool",
+  description: "Find the shortest navigable connection between two memory notes across vault boundaries. Returns an empty graph when no path exists within maxDepth.",
+  input: {
+    from: import_zod4.z.string().min(1),
+    to: import_zod4.z.string().min(1),
+    fromVault: import_zod4.z.string().optional(),
+    toVault: import_zod4.z.string().optional(),
+    maxDepth: import_zod4.z.number().int().min(1).max(12).optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    nodes: import_zod4.z.array(import_zod4.z.object({ id: import_zod4.z.string(), vault: import_zod4.z.string(), path: import_zod4.z.string(), title: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    edges: import_zod4.z.array(import_zod4.z.object({ source: import_zod4.z.string(), target: import_zod4.z.string(), type: import_zod4.z.string(), evidence: import_zod4.z.string(), sourceField: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Memory Graph Path", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
+var GraphUniverseSchema = {
+  id: "memory-graph-universe",
+  upstreamName: "graphUniverseTool",
+  description: "Traverse the interlinked memory universe around one note in every direction, like an Obsidian local graph. Returns nodes and typed edges to a bounded depth.",
+  input: {
+    note: import_zod4.z.string().min(1),
+    vault: import_zod4.z.string().optional(),
+    depth: import_zod4.z.number().int().min(0).max(6).optional(),
+    maxNodes: import_zod4.z.number().int().min(1).max(500).optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    root: import_zod4.z.string().optional(),
+    depth: import_zod4.z.number().optional(),
+    truncated: import_zod4.z.boolean().optional(),
+    nodes: import_zod4.z.array(import_zod4.z.object({ id: import_zod4.z.string(), vault: import_zod4.z.string(), path: import_zod4.z.string(), title: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    edges: import_zod4.z.array(import_zod4.z.object({ source: import_zod4.z.string(), target: import_zod4.z.string(), type: import_zod4.z.string(), evidence: import_zod4.z.string(), sourceField: import_zod4.z.string(), resolved: import_zod4.z.boolean() })).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Memory Graph Universe", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
 var LibraryIngestSchema = {
   id: "library-ingest",
   upstreamName: "libraryIngestTool",
   description: "Deposit a scrape, transcript, or generated output into the tenant Library vault for later semantic recall. Content is embedded for per-tenant search and best-effort mirrored to a local vault when configured. Requires write scope on the target vault.",
   input: {
     vault: import_zod4.z.string().optional().describe(
-      'Vault to deposit into. Optional; defaults to the session active vault, then the first entitled vault, then "Library".'
+      "Vault to deposit into. Optional and normally omitted: raw scrapes always default to Library. Override only for a deliberate nonstandard migration."
     ),
     title: import_zod4.z.string().min(1).describe("Short human-readable title for the item; used to build the stored path. Must be non-empty."),
     content: import_zod4.z.string().min(1).describe("The full captured text (scrape/transcript/output) to store and index. Must be non-empty."),
     source: import_zod4.z.string().min(1).describe("Provenance of the content, e.g. a URL or tool name. Must be non-empty."),
     capturedAt: import_zod4.z.string().optional().describe("ISO-8601 capture timestamp. Optional; defaults to now. Also seeds the deterministic storage path."),
+    summary: import_zod4.z.string().optional().describe("Retrieval-ready source summary. Optional; a provenance summary is generated when omitted."),
+    tags: import_zod4.z.array(import_zod4.z.string()).max(8).optional().describe("Reviewed canonical tags. Existing tags should be resolved first; when omitted, deterministic source/topic tags are generated."),
+    related: import_zod4.z.array(import_zod4.z.string()).optional().describe("Reviewed same-vault Library note paths."),
+    relatedVaultNotes: import_zod4.z.array(import_zod4.z.string()).optional().describe("Reviewed cross-vault references in Vault::path.md form."),
     localVaultPath: import_zod4.z.string().optional().describe("Filesystem root to also mirror the item to. Optional; falls back to MEMORY_LOCAL_VAULT_ROOT env when set.")
   },
   output: {
@@ -8047,6 +8248,7 @@ var LibraryIngestSchema = {
     path: import_zod4.z.string().optional().describe("Vault-relative path the item was stored at (under library/...)."),
     indexed: import_zod4.z.number().optional().describe("Number of search chunks indexed (0 if embedding failed but the note still saved)."),
     dualWritten: import_zod4.z.boolean().optional().describe("True if the item was also mirrored to the local filesystem vault."),
+    nextStep: import_zod4.z.string().optional().describe("Recommended extraction action after the raw Library source is safe."),
     code: import_zod4.z.string().optional().describe("Machine-readable denial code when ok is false: quota_exceeded or free_cost_cap."),
     error: import_zod4.z.string().optional().describe("Human-readable failure reason when ok is false.")
   },
@@ -8124,10 +8326,27 @@ var ExportSchema = {
     openWorldHint: false
   }
 };
+var getTool_notePropsSchema = import_zod4.z.object({
+  status: import_zod4.z.string().describe("Status enum value from the target vault contract."),
+  summary: import_zod4.z.string().describe("Short retrieval-ready description."),
+  tags: import_zod4.z.array(import_zod4.z.string()).describe("AI-generated keyword tags, not vault names."),
+  pinned: import_zod4.z.boolean().describe("Recall boost for important notes."),
+  source_type: import_zod4.z.string().describe("Attribution kind: user, person, url, file, channel, thread, or note."),
+  source_ref: import_zod4.z.string().describe("Attribution reference (URL, path, channel, thread, or source note)."),
+  related: import_zod4.z.array(import_zod4.z.string()).describe("Same-vault links (wiki [[ ]] targets)."),
+  related_vault_notes: import_zod4.z.array(import_zod4.z.string()).describe('Cross-vault references in "Vault Name::relative/path.md" form.'),
+  embed: import_zod4.z.boolean().describe("Whether Smart RAG should index the note."),
+  embed_priority: import_zod4.z.enum(["low", "normal", "high"]).describe("Embedding priority."),
+  embedding_summary: import_zod4.z.string().describe("Optional retrieval-specific summary."),
+  type: import_zod4.z.string().describe("Note type from the target vault contract (also used to route the note)."),
+  domain: import_zod4.z.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
+  folder: import_zod4.z.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  parentMessageId: import_zod4.z.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
+}).partial().passthrough();
 var GetSchema = {
   id: "memory-get",
   upstreamName: "getTool",
-  description: "Read a single note from a vault by its exact path, or by shareId for a note shared with you and accepted. Returns a revision number \u2014 pass it as baseRevision on a later memory-put/delete-note to detect a concurrent edit instead of silently overwriting it. Requires read scope.",
+  description: "Read a single note from a vault by its exact path, or by shareId for a note shared with you and accepted. Owned notes include their stored Obsidian props so edits can preserve links and template metadata. Returns a revision number \u2014 pass it as baseRevision on a later memory-put/delete-note to detect a concurrent edit instead of silently overwriting it. Requires read scope.",
   input: {
     vault: import_zod4.z.string().optional().describe(
       "Vault to read from. Optional; defaults to the session active vault, then the first vault the caller is entitled to. Ignored when shareId is given."
@@ -8147,6 +8366,7 @@ var GetSchema = {
       capturedAt: import_zod4.z.string().describe("ISO-8601 timestamp of when the note was first captured."),
       revision: import_zod4.z.number().describe("Current revision number. Pass this as baseRevision when editing, so a concurrent edit by someone else is detected instead of silently overwritten."),
       updatedBy: import_zod4.z.string().nullable().describe("Identity that made the last write, if known."),
+      props: getTool_notePropsSchema.optional().describe("Stored Obsidian metadata for an owned note, including links and vault-specific template fields. Omitted for secure or individually shared notes."),
       sharedBy: import_zod4.z.string().optional().describe("Present only when read via shareId: the identity who owns and shared this note."),
       othersEditing: import_zod4.z.array(import_zod4.z.string()).optional().describe("Advisory only, not a lock: identities who read this same note within the last ~2 minutes and may be about to edit it. Worth a heads-up to the human before you write; the real safety net is still baseRevision on the write itself.")
     }).optional().describe("The full note. Present when ok is true."),
@@ -8194,7 +8414,7 @@ var ListSchema = {
     openWorldHint: false
   }
 };
-var notePropsSchema = import_zod4.z.object({
+var putTool_notePropsSchema = import_zod4.z.object({
   status: import_zod4.z.string().describe("Status enum value from the target vault contract."),
   summary: import_zod4.z.string().describe("Short retrieval-ready description."),
   tags: import_zod4.z.array(import_zod4.z.string()).describe("AI-generated keyword tags, not vault names."),
@@ -8210,7 +8430,7 @@ var notePropsSchema = import_zod4.z.object({
   domain: import_zod4.z.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
   folder: import_zod4.z.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
   parentMessageId: import_zod4.z.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
-}).partial();
+}).partial().passthrough();
 var PutSchema = {
   id: "memory-put",
   upstreamName: "putTool",
@@ -8223,7 +8443,7 @@ var PutSchema = {
     shareId: import_zod4.z.string().optional().describe("Edit a note someone individually shared with you and you accepted (accept-share), by its shareId, instead of vault+path. Requires the share to grant edit permission, and baseRevision is mandatory (get the current revision first) since you are editing alongside the owner and possibly others."),
     title: import_zod4.z.string().optional().describe("Optional human-readable title; defaults are derived from the path when omitted."),
     content: import_zod4.z.string().min(1).describe("The full note body to store and index for semantic search. Must be non-empty."),
-    props: notePropsSchema.optional().describe("Obsidian note primitives (status, summary, tags, pinned, source_type, source_ref, related, related_vault_notes, embed, embed_priority, type, domain, folder). Stored on the note so it round-trips the vault shape; type/domain/folder also steer routing when no vault is given."),
+    props: putTool_notePropsSchema.optional().describe("Obsidian note primitives plus vault-specific template fields. On edits, supplied fields patch the stored props instead of replacing the whole object; pass an empty array to deliberately clear a link list. Type/domain/folder also steer routing when no vault is given."),
     baseRevision: import_zod4.z.number().optional().describe("Revision the edit is based on (from a prior get/put). When provided, the write only applies if the note is still at this revision; otherwise it is rejected as a conflict instead of silently overwriting a concurrent edit. Omit for last-write-wins (fine for solo notes).")
   },
   output: {
@@ -8837,6 +9057,51 @@ var QueryTableSchema = {
     openWorldHint: false
   }
 };
+var ListTagsSchema = {
+  id: "list-memory-tags",
+  upstreamName: "listTagsTool",
+  description: "List the live canonical tag vocabulary, aliases, usage counts, and per-vault distribution. Use this before choosing tags so existing concepts are reused instead of fragmented.",
+  input: {
+    includeDeprecated: import_zod4.z.boolean().optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    tags: import_zod4.z.array(import_zod4.z.object({ tag: import_zod4.z.string(), description: import_zod4.z.string().nullable(), aliases: import_zod4.z.array(import_zod4.z.string()), status: import_zod4.z.enum(["active", "deprecated"]), usageCount: import_zod4.z.number(), vaultUsage: import_zod4.z.record(import_zod4.z.number()) })).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "List Memory Tags", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
+var ResolveTagsSchema = {
+  id: "resolve-memory-tags",
+  upstreamName: "resolveTagsTool",
+  description: "Resolve proposed concepts against the live tag vocabulary. Returns reuse, create, or omit. A new tag is allowed only when no equivalent exists and the caller marks the concept central and reusable.",
+  input: {
+    candidates: import_zod4.z.array(import_zod4.z.object({ tag: import_zod4.z.string().min(1), central: import_zod4.z.boolean().optional(), reusable: import_zod4.z.boolean().optional(), description: import_zod4.z.string().optional() })).min(1).max(20)
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    resolutions: import_zod4.z.array(import_zod4.z.object({ candidate: import_zod4.z.string(), normalized: import_zod4.z.string(), action: import_zod4.z.enum(["reuse", "create", "omit"]), tag: import_zod4.z.string().optional(), matchedBy: import_zod4.z.enum(["exact", "alias", "near"]).optional(), score: import_zod4.z.number().optional(), reason: import_zod4.z.string() })).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Resolve Memory Tags", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
+var UpsertTagSchema = {
+  id: "upsert-memory-tag",
+  upstreamName: "upsertTagTool",
+  description: "Define or curate one canonical tag, its meaning, aliases, and lifecycle. Use only after resolve-memory-tags returns create, or to merge/deprecate vocabulary intentionally. Requires write scope.",
+  input: {
+    tag: import_zod4.z.string().min(1),
+    description: import_zod4.z.string().optional(),
+    aliases: import_zod4.z.array(import_zod4.z.string()).optional(),
+    status: import_zod4.z.enum(["active", "deprecated"]).optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    tag: import_zod4.z.object({ tag: import_zod4.z.string(), description: import_zod4.z.string().nullable(), aliases: import_zod4.z.array(import_zod4.z.string()), status: import_zod4.z.enum(["active", "deprecated"]) }).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Upsert Memory Tag", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
 var AddVaultSchema = {
   id: "add-vault",
   upstreamName: "addVaultTool",
@@ -8904,6 +9169,21 @@ var DeleteVaultSchema = {
     openWorldHint: false
   }
 };
+var GetVaultContractSchema = {
+  id: "get-vault-contract",
+  upstreamName: "getVaultContractTool",
+  description: "Read the machine-enforced purpose, template, statuses, types, natural neighbor vaults, and typed relationship guidance for one of the 13 governed Obsidian-style vaults. Call before composing a note when the correct shape is uncertain.",
+  input: {
+    vault: import_zod4.z.string().describe("One governed vault: Ideas, Inspiration, Knowledge, Library, People, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, or Sprint.")
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    vault: import_zod4.z.string().optional(),
+    contract: import_zod4.z.record(import_zod4.z.unknown()).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Get Vault Contract", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
 var ListSharedWithMeSchema = {
   id: "list-shared-with-me",
   upstreamName: "listSharedWithMeTool",
@@ -8988,6 +9268,26 @@ var ProvisionDefaultsSchema = {
     openWorldHint: false
   }
 };
+var RouteMemorySchema = {
+  id: "route-memory",
+  upstreamName: "routeMemoryTool",
+  description: "Choose the correct governed vault and folder from content intent. Raw scraped/source material routes to Library; distilled applicable guidance routes to Knowledge. Returns the live vault contract so the result does not depend on prompt memory.",
+  input: {
+    title: import_zod4.z.string().min(1),
+    content: import_zod4.z.string().min(1),
+    type: import_zod4.z.string().optional(),
+    source: import_zod4.z.string().optional()
+  },
+  output: {
+    ok: import_zod4.z.boolean(),
+    vault: import_zod4.z.string().optional(),
+    folder: import_zod4.z.string().optional(),
+    reason: import_zod4.z.string().optional(),
+    contract: import_zod4.z.record(import_zod4.z.unknown()).optional(),
+    error: import_zod4.z.string().optional()
+  },
+  annotations: { title: "Route Memory", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+};
 var VideoAnalyzeStartSchema = {
   id: "video-analyze-start",
   upstreamName: "videoAnalyzeStartTool",
@@ -9110,7 +9410,10 @@ var MEMORY_TOOL_SCHEMAS = [
   SwapVaultSchema,
   SwitchAccountSchema,
   UnlinkShareSchema,
+  MemoryCaptureSchema,
   MemoryQuestionsSchema,
+  PrepareMemoryWriteSchema,
+  ValidateMemoryWriteSchema,
   CreateChannelSchema,
   GetMessageNoteSchema,
   ListChannelMembersSchema,
@@ -9123,6 +9426,9 @@ var MEMORY_TOOL_SCHEMAS = [
   ReplyMessageSchema,
   FactHistorySchema,
   RecordFactSchema,
+  NoteBacklinksSchema,
+  GraphPathSchema,
+  GraphUniverseSchema,
   LibraryIngestSchema,
   DeleteNoteSchema,
   ExportSchema,
@@ -9152,12 +9458,17 @@ var MEMORY_TOOL_SCHEMAS = [
   InsertTableRowsSchema,
   ListTablesSchema,
   QueryTableSchema,
+  ListTagsSchema,
+  ResolveTagsSchema,
+  UpsertTagSchema,
   AddVaultSchema,
   CreateSecureVaultSchema,
   DeleteVaultSchema,
+  GetVaultContractSchema,
   ListSharedWithMeSchema,
   ListVaultsSchema,
   ProvisionDefaultsSchema,
+  RouteMemorySchema,
   VideoAnalyzeStartSchema,
   VideoAnalyzeStatusSchema,
   CreateWebhookSchema,