mcp-scraper 0.30.0 → 0.32.0

package/README.md

@@ -88,7 +88,7 @@ Build the branded one-click bundle:
 npm run build:mcpb
 ```
 
-The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.30.0`, SHA-256 `848ebe2ac12ea4fdd08ae95d368ca537eaf8a1bbd32456baff7a8c2c817e457b`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
+The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.32.0`, SHA-256 `f31500fa60ffa96d2bea43feb4f5606a40fdc59b599dd51a11b8a54e5c9bce32`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
 
 The MCPB install exposes every tool — web-intelligence plus all `browser_*` tools — through the one `mcp-scraper` server.
 

package/dist/bin/api-server.cjs

@@ -13834,6 +13834,15 @@ function positiveIntFromEnv(name, fallback) {
 function proxyIdSuffix(proxyId) {
   return proxyId ? proxyId.slice(-6) : null;
 }
+function serpArrivalUrl(googleUrl) {
+  const base = process.env.SERP_REDIRECT_BASE?.trim().replace(/\/+$/, "");
+  if (!base) return googleUrl;
+  return `${base}/g/${Buffer.from(googleUrl, "utf8").toString("base64url")}`;
+}
+function isUsCountry(country) {
+  if (!country) return false;
+  return /united states|u\.?s\.?a?\.?|^us$/i.test(country.trim());
+}
 function errorText(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -13988,7 +13997,7 @@ var init_BrowserDriver = __esm({
           this.kernelProxyType = config.kernelProxyResolution?.proxyType ?? null;
           let defaultProxyDisabled = null;
           let defaultProxyDisableError = null;
-          if (!config.kernelProxyId) {
+          if (!config.kernelProxyId && !config.keepDefaultProxy) {
             try {
               await withTimeout2(
                 this.kernelClient.browsers.update(this.kernelSessionId, { disable_default_proxy: true }),
@@ -14038,9 +14047,15 @@ var init_BrowserDriver = __esm({
           await this.installEsbuildHelperShims(this.context);
           this.page = await this.context.newPage();
           await this.page.setViewportSize(config.viewport);
-          if (this.debugEnabled) {
+          if (this.debugEnabled || config.requireUsEgress) {
             this.debugSnapshot.networkLocation = await this.captureBrowserNetworkLocation();
           }
+          if (config.requireUsEgress) {
+            const country = this.debugSnapshot.networkLocation?.country ?? null;
+            if (!isUsCountry(country)) {
+              throw new CaptchaError(`Non-US egress (${country ?? "unknown"}) \u2014 retrying with a fresh session`);
+            }
+          }
           return;
         }
         const launchOpts = {
@@ -14180,6 +14195,7 @@ var init_BrowserDriver = __esm({
         if (options?.num) params.set("num", String(options.num));
         if (uule) params.set("uule", uule);
         const url = "https://www.google.com/search?" + params.toString();
+        const navUrl = serpArrivalUrl(url);
         const navDebug = options?.debug ? {
           requestedUrl: url,
           finalUrl: null,
@@ -14192,7 +14208,7 @@ var init_BrowserDriver = __esm({
         } : null;
         if (navDebug) this.debugSnapshot.serpNavigation = navDebug;
         try {
-          await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: 45e3 });
+          await this.page.goto(navUrl, { waitUntil: "domcontentloaded", timeout: 45e3 });
         } catch (err) {
           await this.updateSerpNavigationDebug(navDebug, url, { hasPaa: null, captchaDetected: null });
           const diag = await this.captureDiagnostics(url);
@@ -17339,6 +17355,9 @@ var init_schemas3 = __esm({
       device: import_zod17.z.enum(["desktop", "mobile"]).default("desktop"),
       proxyMode: import_zod17.z.enum(["location", "configured", "none"]).default(DEFAULT_PROXY_MODE),
       proxyZip: import_zod17.z.string().regex(/^\d{5}$/).optional(),
+      keepDefaultProxy: import_zod17.z.boolean().optional(),
+      requireUsEgress: import_zod17.z.boolean().optional(),
+      maxAttempts: import_zod17.z.number().int().min(1).max(12).optional(),
       debug: import_zod17.z.boolean().default(false),
       depth: import_zod17.z.number().int().min(1).max(30).default(3),
       maxQuestions: import_zod17.z.number().int().min(1).max(1e3).default(100),
@@ -19235,6 +19254,12 @@ function buildGoogleLocalResultsUrl(input) {
   if (input.location) params.set("uule", encodeUule(normalizeLocation(input.location)));
   return `https://www.google.com/search?${params.toString()}`;
 }
+function buildGoogleOrganicSearchUrl(input) {
+  const query = [input.query, input.location].filter(Boolean).join(" ");
+  const params = new URLSearchParams({ q: query, gl: input.gl, hl: input.hl, pws: "0" });
+  if (input.location) params.set("uule", encodeUule(normalizeLocation(input.location)));
+  return `https://www.google.com/search?${params.toString()}`;
+}
 var LOCAL_RESULTS_PAGE_LIMIT, LOCAL_RESULTS_WAIT_MS, MapsSearchExtractor;
 var init_MapsSearchExtractor = __esm({
   "src/extractor/MapsSearchExtractor.ts"() {
@@ -19251,13 +19276,14 @@ var init_MapsSearchExtractor = __esm({
       async extract(options) {
         const startMs = Date.now();
         const searchQuery = [options.query, options.location].filter(Boolean).join(" ");
-        const searchUrl = buildGoogleLocalResultsUrl(options);
+        const searchUrl = buildGoogleOrganicSearchUrl(options);
         const config = {
           headless: options.headless,
           kernelApiKey: options.kernelApiKey,
           kernelProxyId: options.kernelProxyId,
           kernelProxyResolution: options.kernelProxyResolution,
           proxyMode: options.proxyMode,
+          keepDefaultProxy: options.proxyMode !== "location" && options.proxyMode !== "configured" && !options.kernelProxyId,
           viewport: { width: 1280, height: 900 },
           locale: `${options.hl}-${options.gl.toUpperCase()}`,
           debug: options.debug
@@ -19268,6 +19294,10 @@ var init_MapsSearchExtractor = __esm({
           await page.goto(searchUrl, { waitUntil: "domcontentloaded", timeout: 6e4 });
           await page.waitForTimeout(LOCAL_RESULTS_WAIT_MS);
           if (await this.detectBlock(page)) throw new CaptchaError(RECAPTCHA_INSTRUCTIONS);
+          const reachedFinder = await this.clickIntoLocalFinder(page);
+          if (!reachedFinder) throw new ExtractionError('Google "More businesses" control was not found on the organic results page');
+          await page.waitForTimeout(LOCAL_RESULTS_WAIT_MS);
+          if (await this.detectBlock(page)) throw new CaptchaError(RECAPTCHA_INSTRUCTIONS);
           const results = await this.collectResults(page, options);
           return {
             query: options.query,
@@ -19284,6 +19314,17 @@ var init_MapsSearchExtractor = __esm({
           await this.driver.close();
         }
       }
+      async clickIntoLocalFinder(page) {
+        const control = page.getByRole("link", { name: /more (businesses|places|results)/i }).or(page.getByRole("button", { name: /more (businesses|places|results)/i })).first();
+        const visible = await control.isVisible({ timeout: 1e4 }).catch(() => false);
+        if (!visible) return false;
+        await control.click({ timeout: 1e4 }).catch(() => {
+        });
+        await page.waitForTimeout(5e3);
+        return page.evaluate(
+          () => /[?&]udm=1/.test(location.href) || document.querySelectorAll('a[href*="/maps/place/"]').length > 0
+        );
+      }
       async detectBlock(page) {
         return page.evaluate(() => {
           const text2 = document.body.innerText.slice(0, 2e3);
@@ -28145,6 +28186,8 @@ var init_PAAExtractor = __esm({
           kernelProxyId: options.kernelProxyId,
           kernelProxyResolution: options.kernelProxyResolution,
           proxyMode: options.proxyMode,
+          keepDefaultProxy: options.keepDefaultProxy,
+          requireUsEgress: options.requireUsEgress,
           viewport: isMobile ? { width: 390, height: 844 } : { width: 1280, height: 800 },
           locale: `${options.hl}-${options.gl.toUpperCase()}`,
           userAgent: isMobile ? MOBILE_USER_AGENT2 : DESKTOP_USER_AGENT2,
@@ -28645,7 +28688,8 @@ async function harvest(rawOptions) {
   };
   const requestedDebug = typeof raw.debug === "boolean" ? raw.debug : false;
   const needsLocationEvidence = proxyMode === "location" && Boolean(proxyOpts.location);
-  const maxAttempts = maxAttemptsForProxyMode(proxyMode) + 1;
+  const requestedMaxAttempts = raw.maxAttempts;
+  const maxAttempts = typeof requestedMaxAttempts === "number" && Number.isInteger(requestedMaxAttempts) && requestedMaxAttempts >= 1 ? requestedMaxAttempts : maxAttemptsForProxyMode(proxyMode) + 1;
   const serializer = new OutputSerializer();
   let lastError = null;
   let effectiveProxyMode = proxyMode;
@@ -29723,7 +29767,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.30.0";
+    PACKAGE_VERSION = "0.32.0";
   }
 });
 
@@ -29845,18 +29889,19 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
 
 ## Memory
 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 15
+scheduled actions, tables, channels) backed by memory.mcpscraper.dev. Every account starts with 16
 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),
-**Library** (raw source material \u2014 articles, transcripts), **People** (one durable note per person/org),
-**Deals** (commercial opportunities tied to a known person or organization), **Communications** (individual
+**Library** (raw source material \u2014 articles, transcripts), **People** (one durable note per real person),
+**Organizations** (one durable hub per company or organization \u2014 never a person),
+**Deals** (commercial opportunities tied to a known organization or person), **Communication** (individual
 conversation records and drafts), **Calendar** (time-anchored entries), **Tasks** (independent Inbox action items
 that may link to a known Project), **Projects** (only codebases, known client projects, personal projects, or ongoing siloed
 workstreams), **Issues** (something broken),
 **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
+measured result), **Sprint** (current cycle's scope), **Examples and Inspirations** (other people's work worth
 studying), **Skills** (reusable skill packages; each requires \`scripts/\` and at least one of
-\`references/\` or \`templates/\`, and may use both).
+\`references/\` or \`templates/\`, and may use both). The former names Inspiration and Communications still resolve.
 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
@@ -29875,7 +29920,7 @@ compatibility value when the template asks for it); Tasks can be independent Inb
 project name; and email drafts awaiting human review need \`direction:"draft"\` with
 \`approval_state:"pending"\`. Link a known person, project, deal, or communication only when verified.
 When the user asks to add Gmail or Google Calendar evidence from a connected account, first resolve the
-existing People hub. Persist Gmail as one linked **Communications** email and Calendar as one linked
+existing People hub. Persist Gmail as one linked **Communication** email and Calendar as one linked
 **Calendar** event, each with the provider's stable reference and \`person_refs\`; do not create a person
 from a subject line, infer attendees, or silently bulk-import a mailbox/calendar. If a relationship is requested but not clear, ask the user rather than inventing one. Overview is the review queue: editing leaves a draft pending, and
 approval or denial records a state only\u2014it does not send email.
@@ -30354,9 +30399,9 @@ var init_mcp_tool_schemas = __esm({
       gl: import_zod35.z.string().length(2).default("us").describe("Google country code inferred from location."),
       hl: import_zod35.z.string().length(2).default("en").describe("Language inferred from user request."),
       maxResults: import_zod35.z.number().int().min(1).max(50).default(10).describe("Number of candidates to return. Default 10, maximum 50."),
-      includeServices: import_zod35.z.boolean().default(false).describe("Open each returned Google Business Profile and include configured services and areas served when available. Does not collect review cards."),
-      proxyMode: import_zod35.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Leave unset for the default direct browser route. Google localization comes from the city in the query plus UULE, gl, and hl. location is an explicit residential-proxy override."),
-      proxyZip: import_zod35.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override when proxyMode is location."),
+      includeServices: import_zod35.z.boolean().default(false).describe("Open each returned business profile to include its configured services and areas served when available. Adds a page visit per business; does not collect review cards."),
+      proxyMode: import_zod35.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Leave unset for the default route (stealth browser on the managed ISP proxy, retried on a fresh session when Google blocks). Localization comes from the city in the query plus gl/hl. location forces an explicit residential proxy \u2014 not recommended for Google."),
+      proxyZip: import_zod35.z.string().regex(/^\d{5}$/).optional().describe("Optional US ZIP override, only used when proxyMode is location."),
       debug: import_zod35.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics.")
     };
     DirectoryWorkflowInputSchema = {
@@ -30370,7 +30415,7 @@ var init_mcp_tool_schemas = __esm({
       includeZipGroups: import_zod35.z.boolean().default(true).describe("Attach ZIP groups from a configured US ZIPS CSV when available (MCP_SCRAPER_USZIPS_CSV_PATH or usZipsCsvPath)."),
       usZipsCsvPath: import_zod35.z.string().optional().describe("Local/test-only path to a US ZIPS CSV (state_abbr, zipcode, county, city columns). Deployed APIs should use MCP_SCRAPER_USZIPS_CSV_PATH instead. For ZIP enrichment, set MCP_SCRAPER_USZIPS_CSV_PATH on the server, or pass this in local/test mode."),
       saveCsv: import_zod35.z.boolean().default(true).describe("Save a directory-ready CSV of results to the MCP Scraper output directory and return its path."),
-      proxyMode: import_zod35.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy behavior per city search. Leave unset for the direct localized Google route; location is an explicit residential-proxy override."),
+      proxyMode: import_zod35.z.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE).describe("Proxy behavior per city search. Leave unset for the default route (stealth browser on the managed ISP proxy, retried fresh on a Google block). location forces an explicit residential proxy \u2014 not recommended for Google."),
       proxyZip: import_zod35.z.string().regex(/^\d{5}$/).optional().describe("Optional ZIP override for proxy targeting; normally omitted."),
       debug: import_zod35.z.boolean().default(false).describe("Include sanitized browser/proxy diagnostics.")
     };
@@ -32190,7 +32235,7 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => formatMapsPlaceIntel(await executor.mapsPlaceIntel(input), input));
   server.registerTool("maps_search", {
     title: "Google Maps Business Search",
-    description: "Search Google local results for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. It paginates the rendered local-results list, opens each exact business card, then closes the profile dialog before continuing. Set includeServices for services and areas served; review cards are never collected by this tool.",
+    description: "Search Google local results for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. Reaches the local-results list from the organic page and paginates it, returning up to 50 candidates (default 10) with names, place URLs, CIDs, and ratings. Leave proxyMode unset. Set includeServices to also open each business profile for its services and areas served; review cards are never collected by this tool.",
     inputSchema: MapsSearchInputSchema,
     outputSchema: recordOutputSchema("maps_search", MapsSearchOutputSchema),
     annotations: liveWebToolAnnotations("Google Maps Business Search")
@@ -34479,7 +34524,7 @@ var init_memory_tool_schemas = __esm({
     GetChatLinkSchema = {
       id: "get-chat-link",
       upstreamName: "getChatLinkTool",
-      description: "Get your durable, bookmarkable link to the hosted Omni-Chat page \u2014 a login-free chat UI for every channel you're in. The embedded secret is shown only once, on first call; it cannot be re-shown, only revoked and reissued via revoke-chat-link. Anyone holding the link can post as you.",
+      description: "Get your durable, bookmarkable link to the hosted Inbox chat page \u2014 a login-free chat UI for every channel you're in. The embedded secret is shown only once, on first call; it cannot be re-shown, only revoked and reissued via revoke-chat-link. Anyone holding the link can post as you.",
       input: {},
       output: {
         ok: import_zod37.z.boolean().describe("True on success; false on auth error."),
@@ -34498,7 +34543,7 @@ var init_memory_tool_schemas = __esm({
     GetVaultAppLinkSchema = {
       id: "get-vault-app-link",
       upstreamName: "getVaultAppLinkTool",
-      description: "Get the durable, bookmarkable link to the mobile-first Vault App for People, Projects, and Tasks. The embedded secret is shown only once; revoke-vault-app-link then call this tool again to replace a link that was shared or leaked. This link is independent from Omni-Chat. Anyone holding it can use the Vault App as this identity.",
+      description: "Get the durable, bookmarkable link to the mobile-first Vault App for People, Projects, and Tasks. The embedded secret is shown only once; revoke-vault-app-link then call this tool again to replace a link that was shared or leaked. This link is independent from the Inbox chat link. Anyone holding it can use the Vault App as this identity.",
       input: {},
       output: {
         ok: import_zod37.z.boolean().describe("True when the request succeeded."),
@@ -34765,7 +34810,7 @@ var init_memory_tool_schemas = __esm({
     RevokeVaultAppLinkSchema = {
       id: "revoke-vault-app-link",
       upstreamName: "revokeVaultAppLinkTool",
-      description: "Immediately revoke the current Vault App link without touching the separate Omni-Chat link. Call get-vault-app-link afterward to mint a replacement.",
+      description: "Immediately revoke the current Vault App link without touching the separate Inbox chat link. Call get-vault-app-link afterward to mint a replacement.",
       input: {},
       output: {
         ok: import_zod37.z.boolean().describe("True when the request succeeded."),
@@ -34979,7 +35024,7 @@ var init_memory_tool_schemas = __esm({
     MemoryCaptureSchema = {
       id: "memory-capture",
       upstreamName: "memoryCaptureTool",
-      description: "Strict normal-create path for durable memory. Before capture, list the complete tag vocabulary, call prepare-memory-write, run hybrid memory-search for related notes, and read the strongest link candidates. This tool refuses incomplete notes and invalid relationship-domain writes: projects need a project kind, tasks can be independent Inbox todos or link a verified project, deals need a known party, and draft emails need a pending approval state. It writes through memory-put, registers canonical tags, and verifies persisted content and props. Reserve memory-put for low-level migrations or deliberate edits.",
+      description: "Strict normal-create path for durable memory. Before capture, list the complete tag vocabulary, call prepare-memory-write, run hybrid memory-search for related notes, and read the strongest link candidates. This tool refuses incomplete notes and invalid relationship-domain writes: projects need a project kind, tasks may be independent Inbox todos but must use a matched project when linked, deals need a known party, and draft emails need a pending approval state. It writes through memory-put, registers canonical tags, and verifies persisted content and props. Reserve memory-put for low-level migrations or deliberate edits.",
       input: {
         vault: import_zod37.z.string(),
         folder: import_zod37.z.string().optional(),
@@ -35037,7 +35082,7 @@ var init_memory_tool_schemas = __esm({
     PrepareMemoryWriteSchema = {
       id: "prepare-memory-write",
       upstreamName: "prepareMemoryWriteTool",
-      description: "Mandatory planning pass for a normal new memory. First inspect the complete tag vocabulary with list-memory-tags; then this pass routes the note, returns the live template and natural vault relationships, resolves proposed tags, and shortlists interlinks. For People, Deals, Projects, Tasks, and Communications, it also returns relationship and approval guidance: a Task may be an independent Inbox todo, so search existing records only before adding a requested project or party link and never invent one. Use hybrid memory-search (3 focused queries, 50 fused candidates, bounded graph expansion, rerank to 30 by default) and read strong related notes before capture. This is an explicit AI workflow directive, not a claim of persisted call-order enforcement.",
+      description: "Mandatory planning pass for a normal new memory. First inspect the complete tag vocabulary with list-memory-tags; then this pass routes the note, returns the live template and natural vault relationships, resolves proposed tags, and shortlists interlinks. For People, Organizations, Deals, Projects, Tasks, and Communication, it also returns relationship and approval guidance: search existing records before linking, but do not invent a project or party. A Task can remain an independent Inbox todo. Use hybrid memory-search (3 focused queries, 50 fused candidates, bounded graph expansion, rerank to 30 by default) and read strong related notes before capture. This is an explicit AI workflow directive, not a claim of persisted call-order enforcement.",
       input: {
         title: import_zod37.z.string().min(1),
         content: import_zod37.z.string().min(1),
@@ -35101,7 +35146,7 @@ var init_memory_tool_schemas = __esm({
     CreateChannelSchema = {
       id: "create-channel",
       upstreamName: "createChannelTool",
-      description: "Create an Omni-Chat channel \u2014 a vault for threaded messages, reactions, and mentions instead of ordinary notes. Starts private to you; optionally invite initial members in the same call, each still gated by the normal sender-approval trust check. Requires write scope.",
+      description: "Create an Inbox channel \u2014 a vault for threaded messages, reactions, and mentions instead of ordinary notes. Starts private to you; optionally invite initial members in the same call, each still gated by the normal sender-approval trust check. Requires write scope.",
       input: {
         name: import_zod37.z.string().min(1).describe("Channel name. Must match ^[A-Za-z0-9 _-]{1,48}$."),
         inviteMembers: import_zod37.z.array(
@@ -35184,7 +35229,7 @@ var init_memory_tool_schemas = __esm({
     ListChannelMessagesSchema = {
       id: "list-channel-messages",
       upstreamName: "listChannelMessagesTool",
-      description: "Read an Omni-Chat channel: top-level messages by default, or one thread's replies when parentMessageId is given. Every message returned is marked read for you, visible to other members via readBy. Requires read access on the channel.",
+      description: "Read an Inbox channel: top-level messages by default, or one thread's replies when parentMessageId is given. Every message returned is marked read for you, visible to other members via readBy. Requires read access on the channel.",
       input: {
         vault: import_zod37.z.string().min(1).describe("The channel (vault) to read."),
         parentMessageId: import_zod37.z.string().optional().describe("If given, list this thread's replies instead of top-level channel messages.")
@@ -35219,7 +35264,7 @@ var init_memory_tool_schemas = __esm({
     MyMentionsSchema = {
       id: "my-mentions",
       upstreamName: "myMentionsTool",
-      description: "List every place you're @mentioned across all Omni-Chat channels you are CURRENTLY a member of, newest first \u2014 mentions in channels you've since left do not appear.",
+      description: "List every place you're @mentioned across all Inbox channels you are CURRENTLY a member of, newest first \u2014 mentions in channels you've since left do not appear.",
       input: {
         limit: import_zod37.z.number().int().min(1).max(100).optional().describe("Max mentions to return. Optional; default 25.")
       },
@@ -35272,7 +35317,7 @@ var init_memory_tool_schemas = __esm({
     PostMessageSchema = {
       id: "post-message",
       upstreamName: "postMessageTool",
-      description: "Post a top-level message to an Omni-Chat channel. @mentioning a member's email surfaces it in their my-mentions inbox; attachNote auto-shares one of your notes with every current channel member. Requires write access on the channel.",
+      description: "Post a top-level message to an Inbox channel. @mentioning a member's email surfaces it in their my-mentions inbox; attachNote auto-shares one of your notes with every current channel member. Requires write access on the channel.",
       input: {
         vault: import_zod37.z.string().min(1).describe("The channel (vault) to post to."),
         content: import_zod37.z.string().min(1).describe("The message text."),
@@ -35345,7 +35390,7 @@ var init_memory_tool_schemas = __esm({
     ReplyMessageSchema = {
       id: "reply-message",
       upstreamName: "replyMessageTool",
-      description: "Reply inside a top-level message's thread in an Omni-Chat channel \u2014 one level of nesting only, so always reply on the top-level parentMessageId. @mentions and attachNote behave as in post-message. Requires write access on the channel.",
+      description: "Reply inside a top-level message's thread in an Inbox channel \u2014 one level of nesting only, so always reply on the top-level parentMessageId. @mentions and attachNote behave as in post-message. Requires write access on the channel.",
       input: {
         vault: import_zod37.z.string().min(1).describe("The channel (vault) the parent message is in."),
         parentMessageId: import_zod37.z.string().min(1).describe("The top-level message to reply under (messageId from post-message or list-channel-messages)."),
@@ -35744,10 +35789,10 @@ var init_memory_tool_schemas = __esm({
     PutSchema = {
       id: "memory-put",
       upstreamName: "putTool",
-      description: "Create or deliberately edit one note at a path in a memory vault; content is persisted and indexed for search. For normal new People, Deals, Projects, Tasks, or Communications records, use prepare-memory-write then memory-capture: People must be real people or organizations, Deals need a known party, Projects need a supported kind, Tasks may be independent Inbox todos or use a verified Project link when requested, and draft emails need pending approval. For row-shaped datasets you'll filter/sort by exact value, use table-create/table-insert-rows/table-query instead. Ordinary vaults are indexed and shareable \u2014 never store real secrets there; use a secure vault (create-secure-vault) instead, which is never indexed or shareable and is encrypted at rest. Requires write scope.",
+      description: "Create or deliberately edit one note at a path in a memory vault; content is persisted and indexed for search. For normal new People, Organizations, Deals, Projects, Tasks, or Communication records, use prepare-memory-write then memory-capture: People must be real people, Organizations must be real organizations, Deals need a known party, Projects need a supported kind, Tasks can be independent Inbox todos or use a verified Project when linked, and draft emails need pending approval. For row-shaped datasets you'll filter/sort by exact value, use table-create/table-insert-rows/table-query instead. Ordinary vaults are indexed and shareable \u2014 never store real secrets there; use a secure vault (create-secure-vault) instead, which is never indexed or shareable and is encrypted at rest. Requires write scope.",
       input: {
         vault: import_zod37.z.string().optional().describe(
-          "Vault to write to. Optional; defaults to the session active vault, then the first vault the caller is entitled to. On a default-provisioned account, pick the vault whose job matches the content (see the server instructions for the full 15-vault guide) rather than defaulting blindly \u2014 e.g. a lesson learned goes in Knowledge, the raw source it came from goes in Library, a broken feature goes in Issues, a named real-world initiative goes in Projects. Do not use this low-level tool to create ordinary People, Deals, Projects, Tasks, or Communications records: first use prepare-memory-write then memory-capture so relationships and approval state are validated."
+          "Vault to write to. Optional; defaults to the session active vault, then the first vault the caller is entitled to. On a default-provisioned account, pick the vault whose job matches the content (see the server instructions for the full 16-vault guide) rather than defaulting blindly \u2014 e.g. a lesson learned goes in Knowledge, the raw source it came from goes in Library, a broken feature goes in Issues, a named real-world initiative goes in Projects. Do not use this low-level tool to create ordinary People, Organizations, Deals, Projects, Tasks, or Communication records: first use prepare-memory-write then memory-capture so relationships and approval state are validated."
         ),
         path: import_zod37.z.string().optional().describe("Vault-relative note path to create or overwrite, e.g. projects/q3-plan. Writing an existing path replaces it. Required unless shareId is given."),
         shareId: import_zod37.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."),
@@ -35944,12 +35989,12 @@ var init_memory_tool_schemas = __esm({
     CreateScheduledActionSchema = {
       id: "create-scheduled-action",
       upstreamName: "createScheduledActionTool",
-      description: "Create a Credit-metered scheduled action for an active MCP Scraper Starter plan or higher, in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs the approved read-only tools on bound service connections and ingests their data; it requires at least one connection to be bound before execution. Google Search Console syncs also upsert a typed tenant-owned performance table for exact filtering with table-query; discover its tableName by calling list_service_connections after the first successful run. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
+      description: "Create a Credit-metered scheduled action for an active MCP Scraper Starter plan or higher, in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs the approved read-only tools on bound service connections and ingests their data; it requires at least one connection to be bound before execution. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
       input: {
         description: import_zod37.z.string().min(1).describe("Free-text description of what this action should do each time it runs."),
         vault: import_zod37.z.string().min(1).describe("The vault this action writes its results into. You must already have write access to it."),
         cadence: import_zod37.z.enum(["once", "daily", "weekly", "monthly"]).describe('How often this action runs. "once" fires a single time and then completes.'),
-        executionMode: import_zod37.z.enum(["agent", "connection_sync"]).default("agent").describe(`How to execute each run. "agent" (default) lets an agent follow the description. "connection_sync" deterministically ingests data from the schedule's bound connections using only their approved read-only tools; bind at least one connection before it runs. Search Console connection_sync also maintains a typed table exposed as the connection tableName.`),
+        executionMode: import_zod37.z.enum(["agent", "connection_sync"]).default("agent").describe(`How to execute each run. "agent" (default) lets an agent follow the description. "connection_sync" deterministically ingests data from the schedule's bound connections using only their approved read-only tools; bind at least one connection before it runs.`),
         timeOfDay: import_zod37.z.string().regex(/^([01]\d|2[0-3]):([0-5]\d)$/).optional().describe("24-hour HH:MM clock time to run at, in the given timezone. Optional \u2014 omit to run at any time during the period (matches prior default behavior)."),
         timezone: import_zod37.z.string().optional().describe(`IANA timezone name, e.g. "America/Denver". Only meaningful together with timeOfDay or deployDate. Omit to use the account's default timezone (set via set-schedule-defaults), falling back to UTC.`),
         deployDate: import_zod37.z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Calendar date (YYYY-MM-DD, in the given timezone) this action should first become eligible to run \u2014 its deployment/start date. For recurring cadences, the first occurrence lands on or after this date; every later occurrence still follows the normal cadence. For cadence "once", this (combined with timeOfDay if given) is exactly what day it fires. Omit to start immediately.')
@@ -36534,9 +36579,9 @@ var init_memory_tool_schemas = __esm({
     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 15 governed Obsidian-style vaults. Call before composing a note when the correct shape is uncertain.",
+      description: "Read the machine-enforced purpose, template, statuses, types, required and recommended props, natural neighbor vaults, and typed relationship guidance for one of the 16 governed Obsidian-style vaults. Call before composing a note when the correct shape is uncertain.",
       input: {
-        vault: import_zod37.z.string().describe("One governed vault: Ideas, Inspiration, Knowledge, Library, People, Deals, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint, or Skills.")
+        vault: import_zod37.z.string().describe("One governed vault: Ideas, Examples and Inspirations, Knowledge, Library, People, Organizations, Deals, Communication, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint, or Skills. Former names Inspiration and Communications still resolve.")
       },
       output: {
         ok: import_zod37.z.boolean(),
@@ -36590,7 +36635,7 @@ var init_memory_tool_schemas = __esm({
             sharedBy: import_zod37.z.string().optional().describe('Identity that shared the vault with the caller. Present only when role is "shared".'),
             notes: import_zod37.z.number().describe("Number of notes currently stored in the vault."),
             bytes: import_zod37.z.number().describe("Total stored size of the vault content in bytes (octet_length sum)."),
-            kind: import_zod37.z.enum(["notes", "channel", "secure"]).describe('"channel" for an Omni-Chat channel (created via create-channel); "secure" for a private, encrypted, unshareable, unindexed vault (created via create-secure-vault) \u2014 safe to store credentials there; "notes" for an ordinary vault.')
+            kind: import_zod37.z.enum(["notes", "channel", "secure"]).describe('"channel" for an Inbox channel (created via create-channel); "secure" for a private, encrypted, unshareable, unindexed vault (created via create-secure-vault) \u2014 safe to store credentials there; "notes" for an ordinary vault.')
           })
         ).optional().describe("Every vault visible in the active account, with role, addressable handle, and live storage usage. Present when ok is true."),
         error: import_zod37.z.string().optional().describe("Human-readable failure reason when ok is false.")
@@ -36606,17 +36651,17 @@ var init_memory_tool_schemas = __esm({
     ProvisionDefaultsSchema = {
       id: "provision-defaults",
       upstreamName: "provisionDefaultsTool",
-      description: "Provision the standard 15-vault memory structure (Ideas, Inspiration, Knowledge, Library, People, Deals, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint, Skills) for an identity. Idempotent \u2014 existing records are untouched and existing vault contracts are refreshed. Optionally issues a fresh API key entitled to all 15. Requires admin scope.",
+      description: "Provision the standard 16-vault memory structure (Ideas, Examples and Inspirations, Knowledge, Library, People, Organizations, Deals, Communication, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint, Skills) for an identity. Idempotent \u2014 existing records are untouched and existing vault contracts are refreshed. Optionally issues a fresh API key entitled to all 16. Requires admin scope.",
       input: {
-        granteeIdentity: import_zod37.z.string().min(1).describe("Identity that should OWN the 15 default vaults (e.g. an email or user id)."),
-        issueKey: import_zod37.z.boolean().optional().describe("When true, also issue a new API key for the identity entitled to all 15 vaults and return its secret once. Default false."),
+        granteeIdentity: import_zod37.z.string().min(1).describe("Identity that should OWN the 16 default vaults (e.g. an email or user id)."),
+        issueKey: import_zod37.z.boolean().optional().describe("When true, also issue a new API key for the identity entitled to all 16 vaults and return its secret once. Default false."),
         plan: import_zod37.z.enum(["free", "pro", "team", "enterprise"]).optional().describe("Subscription plan carried by the issued key. Optional; defaults to free. Only used when issueKey is true.")
       },
       output: {
         ok: import_zod37.z.boolean().describe("True when provisioning succeeded; false on auth/scope error."),
         identity: import_zod37.z.string().optional().describe("Identity the vaults were provisioned for."),
-        created: import_zod37.z.array(import_zod37.z.string()).optional().describe("Vault names newly created on this call (empty when all 15 already existed)."),
-        vaults: import_zod37.z.array(import_zod37.z.string()).optional().describe("All 15 default vault names the identity now owns."),
+        created: import_zod37.z.array(import_zod37.z.string()).optional().describe("Vault names newly created on this call (empty when all 16 already existed)."),
+        vaults: import_zod37.z.array(import_zod37.z.string()).optional().describe("All 16 default vault names the identity now owns."),
         keyId: import_zod37.z.string().optional().describe("Stable id of the issued key. Present only when issueKey was true."),
         secret: import_zod37.z.string().optional().describe("The issued key secret \u2014 RETURNED ONCE. Present only when issueKey was true."),
         plan: import_zod37.z.string().optional().describe("Plan assigned to the issued key. Present only when issueKey was true."),
@@ -41274,6 +41319,7 @@ function normalizeRelationshipProps(vault, props) {
 }
 function defaultType(vault) {
   if (vault === "People" || vault === "Communications") return "unclassified";
+  if (vault === "Organizations") return "organization";
   if (vault === "Deals") return "deal";
   if (vault === "Projects") return "project";
   if (vault === "Tasks") return "task";
@@ -41281,7 +41327,7 @@ function defaultType(vault) {
   return "unclassified";
 }
 function defaultStatus(vault) {
-  if (vault === "People") return "active";
+  if (vault === "People" || vault === "Organizations") return "active";
   if (vault === "Deals") return "lead";
   if (vault === "Projects") return "active";
   if (vault === "Tasks") return "to_do";
@@ -41294,6 +41340,12 @@ function nonEmptyStrings(value) {
 function validateNewRecord(vault, props) {
   const type = typeof props.type === "string" ? props.type : "";
   if (vault === "People" && !["person", "organization"].includes(type)) return "People records must be a person or organization";
+  if (vault === "Organizations") {
+    if (type !== "organization") return "Organizations records must have type organization";
+    if (typeof props.organization_name !== "string" || !props.organization_name.trim()) {
+      return "Organizations require organization_name";
+    }
+  }
   if (vault === "Deals") {
     if (type !== "deal") return "Deals records must have type deal";
     if (typeof props.organization_ref !== "string" && nonEmptyStrings(props.person_refs).length === 0) {
@@ -41369,7 +41421,7 @@ var init_vault_routes = __esm({
     "use strict";
     import_hono22 = require("hono");
     init_memory();
-    VAULTS = ["People", "Deals", "Projects", "Tasks", "Communications", "Calendar"];
+    VAULTS = ["People", "Organizations", "Deals", "Projects", "Tasks", "Communications", "Calendar"];
     PROJECT_TYPES = ["codebase", "personal", "work", "client"];
     PROJECT_KIND_BY_TYPE = {
       codebase: "codebase",